Référence

Codes d'erreur

Comment les erreurs d'API et les réponses SMTP sont signalées, et que faire pour chaque cas.

Format des erreurs d'API

Les erreurs d'API sont au format JSON, avec un code stable et un message. Appuyez votre logique sur le code, et n'affichez le message qu'aux personnes, car sa formulation peut changer.

{
  "error": { "code": "invalid_recipient", "message": "The recipient address is not valid." }
}

Réessayer ou corriger ?

Les erreurs se répartissent en deux groupes. Corriger la requête : les réponses 4xx autres que 429 signalent un problème dans ce que vous avez envoyé ; réessayer échouera donc de la même façon. Réessayer plus tard : les réponses 429 et 5xx sont temporaires, réessayez donc avec un backoff exponentiel et un nombre de tentatives limité.

Réponses SMTP

Les réponses SMTP commencent par un code à trois chiffres. 2xx signifie succès. 4xx signifie un échec temporaire : l'expéditeur doit réessayer plus tard. 5xx signifie un échec permanent : ne renvoyez pas le même message à cette adresse. De nombreuses réponses ajoutent un code étendu comme 5.1.1 qui explique la cause.

Lire les motifs de rebond

Les codes étendus sont le moyen le plus rapide de comprendre un rebond. 5.1.1 signifie que la boîte aux lettres n'existe pas. 5.2.2 signifie qu'elle est pleine. 5.7.1 signifie que le serveur destinataire a rejeté le message pour des raisons de politique, souvent à cause de l'authentification ou de la réputation. Les codes 4.x.x sont temporaires et seront réessayés.

Que faire des rebonds

Retirez de votre liste les adresses en rebond dur, et analysez les rejets de politique en vérifiant votre configuration SPF, DKIM et DMARC. Un taux de rebond en hausse nuit à votre réputation : réagissez vite.

Statut et codeSignification

400 invalid_requestUn champ obligatoire est manquant ou mal formé.

401 unauthorizedLa clé API est absente ou invalide.

403 forbiddenLa clé n'a pas la permission pour cette action.

404 not_foundLa ressource n'existe pas.

422 invalid_recipientL'adresse du destinataire a échoué à la validation.

429 rate_limitedTrop de requêtes. Ralentissez et réessayez.

500 server_errorUn problème est survenu de notre côté. Réessayez.

SMTP 4xxÉchec temporaire. Le message sera réessayé.

SMTP 5xxÉchec permanent. Ne réessayez pas vers la même adresse.

Cette page vous a-t-elle été utile ?Contacter le support