Sign API

En 3 etapes

1. Creez un compte gratuitInscrivez-vous sur dev.layerone.fr.
2. Recuperez votre cle APIDans la console, cliquez "Nouvelle cle" et choisissez Sign.
3. Envoyez votre premier documentCopiez la commande ci-dessous avec votre cle et un PDF encode en base64.

Copier# Encoder votre PDF en base64
PDF_B64=$(base64 -i mon_document.pdf)

# Envoyer pour signature
curl -X POST https://sign.layerone.fr/v1/documents/send \
  -H "X-API-Key: VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d "{
    \"pdf_base64\": \"$PDF_B64\",
    \"document_name\": \"Mon_document.pdf\",
    \"signers\": [
      {\"name\": \"Jean Dupont\", \"email\": \"jean@example.com\"}
    ]
  }"

Authentification

Ajoutez votre cle API dans le header de chaque requete. Deux formats sont acceptes :

X-API-Key: votre_cle_sign

ou

Authorization: Bearer votre_cle_sign

Endpoints

Copiercurl https://sign.layerone.fr/v1/health

{
  "status": "ok",
  "service": "sign-api",
  "version": "1.0.0"
}

Copiercurl -X POST https://sign.layerone.fr/v1/documents/send \
  -H "X-API-Key: VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{
    "pdf_base64": "JVBERi0xLjQK...",
    "document_name": "Devis_001.pdf",
    "signers": [
      {"name": "Jean Dupont", "email": "jean@example.com", "role": "Client"}
    ],
    "note": "Merci de signer ce devis.",
    "expiry_days": 14
  }'

Copierimport requests, base64

# Encoder le PDF
with open("devis.pdf", "rb") as f:
    pdf_b64 = base64.b64encode(f.read()).decode()

response = requests.post(
    "https://sign.layerone.fr/v1/documents/send",
    headers={
        "X-API-Key": "VOTRE_CLE",
        "Content-Type": "application/json"
    },
    json={
        "pdf_base64": pdf_b64,
        "document_name": "Devis_001.pdf",
        "signers": [
            {"name": "Jean Dupont", "email": "jean@example.com"}
        ]
    }
)

data = response.json()
print("Document ID:", data["document_id"])

{
  "success": true,
  "document_id": "244",
  "signing_urls": {
    "jean@example.com": "https://sign.layerone.fr/sign/abc123..."
  },
  "original_pdf_hash": "a1b2c3d4e5f6...",
  "message": "Document cree avec 2 champ(s)",
  "otp_required": false
}

Copiercurl -X DELETE https://sign.layerone.fr/v1/documents/{id} \
  -H "X-API-Key: VOTRE_CLE"

Copiercurl https://sign.layerone.fr/v1/documents/{id} \
  -H "X-API-Key: VOTRE_CLE"

{
  "success": true,
  "document_id": "244",
  "title": "Devis_001.pdf",
  "status": "SENT",
  "completed": false,
  "recipients": [
    {
      "email": "jean@example.com",
      "signingStatus": "SENT"
    }
  ]
}

Copiercurl https://sign.layerone.fr/v1/documents/{id}/download \
  -H "X-API-Key: VOTRE_CLE"

{
  "success": true,
  "document_id": "244",
  "title": "Devis_001.pdf",
  "pdf_base64": "JVBERi0xLjQK...",
  "audit_certificate_base64": "JVBERi0xLjQK...",
  "size_bytes": 125430
}

Copiercurl https://sign.layerone.fr/v1/documents/{id}/audit \
  -H "X-API-Key: VOTRE_CLE"

{
  "success": true,
  "certificate": {
    "document_id": "244",
    "title": "Devis_001.pdf",
    "status": "COMPLETED",
    "created_at": "2026-04-14T09:00:00Z",
    "completed_at": "2026-04-14T10:30:00Z",
    "external_id": "244",
    "signature_type": "CAdES/ETSI (Signature Electronique Avancee)",
    "compliance": "eIDAS - Niveau 2 (Signature Avancee)",
    "recipients": [
      {
        "email": "jean@example.com",
        "name": "Jean Dupont",
        "role": "SIGNER",
        "signing_status": "SIGNED",
        "read_status": "OPENED",
        "signed_at": "2026-04-14T10:30:00Z",
        "send_status": "SENT"
      }
    ],
    "fields": [
      {
        "type": "SIGNATURE",
        "page": 3,
        "value": null,
        "inserted": true
      }
    ],
    "audit_trail": [
      {
        "type": "DOCUMENT_CREATED",
        "name": null,
        "email": null,
        "ip_address": "192.168.1.1",
        "user_agent": "Mozilla/5.0...",
        "timestamp": "2026-04-14T09:00:00Z",
        "data": {}
      }
    ],
    "total_events": 1
  },
  "proof_bundle": {
    "document_id": "244",
    "original_pdf_hash": "3f9a1c...",
    "signed_pdf_hash": "8b2e77...",
    "signer_name": "Jean Dupont",
    "otp_verified": true,
    "pades_signed": true
  }
}

Copiercurl https://sign.layerone.fr/v1/documents/{id}/validate \
  -H "X-API-Key: VOTRE_CLE"

{
  "success": true,
  "document_id": "244",
  "title": "Devis_001.pdf",
  "source": "pades_local",
  "validation": {
    "total_signatures": 1,
    "all_valid": true,
    "signatures": [
      {
        "field_name": "Signature_Client",
        "intact": true,
        "valid": true,
        "trusted": true,
        "type": "signature",
        "signer": "2026-04-14T10:30:00Z",
        "coverage": "ENTIRE_FILE",
        "timestamp_valid": true
      }
    ]
  }
}

Copiercurl -X POST https://sign.layerone.fr/v1/documents/detect-fields \
  -H "X-API-Key: VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"pdf_base64": "JVBERi0xLjQK..."}'

{
  "success": true,
  "fields_count": 2,
  "fields": [
    {
      "name": "SIGNATURE_CLIENT",
      "type": "SIGNATURE",
      "role": "Client",
      "page": 1,
      "x": 55.2,
      "y": 82.1,
      "width": 25,
      "height": 5
    },
    {
      "name": "DATE_SIGNATURE",
      "type": "DATE",
      "role": "Client",
      "page": 1,
      "x": 55.2,
      "y": 89.0,
      "width": 20,
      "height": 3
    }
  ]
}

Webhooks

Recevez une notification automatique quand le statut d'une signature change.

Configurer votre webhook

Reserve aux cles API du portail developpeur (sk_). Une cle = un webhook : PUT /v1/webhooks/me cree ou REMPLACE la configuration (un nouveau secret HMAC est genere a chaque appel), GET /v1/webhooks/me retourne la configuration courante (sans le secret) ainsi que les 20 dernieres livraisons, et DELETE /v1/webhooks/me supprime la configuration.

Copiercurl -X PUT https://sign.layerone.fr/v1/webhooks/me \
  -H "Authorization: Bearer VOTRE_CLE_SK" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://votre-serveur.example.com/webhooks/sign",
    "events": ["document.completed", "document.rejected"]
  }'

La reponse contient un champ secret, affiche une seule fois : conservez-le, il sert a verifier la signature de chaque notification recue (voir plus bas). Le parametre events est optionnel : sans lui, la cle est abonnee a tous les evenements.

Evenements

Exemple de notification recue

{
  "event": "document.completed",
  "document_id": "244",
  "title": "Devis_001.pdf",
  "status": "COMPLETED",
  "recipients": [
    {
      "email": "jean@example.com",
      "status": "SIGNED",
      "signed_at": "2026-04-14T10:30:00Z"
    }
  ],
  "occurred_at": "2026-04-14T10:30:01Z",
  "download_url": "https://sign.layerone.fr/v1/documents/244/download"
}

Securite des notifications

Chaque notification est signee : l'en-tete X-Sign-Signature contient sha256= suivi du HMAC-SHA256 hexadecimal du corps brut de la requete, calcule avec votre secret webhook. Avant de traiter une notification, recalculez ce HMAC sur le corps brut recu et comparez-le (en temps constant) a la valeur de l'en-tete : si elle ne correspond pas, rejetez la requete.

Flux complet : generer + signer

Si vous utilisez aussi la DocX API, voici le flux recommande :

Zones de signature dans le PDF

Deux methodes pour positionner les champs de signature, date, initiales, etc. Si aucune methode n'est utilisee, un champ signature est place en bas de la derniere page par defaut.

Methode 1 : Balises dans le PDF (recommandee)

Placez des balises en texte directement dans votre PDF ou template Word. L'API les detecte et positionne les champs automatiquement a leur emplacement exact. Les balises sont effacees du PDF final.

Format etendu — pour controler le type, la taille et le role :

[[NOM_DU_CHAMP;type=TYPE;role=ROLE;width=LARGEUR;height=HAUTEUR;options=A,B,C]]

Signature du client :       [[SIGNATURE_CLIENT]]
Date :                      [[DATE_SIGNATURE]]
Lu et approuve :            [[LU_ET_APPROUVE;type=TEXT;width=120;height=20]]
Signature fournisseur :     [[SIGNATURE_FOURNISSEUR;type=SIGNATURE;role=Fournisseur]]
Signature entreprise 3 :    [[SIGNATURE_ENTREPRISE_3]]
Menu deroulant :            [[ACCEPTE;type=DROPDOWN;options=Oui,Non,À étudier]]

Methode 2 : Parametre signature_fields dans l'API

Si vous ne pouvez pas modifier le PDF, passez les positions manuellement via le parametre signature_fields. Les coordonnees x et y sont en pourcentage de la page (0 a 100).

Copiercurl -X POST https://sign.layerone.fr/v1/documents/send \
  -H "X-API-Key: VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{
    "pdf_base64": "JVBERi0xLjQK...",
    "document_name": "Contrat.pdf",
    "signers": [
      {"name": "Jean Dupont", "email": "jean@example.com", "role": "Client"}
    ],
    "signature_fields": [
      {
        "name": "Signature",
        "type": "SIGNATURE",
        "role": "Client",
        "page": 3,
        "x": 55,
        "y": 80,
        "width": 30,
        "height": 8
      },
      {
        "name": "Date",
        "type": "DATE",
        "role": "Client",
        "page": 3,
        "x": 55,
        "y": 90,
        "width": 20,
        "height": 3
      }
    ]
  }'

Limites de debit

Chaque endpoint a une limite de requetes par minute par cle API. Si vous depassez la limite, vous recevez une erreur 429 Too Many Requests.

Codes d'erreur

En cas d'erreur, la reponse contient un champ detail qui explique le probleme.