Codes d'erreur

L'API utilise des codes HTTP standards et retourne des erreurs structurées en JSON.

Format de réponse

Toutes les erreurs suivent le même format :

JSON

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Le champ 'email' est requis."
  }
}

Code	Signification	Action
400Bad Request	Vérifiez le format de votre requête.
401Unauthorized	Clé API invalide ou session expirée.
403Forbidden	Scope insuffisant pour cette action.
404Not Found	La ressource demandée n'existe pas.
409Conflict	L'email ou le nom existe déjà.
422Unprocessable Entity	Données valides mais traitement impossible.
429Too Many Requests	Limite de débit atteinte. Réessayez plus tard.
500Internal Server Error	Erreur serveur. Contactez le support.

Code	Description
`VALIDATION_ERROR`	Un ou plusieurs champs sont invalides ou manquants.
`UNAUTHORIZED`	Authentification requise ou invalide.
`FORBIDDEN`	L'action n'est pas autorisée avec les permissions actuelles.
`NOT_FOUND`	La ressource demandée n'existe pas.
`CONFLICT`	Un doublon existe déjà (email, nom, etc.).
`QUOTA_EXCEEDED`	Le quota mensuel de documents est atteint.
`RATE_LIMITED`	Trop de requêtes par seconde.
`TEMPLATE_INVALID`	Le HTML du template contient des erreurs.
`COMPLIANCE_ERROR`	Le document ne respecte pas les normes fiscales du pays.
`RENDER_FAILED`	La génération du PDF a échoué.

Rate limiting

Quand vous recevez un 429, le header Retry-After indique le nombre de secondes à attendre avant de réessayer.