Démarrage rapide

1. Récupérez une clé API sandbox

Connectez-vous à votre dashboard Signlift, allez dans Paramètres → Clés API et copiez votre clé sk_sandbox_*. Les clés sandbox sont gratuites et illimitées.

2. Uploadez un document PDF

curl https://api-sandbox.signlift.io/api/v1/documents \
  -H "X-Api-Key: sk_sandbox_YOUR_KEY" \
  -F "file=@contract.pdf"

Réponse :

{
  "id": "doc_01HZQK...",
  "filename": "contract.pdf",
  "sha256_hash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
  "created_at": "2026-05-16T15:00:00Z"
}

3. Créez une signature request

curl https://api-sandbox.signlift.io/api/v1/signature_requests \
  -H "X-Api-Key: sk_sandbox_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "sequential",
    "validity_days": 30,
    "signers": [
      { "first_name": "Jeanne", "last_name": "Dupont", "email": "jeanne@example.com" }
    ],
    "documents": [{ "document_id": "doc_01HZQK..." }],
    "webhook_url": "https://yourapp.com/webhooks/signlift"
  }'

Réponse :

{
  "id": "sr_01HZQM...",
  "status": "pending",
  "signers": [
    { "id": "sgn_...", "email": "jeanne@example.com", "sign_url": "https://app.signlift.io/sign/eyJ..." }
  ]
}

Le signataire reçoit un email avec le sign_url. Vous pouvez aussi l'intégrer en iframe (voir le guide d'intégration iframe).

4. Recevez le webhook de complétion

Une fois la signature finalisée, Signlift POSTe sur votre webhook_url :

{
  "event": "signature_request.completed",
  "data": {
    "signature_request_id": "sr_01HZQM...",
    "signed_at": "2026-05-16T15:12:43Z",
    "documents": [
      { "id": "doc_01HZQK...", "signed_pdf_url": "https://..." }
    ]
  }
}

Vérifiez la signature HMAC X-Signlift-Signature (voir guide webhooks).