Documentation développeur

Docseal API et Gateway quickstart.

Créez des records scellés, vérifiez les fichiers reçus, gérez le statut documentaire et opérez en hash-only sans envoyer le contenu du document à Docseal.

Les clés API émetteur sont fournies par pilote. Ne les exposez jamais dans du code navigateur ou un dépôt public.

Registry

Stocke les records scellés, receipts et événements.

Verify

Compare le hash du fichier reçu au record officiel.

POST /api/verify

Issuer API

Permet à un émetteur autorisé de créer un Seal ID.

POST /api/issuer/seals

Trust

Gère valid, revoked, replaced et expired.

PATCH /api/issuer/seals/[sealId]/status

Gateway Local

Calcule le hash localement côté émetteur.

node scripts/docseal-gateway-local.cjs

Créer un seal

API_KEY="<issuer_api_key>"
HASH="$(sha256sum document.pdf | awk '{print $1}')"

curl -s -X POST https://docseal.app/api/issuer/seals \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "documentHash": "'$HASH'",
    "documentTypeSlug": "bank-statement",
    "documentTypeName": "Bank statement",
    "referenceLabel": "Statement May 2026",
    "visibilityPolicy": "hash_only"
  }'

Vérifier un hash

curl -s -X POST https://docseal.app/api/verify \
  -H "Content-Type: application/json" \
  -d '{
    "sealId": "DSL-...",
    "submittedHash": "<sha256-hex>"
  }'

Gateway hash-only

node scripts/docseal-gateway-local.cjs seal document.pdf \
  --type-slug bank-statement \
  --type-name "Bank statement" \
  --label "Statement May 2026" \
  --visibility hash_only \
  --api-key-file /path/to/private-api-key