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