Sceller un document
Un cachet scelle un PDF au nom de votre organisation, sans geste humain : une attestation, un
reçu, une facture. Le document rendu est un PDF au format PAdES, horodaté, qu’un lecteur PDF
montre intègre. Il faut une clé qui porte la portée seal et des requêtes
signées.
1. Choisir un profil de cachet
Section intitulée « 1. Choisir un profil de cachet »GET /v1/seal-profiles{ "data": [ {"id": "seal_01J9ZK7B2M4Q8R6T0V3W5X7Y9Z", "label": "Agence Immo SA", "level": "simple", "owner": "organisation", "not_after": "2028-11-01T00:00:00+00:00", "revoked": false}, {"id": "seal_01J9ZK8C3N5R9S7U1W4X6Y8Z0A", "label": "Tano", "level": "simple", "owner": "tano", "not_after": "2028-06-01T00:00:00+00:00", "revoked": false} ]}Les profils de votre organisation viennent en premier. Celui de Tano (owner : tano) scelle
pour le compte de votre organisation : utilisez-le si votre organisation n’a pas encore son
propre profil. not_after est la date d’expiration du certificat ; un profil expiré ou révoqué ne
scelle plus.
2. Sceller
Section intitulée « 2. Sceller »POST /v1/sealsIdempotency-Key: 3d8a…X-Tano-Timestamp: …X-Tano-Signature: v2=…
{"profile_id": "seal_01J9ZK7B2M4Q8R6T0V3W5X7Y9Z", "document": "JVBERi0xLjcK…", "reference": "ATT-2026-0412"}| Champ | Obligatoire | Description |
|---|---|---|
profile_id |
oui | Le profil de cachet. |
document |
oui | Le PDF en base 64, 20 Mo au plus. |
reference |
non | Votre référence, 120 caractères au plus. Reprise dans les webhooks. |
Le scellement est synchrone : la réponse 201 porte le cachet posé.
{ "id": "sl_01J9ZK9D4P6S0T8V2X5Y7Z9A1B", "status": "sealed", "profile_id": "seal_01J9ZK7B2M4Q8R6T0V3W5X7Y9Z", "on_behalf": false, "reference": "ATT-2026-0412", "sealed_sha256": "4b1e…", "failure": null, "created_at": "2026-11-13T09:00:00+00:00", "sealed_at": "2026-11-13T09:00:01+00:00", "environment": "prod"}on_behalf vaut true quand le cachet a été posé avec le profil de Tano, pour le compte de votre
organisation. sealed_sha256 est l’empreinte du PDF scellé.
Rejouer l’appel avec la même clé d’idempotence rend la même réponse, sans sceller deux fois. Un
appel en erreur n’est pas conservé : après un seal_unavailable,
réessayez avec la même clé.
3. Télécharger le document scellé
Section intitulée « 3. Télécharger le document scellé »GET /v1/seals/{seal_id}/downloadLa réponse est le PDF, avec X-Tano-Document-Sha256 (son empreinte, égale à sealed_sha256) et,
pour un cachet de bac à sable, X-Tano-Sandbox: true. GET /v1/seals/{seal_id} relit l’état du
cachet.
Webhooks
Section intitulée « Webhooks »Deux événements, sur l’objet seal :
| Événement | data |
|---|---|
seal.completed |
profile_id, reference |
seal.failed |
failure (le code de l’échec), reference |
Le scellement étant synchrone, la réponse de POST /v1/seals vous suffit ; les webhooks servent
aux systèmes qui suivent les cachets sans les avoir demandés.
En bac à sable
Section intitulée « En bac à sable »POST /v1/seals avec une clé de bac à sable rend un cachet sealed, "environment": "sandbox",
dont le document porte le bandeau « SPÉCIMEN » sans être scellé. Ni facturation, ni quota.
Erreurs fréquentes
Section intitulée « Erreurs fréquentes »| Code | Cause |
|---|---|
seal_profile_not_found |
Le profil n’existe pas, ou n’est pas le vôtre. |
seal_profile_revoked |
Le profil est révoqué ou son certificat a expiré. |
document_not_flattenable |
Le PDF est illisible ou chiffré. |
document_too_large |
Le PDF dépasse 20 Mo. |
invalid_base64 |
document n’est pas du base 64. |
quota_exceeded |
Le volume de cachets prévu par votre contrat est épuisé. |
seal_unavailable |
Le scellement n’a pas pu se faire de notre côté. |
seal_not_found |
Identifiant inconnu, ou cachet d’un autre environnement. |
seal_not_ready |
Téléchargement d’un cachet qui n’est pas posé. |
Étapes suivantes
Section intitulée « Étapes suivantes »- Vérifier un document scellé ou signé.
- La référence du cachet : routes, champs et réponses.
© 2026 Qalebasse · Tano, plateforme de confiance numériquetano.africaDemander un accès[email protected]