Signature électronique
Portée de clé signature. Voir Faire signer un document.
| Méthode | Chemin | Rôle |
|---|---|---|
POST |
/v1/signature-requests |
Créer une demande, et l’envoyer d’un geste avec "activate": true. Signé. |
GET |
/v1/signature-requests |
Lister les demandes : status, reference, limit. |
GET |
/v1/signature-requests/{id} |
Lire une demande : son état, ses documents, ses signataires. |
POST |
/v1/signature-requests/{id}/activate |
Envoyer un brouillon. Signé. |
POST |
/v1/signature-requests/{id}/cancel |
Annuler une demande en cours : {"reason": "…"}. Signé. |
DELETE |
/v1/signature-requests/{id} |
Supprimer un brouillon. Signé. |
PATCH |
/v1/signature-requests/{id} |
Métadonnées (fusionnées) ; report de l’échéance d’une demande en cours. Signé. |
POST |
/v1/signature-requests/{id}/reactivate |
Faire repartir une demande expirée : {"expires_in_days": 30}. Signé. |
PATCH |
/v1/signature-requests/{id}/signers/{signer_id} |
Corriger un signataire qui n’a pas répondu ; invité, il reçoit un nouveau lien. Signé. |
POST |
/v1/signature-requests/{id}/signers/{signer_id}/remind |
Relancer à la main un signataire invité : un nouveau lien, le texte de relance. Une fois par heure au plus. Signé. |
POST |
/v1/signature-requests/{id}/signers/{signer_id}/link |
Un nouveau lien de signature pour un signataire invité ; l’ancien cesse de valoir. Signé. |
GET |
/v1/signature-requests/{id}/documents/{document_id}/download |
Le document signé, ou le document présenté avant la complétion. |
GET |
/v1/signature-requests/{id}/audit-trail |
Le fichier de preuve, une fois la demande complétée. |
POST |
/v1/signature-templates |
Créer un modèle : documents, rôles, champs, réglages. Signé. |
GET |
/v1/signature-templates |
Lister les modèles : nom, nombre de documents et de rôles. |
GET |
/v1/signature-templates/{id} |
Lire un modèle : le même corps qu’à sa création. |
DELETE |
/v1/signature-templates/{id} |
Supprimer un modèle ; les demandes déjà créées gardent leurs documents. Signé. |
GET |
/v1/signature-templates/{id}/documents/{document_id} |
Le PDF d’un document du modèle. |
POST |
/v1/sandbox/signature-requests/{id}/signers/{signer_id}/sign |
Bac à sable : faire signer un signataire invité. Signé. |
POST |
/v1/sandbox/signature-requests/{id}/signers/{signer_id}/decline |
Bac à sable : le faire refuser. Signé. |
La demande et chaque signataire acceptent delivery, custom_text et redirect_urls (voir Le parcours du signataire) ; la réponse rend signers[].delivery et signers[].reminded_at. Les champs se placent par coordonnées ou par ancres dans le PDF ; la réponse les rend dans signers[].fields. Le corps de création, champ par champ, est dans le
guide. Le nom d’un
signataire n’est rendu qu’à une clé qui porte la permission personal_data ; ses coordonnées le
sont toujours masquées.
Avec template_id, la demande part d’un modèle : elle ne
donne plus que les personnes, une par rôle, et la réponse porte template_id. Chaque signataire
accepte hidden_documents, les rangs des documents qu’il ne voit pas ; la réponse les rend par
identifiant (sd_…). Voir Cacher un document.
Une place de signers[] peut être un groupe : group_name
(de 1 à 60 caractères) et members (deux au moins, chacun avec given_name, family_name,
email ou phone, et auth_method), à la place de given_name, family_name, email,
phone et auth_method. role, position, fields, hidden_documents, delivery,
custom_text et redirect_urls restent sur la place ; les champs sont copiés pour chaque membre.
Une copie (viewer) n’a pas de groupe, et chaque membre compte dans la limite de signataires.
Depuis un modèle, une personne se remplace par un groupe de la même façon.
{ "group_name": "Direction", "members": [ {"given_name": "Aya", "family_name": "Koné", "email": "[email protected]", "auth_method": "otp_email"}, {"given_name": "Awa", "family_name": "Traoré", "phone": "+2250707080910", "auth_method": "otp_sms"} ], "role": "signer", "position": 1, "fields": [{"document": 0, "kind": "signature", "page": 1, "x": 60, "y": 80, "width": 180, "height": 50}]}Dans la réponse, chaque membre est une entrée de signers[], avec son id, son status et son
contact, et group: {"id": "sgrp_…", "name": "Direction"} ; group vaut null pour un
signataire seul. Le premier membre qui signe tient la place : il passe en signed, les autres en
released, leurs liens cessent de valoir et signer.released part pour chacun. Les routes d’un
signataire (remind, link, PATCH) visent un membre à la fois.
Les téléchargements rendent un PDF et portent X-Tano-Document-Sha256 (l’empreinte du fichier),
X-Tano-Document-Signed (document seulement) et, en bac à sable, X-Tano-Sandbox: true.
Voir aussi
Section intitulée « Voir aussi »© 2026 Qalebasse · Tano, plateforme de confiance numériquetano.africaDemander un accès[email protected]