Documents
Upload et récupération de fichiers PDF à faire signer.
POST /api/v1/documents
Upload d'un PDF. Le hash SHA-256 est calculé serveur-side et retourné dans la réponse.
Headers
| Header | Requis | Valeur |
|---|---|---|
X-Api-Key | ✓ | Votre clé API. |
Content-Type | ✓ | multipart/form-data. |
Body
| Champ | Type | Requis | Description |
|---|---|---|---|
file | File | ✓ | Le PDF (max 25 MB, mime application/pdf). |
Exemple
curl https://api.signlift.io/api/v1/documents \
-H "X-Api-Key: $SIGNLIFT_API_KEY" \
-F "file=@contract.pdf"Réponse 201
{
"id": "doc_01HZQK...",
"filename": "contract.pdf",
"content_type": "pdf",
"sha256_hash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
"file_size": 154823,
"status": "ready",
"created_at": "2026-05-16T15:00:00Z"
}GET /api/v1/documents/{id}
Récupère les métadonnées et, si la signature est finalisée, l'URL signée du PDF signé.
Réponse 200
{
"id": "doc_01HZQK...",
"filename": "contract.pdf",
"sha256_hash": "9f86d081...",
"status": "signed",
"signed_pdf_url": "https://s3.eu-west-1.amazonaws.com/...?X-Amz-Signature=..."
}L'URL signée S3 expire après 15 minutes.
Erreurs
| HTTP | Code | Raison |
|---|---|---|
| 404 | not_found | Document inexistant ou autre org. |
| 410 | expired | Document purgé (rétention écoulée). |