Gestion des erreurs

Format d'erreur

Chaque erreur a la même forme JSON:

{
    "error": {
        "code": "not_found",
        "message": "Resource not found."
    },
    "request_id": "9fd120d8-f54e-4413-bc52-a860800ff222"
}

Erreurs de validation ajouter un objet fields avec des messages par champ :

{
    "error": {
        "code": "validation_failed",
        "message": "Validation failed.",
        "fields": {
            "currency": ["The selected currency is invalid."],
            "due_date": ["The due date field is required."]
        }
    },
    "request_id": "89a24d53-684a-4e1d-b0ee-2f6a5a7cd2c2"
}

Les réponses aux erreurs ne comprennent jamais les traces de pile, les secrets ou les données d'autres entreprises.

Codes d'état

Demander des identifiants

Chaque réponse porte un en-tête X-Request-Id. Les réponses d'erreur et les réponses de lecture l'incluent également comme request_id dans le corps. Inclure lorsque vous contactez le support afin que la demande puisse être retracée.

Réessayer en toute sécurité

• Réessayer les erreurs 429, 500 et réseau avec backoff.
• Pour écrire, reessayez avec le corps same Idempotency-Key et le corps same; vous obtiendrez le résultat original au lieu d'un duplicata.
• Ne pas réessayer la validation 4xx ou les erreurs de conflit inchangés — corrigez la requête en premier.