API reference
Codes d'erreur
Référence complète des codes HTTP, messages d'erreur et limites de débit de l'API.
Format des réponses d'erreur
// Erreur simple
{ "message": "Description de l'erreur." }
// Erreur de quota (402)
{
"success": false,
"message": "Vous avez atteint votre quota d'enveloppes pour ce mois (15).",
"error_code": "envelopes_limit_reached",
"meta": { "limit": 15, "used": 15, "remaining": 0 }
}
// Erreurs de validation (422)
{
"message": "The given data was invalid.",
"errors": {
"email": ["The email field is required."],
"folder.name": ["The folder.name may not be greater than 255 characters."]
}
}Codes HTTP
| Code | Nom | Description |
|---|---|---|
200 | OK | Requête traitée avec succès |
201 | Created | Ressource créée (compte, enveloppe) |
401 | Unauthorized | Token manquant, invalide, expiré ou clé révoquée |
402 | Payment Required | Quota d'enveloppes épuisé (error_code: envelopes_limit_reached) |
403 | Forbidden | Ressource non possédée ou rôle DEVELOPER absent |
404 | Not Found | Ressource introuvable |
409 | Conflict | Conflit d'état (enveloppe terminée, signataire déjà traité…) |
422 | Unprocessable Entity | Données invalides champ errors détaillé |
429 | Too Many Requests | Limite de débit dépassée |
500 | Internal Server Error | Erreur serveur interne |
Limites de débit
| Endpoint | Limite |
|---|---|
POST /register/developer/init | 5 req / min |
POST /register/developer/verify | 10 req / min |
POST /register/developer/resend-otp | 5 req / min |