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": {
"success": true,
"data": {
"certif_hash": "abc123...",
"sha256": "e3b0c44298fc...",
"issued_at": "2026-07-01T10:30:00Z",
"short_link": "a1b2c3d4",
"stamped": true,
"stamped_pdf_base64": "<le PDF scelle, a remettre a votre utilisateur>",
"proof": { "certificate": "...", "signature": "..." }
}
},
"meta": { "requestId": "..." }
}
# Lien de verification a afficher : https://deepstamp.fr/v/{short_link}
# 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": {
"certHash": "sha256:...",
"certificate": "...",
"signature": "..."
}
}Envie de tester avant d'integrer ?