Documents

POST `/api/v1/documents`

Upload d'un PDF. Le hash SHA-256 est calculé côté serveur et retourné dans la réponse — il sert ensuite d'identité d'intégrité du document tout au long du cycle de vie de la signature.

Headers

Header	Requis	Valeur
`X-Api-Key`	✓	Votre clé API.
`Content-Type`	✓	`multipart/form-data`.

Body

Champ	Type	Requis	Description
`file`	File	✓	Le PDF (MIME `application/pdf` strictement).

Tout fichier non-PDF est rejeté avec un 422 validation_error (message localisé indiquant le type MIME invalide).

Exemple

curl https://app.signlift.eu/api/v1/documents \
  -H "X-Api-Key: $SIGNLIFT_API_KEY" \
  -F "file=@contract.pdf"

Réponse 201

{
  "id": 42,
  "content_type": "pdf",
  "sha256_hash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
  "file_size": 154823,
  "status": "ready",
  "created_at": "2026-05-17T15:00:00Z"
}

status : ready une fois le fichier accessible côté Signlift.
La réponse de création ne contient pas d'URL de téléchargement — utilisez le GET ci-dessous pour obtenir une URL S3 présignée.

GET `/api/v1/documents/{id}`

Récupère les métadonnées d'un document précédemment uploadé et une URL S3 présignée pour télécharger le PDF original.

Réponse 200

{
  "id": 42,
  "content_type": "pdf",
  "sha256_hash": "9f86d081...",
  "file_size": 154823,
  "status": "ready",
  "created_at": "2026-05-17T15:00:00Z",
  "download_url": "https://s3.eu-west-1.amazonaws.com/...?X-Amz-Signature=..."
}

download_url : URL S3 présignée pointant sur le PDF original (non signé). Valide pendant 15 minutes — rappelez l'endpoint pour en obtenir une nouvelle si nécessaire. Pour récupérer le PDF signé après complétion, voir Signature Requests — download_urls.