Démarrer
Erreurs
Une seule forme d'erreur, des codes stables.
Toute erreur a la même forme :
{
"error": "INVALID_PAYLOAD",
"message": "postal_code must be a 5-digit French postal code"
}error est un code stable, fait pour être testé par votre code. message explique le problème à la personne qui débogue : il peut changer, ne le testez pas. Nous ajoutons des codes, nous n'en renommons jamais.
Les codes
| HTTP | error | Cas | Conduite à tenir |
|---|---|---|---|
| 400 | INVALID_PAYLOAD | Champ mal formé, manquant ou inconnu. Le message nomme le champ. | Corriger la requête, ne pas la rejouer telle quelle |
| 403 | UNAUTHORIZED | Clé absente, inconnue, révoquée, ou sans le droit d'appeler cette route | Vérifier la clé, nous contacter |
| 403 | ORGANIZATION_NOT_ALLOWED | Entreprise non rattachée à votre compte | Vérifier organization_id, nous contacter |
| 404 | CONSTRUCTION_NOT_FOUND | Demande inconnue | Vérifier l'identifiant |
| 404 | LEAD_NOT_FOUND | Aucun lead de cette référence envoyé avec votre clé | Vérifier la référence |
| 409 | CONSTRUCTION_CLOSED | Demande annulée, clôturée ou archivée | L'abandonner |
| 409 | CONSTRUCTION_FULL | Plus aucune place sur la demande | L'abandonner |
| 409 | ACCESS_DELAY_PENDING | L'entreprise ne peut pas encore se positionner | Réessayer après accessible_at |
| 409 | POSITIONING_REFUSED | Autre refus, expliqué dans message (Krédits insuffisants par exemple) | Afficher le message, nous contacter |
| 400, 409, 413, 415 | FILE_REQUIRED, ATTACHMENT_LIMIT_REACHED, FILE_TOO_LARGE, UNSUPPORTED_FILE_TYPE | Fichier joint refusé, voir Joindre des fichiers | Corriger le fichier |
| 5xx | INTERNAL | Incident de notre côté | Réessayer avec un recul progressif, nous prévenir si cela dure |
ACCESS_DELAY_PENDING est la seule erreur qui porte un champ de plus, accessible_at :
{
"error": "ACCESS_DELAY_PENDING",
"message": "This organization cannot position itself yet",
"accessible_at": "2026-10-19T09:06:27.304Z"
}Un refus n'est pas une erreur
Quand nous ne voulons pas d'un lead, le ping répond 200 avec accepted: false et un motif. Voir Proposer un lead.