Codes d'erreur
Chaque erreur a un code, un statut HTTP et un message lisible. Consultez la guide des erreurs.
| Code | État | Signification |
|---|---|---|
invalid_request | 422 | Un paramètre manque ou n'est pas valide. error.details donne chaque problème, avec son chemin et un message. |
version_invalid | 400 | L'en-tête Esora-Version ne correspond pas à une version publiée de l'API. |
idempotency_key_required | 400 | Ce point de terminaison exige un en-tête Idempotency-Key, de 8 à 200 caractères. |
invalid_cursor | 400 | starting_after n'est pas un identifiant de cette liste. |
unauthenticated | 401 | Aucune clé d'API n'a été envoyée, ou la clé n'est pas valide ou a été révoquée. |
not_found | 404 | Aucun objet de ce type dans cet espace de travail, ou le chemin ne fait pas partie de l'API. |
not_draft | 409 | Le document a été envoyé : il ne peut plus être modifié de cette façon. |
cannot_void | 409 | Seuls les documents en cours de signature peuvent être annulés. Les dossiers terminés, non. |
not_sent | 409 | L'action exige un document en cours de signature (rappels, sessions de signature). |
not_waiting | 409 | Cette personne n'attend pas de signer en ce moment : on ne peut pas lui envoyer de rappel. |
not_completed | 409 | La copie signée est encore en préparation. Attendez document.completed. |
already_acted | 409 | Le destinataire a déjà signé ou refusé. |
already_exists | 409 | Un contact avec ce courriel, ou un classeur avec ce nom, existe déjà. |
purged | 409 | Les fichiers du dossier ont été supprimés selon la politique de conservation. |
idempotency_key_reused | 409 | Cette Idempotency-Key a déjà servi avec un corps de requête différent. |
request_in_progress | 409 | Une requête avec cette Idempotency-Key est encore en cours. Réessayez dans un instant. |
purged | 410 | Téléchargements : le fichier a été supprimé selon la politique de conservation. Le dossier de preuves est conservé. |
file_too_large | 413 | Un fichier dépasse 50 Mo. |
file_required | 422 | Téléversez un fichier, passez file_url, ou utilisez template_id. |
file_url_invalid | 422 | file_url doit être une adresse HTTPS publique. |
file_url_unreachable | 422 | Nous n'avons pas pu télécharger le fichier à file_url en moins de 30 secondes. |
file_infected | 422 | Le fichier contient un logiciel malveillant et a été refusé. |
too_many_documents | 422 | Un document peut contenir jusqu'à 20 fichiers. |
duplicate_recipient | 422 | Chaque adresse courriel ne peut être ajoutée qu'une fois à un document. |
invalid_field | 422 | Un champ est sur une page qui n'existe pas, dépasse le bord de la page, ou est attribué à quelqu'un qui n'est pas signataire. |
unknown_role | 422 | template_role n'est pas un rôle de ce modèle. |
not_ready | 422 | Le document ne peut pas encore être envoyé. error.details indique ce qui manque, par exemple un signataire sans champ de signature. |
send_at_past | 422 | send_at est dans le passé. |
url_invalid | 422 | L'URL du webhook doit être une adresse HTTPS publique. |
rate_limited | 429 | Trop de requêtes. Attendez le nombre de secondes indiqué dans l'en-tête Retry-After. |
reminder_too_soon | 429 | Un rappel ou une invitation a été envoyé à cette personne il y a moins d'une heure. |
internal | 500 | Un problème est survenu de notre côté. error.details.requestId nous aide à le retrouver. Vous pouvez réessayer sans risque avec la même Idempotency-Key. |
scan_unavailable | 503 | L'analyse antivirus est brièvement indisponible : les téléversements sont suspendus. Réessayez dans quelques minutes. |