Erreurs - Lekalao

Une erreur répond toujours en JSON avec au moins un message lisible. Les messages sont dans la langue par défaut de l’installation : fiez-vous au code HTTP et aux noms de champs, pas au texte.

Les codes

Code	Signifie	Que faire
`200` `201`	Réussi, ou créé.
`202`	Accepté et mis en file : le travail se fait en arrière-plan (import, gros lot).	Suivez l’`url` renvoyée.
`204`	Supprimé. Pas de corps.
`400`	Requête mal formée (clé d’idempotence trop longue…).	Corrigez l’appel.
`401`	Pas de jeton, ou jeton révoqué.	Vérifiez l’en-tête `Authorization`.
`403`	Aptitude, rôle ou équipe insuffisants, ou équipe suspendue.	Lisez `message`.
`404`	Ressource introuvable dans cette équipe.	Vérifiez l’`id`.
`409`	Conflit : campagne en cours d’envoi, personne déjà dans l’automatisation, appel idempotent encore en cours.	Lisez `message`, ne renvoyez pas tel quel.
`422`	Données refusées.	Lisez `errors` ou `message`.
`429`	Trop d’appels.	Attendez `Retry-After` secondes.
`502`	E-mail transactionnel refusé par le fournisseur d’envoi.	Le détail est dans `failure_reason`.
`5xx`	Problème de Lekalao.	Réessayez plus tard, avec la même `Idempotency-Key`.

Erreurs de validation

422 avec le détail par champ :

{
    "message": "Le champ email doit être une adresse e-mail valide.",
    "errors": {
        "email": ["Le champ email doit être une adresse e-mail valide."],
        "tags.2": ["Le champ tags.2 ne doit pas dépasser 255 caractères."]
    }
}

Les champs de tableaux sont désignés par leur position : subscribers.14.email est la 15ᵉ ligne d’un lot.

Refus métier

Certains 422 n’ont qu’un message, parce que la donnée est valide mais l’opération impossible :

Message	Situation
« This address is blocked. »	L’adresse est dans la liste de suppression.
« Your plan holds 3 subscribers. Move up a plan to add more. »	Limite d’abonnés de la formule atteinte.
« This campaign cannot be sent yet. »	La campagne n’est pas prête ; la liste des raisons est dans `problems`.
Adresse d’expédition refusée	L’expéditeur n’est pas sur un domaine autorisé. Le message dit lequel.

{
    "message": "This campaign cannot be sent yet.",
    "problems": [
        "Add a visible unsubscribe link to the content, with {{ unsubscribe_url }}.",
        "Set the postal address of your organisation in the general settings."
    ]
}

Réessayer ou non

Réessayez sur 429, 5xx et les erreurs réseau, avec un délai croissant et la même Idempotency-Key.
Ne réessayez pas sur 4xx : le même appel donnera la même réponse. Corrigez d’abord.