§ Développeurs
Intégrez la signature, le cachet et l’horodatage en quelques lignes de code.
Une API REST au comportement prévisible, une documentation complète et des exemples dans les principaux langages.
§ 01 — Démarrage rapide
Votre premier document scellé en trois étapes.
01
Obtenez votre clé API
Créez un compte, puis générez une clé depuis votre espace. Conservez-la côté serveur, dans une variable d’environnement : elle ne doit jamais apparaître dans le code exécuté par le navigateur.
export DOCACERT_API_KEY="votre-clé-de-test"
02
Envoyez votre premier document
Transmettez le fichier et les options souhaitées. La réponse contient l’identifiant de l’opération et l’état du document.
cURL
curl https://api.docacert.com/v1/seals \
-H "Authorization: Bearer $DOCACERT_API_KEY" \
-F "file=@facture-2026-0418.pdf" \
-F "timestamp=true"Node.js
import { openAsBlob } from "node:fs";
const form = new FormData();
form.append("file", await openAsBlob("facture-2026-0418.pdf"), "facture-2026-0418.pdf");
form.append("timestamp", "true");
const res = await fetch("https://api.docacert.com/v1/seals", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.DOCACERT_API_KEY}` },
body: form,
});
const seal = await res.json();Python
import os
import requests
with open("facture-2026-0418.pdf", "rb") as f:
res = requests.post(
"https://api.docacert.com/v1/seals",
headers={"Authorization": f"Bearer {os.environ['DOCACERT_API_KEY']}"},
files={"file": f},
data={"timestamp": "true"},
)
seal = res.json()C#
using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
"Bearer", Environment.GetEnvironmentVariable("DOCACERT_API_KEY"));
using var form = new MultipartFormDataContent
{
{ new StreamContent(File.OpenRead("facture-2026-0418.pdf")), "file", "facture-2026-0418.pdf" },
{ new StringContent("true"), "timestamp" }
};
var res = await http.PostAsync("https://api.docacert.com/v1/seals", form);
var seal = await res.Content.ReadFromJsonAsync<Seal>();Réponse · 201
{
"id": "seal_8f2c41d0e7",
"status": "sealed",
"format": "PAdES-B-LT",
"timestamp": "2026-10-13T09:41:27Z",
"sha256": "9b1f04…a2c07e"
}03
Suivez le résultat
Téléchargez le document certifié, ou abonnez-vous aux webhooks pour être notifié de chaque étape. Vérifiez toujours la signature des notifications reçues.
{
"type": "seal.completed",
"created_at": "2026-10-13T09:41:29Z",
"data": {
"id": "seal_8f2c41d0e7",
"status": "sealed"
}
}
§ 02 — Principes de l’API
Des conventions que vous connaissez déjà.
REST et JSON
Des ressources clairement nommées, des verbes HTTP standard et des réponses JSON.
Spécification OpenAPI
Générez votre client ou importez l’API dans vos outils à partir de la spécification publique.
Environnement de test
Développez et testez avec une clé dédiée, isolée de la production.
Webhooks signés
Chaque notification est signée : vérifiez son authenticité avant de la traiter.
Erreurs explicites
Des codes HTTP cohérents et des messages d’erreur détaillés pour corriger rapidement.
Journal d’audit
Chaque opération est tracée et exportable, pour vos contrôles internes comme pour vos auditeurs.
§ 03 — Ressources
Tout pour réussir votre intégration.
Documentation
Guides, concepts et bonnes pratiques, du premier appel à la mise en production.
Référence de l’API
Chaque point d’accès, ses paramètres et ses réponses, avec des exemples.
Support technique
Une question sur votre intégration ? Écrivez à notre équipe technique.
§ Démarrer
Prêt à envoyer votre premier document ?
Obtenez votre clé API et faites vos premiers appels dans l’environnement de test.