Documentation API
Tout ce dont vous avez besoin pour intégrer Deepstamp dans vos applications.
Authentification
Ajoutez votre clé API dans le header x-api-key de chaque requête :
x-api-key: dsk_YOUR_KEYGénérez votre clé API dans le dashboard > API Keys.
POST
/api/v1/certifyAuth requiseCertifie un fichier. Envoie le fichier en multipart/form-data, recoit le PDF scelle (base64) et le lien de verification. Recommande : header Idempotency-Key, la meme cle rejoue la reponse d'origine pendant 24 h au lieu de recertifier (retry sans doublon).
Body
# Header recommande Idempotency-Key: <id unique de votre document, ex. facture-2026-042> # multipart/form-data file: <votre fichier> # requis certificationName: Facture F-2026-042 # requis (max 200 caracteres) actorId: user_456 # optionnel : id du compte dans votre logiciel actorDisplay: Plomberie Dupont # optionnel : nom affiche "Scelle par" actorProvider: VotreLogiciel # optionnel : nom de votre logiciel
Response
{
"success": true,
"data": {
"certif_hash": "abc123...",
"sha256": "e3b0c44298fc...",
"issued_at": "2026-07-01T10:30:00Z",
"issuer": { "issuer_id": "org_...", "issuer_display": "Votre societe", "issuer_verified": true },
"actor": { "actor_id": "user_456", "display": "Plomberie Dupont", "provider": "VotreLogiciel" },
"short_link": "a1b2c3d4",
"stamped": true,
"stamped_pdf_base64": "<le PDF scelle, a remettre a votre utilisateur>",
"proof": { "sig_alg": "Ed25519", "public_key_id": "...", "signature": "...", "certificate": "..." }
},
"meta": { "requestId": "...", "backendTraceId": "..." }
}
# Lien de verification a afficher : https://deepstamp.fr/v/{short_link}
# stamped = false : lire stamp_skipped_reason (not_a_pdf, short_link_create_failed, visual_stamp_failed)
# Rejeu idempotent : meta.idempotentReplay = truePOST
/api/v1/certify-hashAuth requiseCertifie un identifiant de fichier sans envoyer le fichier. Ideal pour les fichiers volumineux ou sensibles.
Body
{
"sha256": "e3b0c44298fc...",
"certificationName": "facture-2025.pdf"
}Response
{
"success": true,
"data": {
"proof": {
"cert_hash": "sha256:...",
"sha256": "e3b0c44298fc...",
"timestamp": "2026-07-01T10:30:00Z",
"verify_url": "https://deepstamp.fr/v/sha256:..."
}
},
"meta": { "requestId": "..." }
}Envie de tester avant d'integrer ?