Recevoir des e-mails : Envoi et confiance

Définir la confiance

Marquez un expéditeur comme fiable ou non fiable, ou revenez à la valeur par défaut.

POSThttps://g.sendcorex.com/v1command: set_trust
i

default supprime la décision. Déplacer un message vers Spam marque aussi son expéditeur comme untrusted.

Arguments

  • idstringfacultatif

    Un id de message. L'expéditeur externe de sa conversation est utilisé.

  • from_emailstringfacultatif

    Une adresse e-mail d'expéditeur. Utilisez-la ou id.

  • valuestringobligatoire

    default, trusted ou untrusted.

Démarrage rapide

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "set_trust",
        args: {
          from_email: "client@example.com",
          value: "trusted"
        }
      }
    ]
  },
  { headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);

const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);

Réponse

{
  "type": "SUCCESS",
  "results": [
    {
      "command": "set_trust",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "from_email": "client@example.com",
        "trust_status": "trusted",
        "is_trusted": true
      }
    }
  ]
}

Champs de la réponse

  • from_email

    L'expéditeur mis à jour.

  • trust_status

    Le nouveau statut.

  • is_trusted

    true uniquement quand le statut vaut trusted.

Erreurs

Les erreurs au niveau HTTP renvoient type, code et message. Les erreurs marquées CMD reviennent dans le résultat de la commande, avec HTTP 200.

  • 401TOKEN_EXPIRED

    L'access token a expiré. Appelez Refresh Token et relancez la requête.

  • 401INVALID_TOKEN

    Le token est mal formé, inconnu ou révoqué.

  • 429RATE_LIMITED

    Plus de 15 requêtes/s ou 15 en cours pour la même IP + boîte aux lettres. Attendez le nombre de secondes indiqué dans Retry-After.

  • CMDINVALID_ARGS

    Un argument obligatoire est manquant ou invalide.

  • CMDNOT_FOUND

    Le message, la conversation ou le dossier n'existe pas pour ce token.

  • CMDINTERNAL

    Erreur serveur. Le détail est uniquement écrit dans le log du serveur.