Déclencher la signature électronique d'un mandat

POST 
/api/v1/mandates/:id/trigger_signature

Envoie le mandat au prestataire de signature pour signature électronique. Définit le signature_status du mandat à pending (ne modifie pas l'état du mandat).

Request

Responses

200

Le mandat a été envoyé au prestataire de signature pour signature électronique ; signature_status vaut désormais pending. L'état propre du mandat est inchangé.

401

Jeton d'accès (bearer token) OAuth 2.0 manquant, invalide ou expiré.

403

Le jeton d'accès OAuth n'inclut pas le scope requis pour cette opération.

404

Aucun mandat n'existe avec cet ID, ou il appartient à un tenant auquel l'application OAuth authentifiée n'a pas accès.

422

La signature n'a pas pu être déclenchée : le mandat n'est pas à l'état incomplete, il est déjà signé (retirez d'abord le document signé), signer_email est manquant (et aucun n'est défini sur le mandat), ou la requête au prestataire de signature elle-même a échoué.

429

rate_limited : une limite de déclenchement de signature est atteinte. Aucun document n'a été généré et le prestataire de signature n'a pas été sollicité. Les limites : par mandat, 3 requêtes par heure ; par espace de travail, 5 requêtes par minute et 60 requêtes par heure ; par application OAuth, tous espaces de travail confondus, 5 requêtes par minute et 60 requêtes par heure ; par espace de travail et adresse e-mail du signataire (casse et tout suffixe +tag ignorés), 20 requêtes par jour. Un appel refusé ne compte que dans les limites qu'il a dépassées. Retry-After est un majorant : chaque fenêtre s'ouvre au premier appel qu'elle compte et peut donc se refermer plus tôt.

Response Headers

Retry-After

Seconds to wait before retrying: the longest period among the limits the call exceeded. An upper bound, since that window opened at the first call it counted.