Aller au contenu

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.

© 2026 Qalebasse · Tano, plateforme de confiance numériquetano.africaDemander un accès[email protected]