Aller au contenu

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.

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.

POST /v1/seals
Idempotency-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é.

GET /v1/seals/{seal_id}/download

La 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.

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.

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.

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é.

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