Guide d'intégration API

L'API REST JuriSign vous permet d'intégrer la signature électronique conforme eIDAS (SES) directement dans votre back-office ou votre application. Vous pouvez :

• Télécharger des documents PDF
• Créer des demandes de signature avec un ou plusieurs signataires
• Valider l'identité par code OTP email ou SMS
• Suivre l'avancement en temps réel via webhooks
• Télécharger les documents signés et les preuves d'audit

L'API utilise l'authentification par Bearer Token (Laravel Sanctum). Obtenez un token avec vos identifiants :

// Requête
curl -X POST https://www.jurisign.fr/api/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "email": "votre@email.com",
    "password": "votre_mot_de_passe",
    "device_name": "mon-backoffice"
  }'

// Réponse
{
  "token": "1|abc123def456...",
  "token_type": "Bearer",
  "user": {
    "id": "uuid-...",
    "name": "Christophe Duval",
    "email": "christophe.duval@trimaran.com",
    "organization": {
      "id": "uuid-...",
      "name": "Trimaran"
    }
  }
}

POST /api/v1/documents

Envoyez le PDF en multipart/form-data. Taille max : 20 Mo.

curl -X POST https://www.jurisign.fr/api/v1/documents \
  -H "Authorization: Bearer VOTRE_TOKEN" \
  -F "file=@contrat.pdf" \
  -F "title=Contrat de bail 2026"

// Réponse 201
{
  "data": {
    "id": "doc-uuid-...",
    "title": "Contrat de bail 2026",
    "original_filename": "contrat.pdf",
    "status": "draft",
    "page_count": 5,
    "file_size": 245760,
    "created_at": "2026-03-31T10:00:00+02:00"
  }
}

curl -X POST https://www.jurisign.fr/api/v1/documents   -H "Authorization: Bearer VOTRE_TOKEN"   -F "files[]=@contrat.pdf"   -F "files[]=@annexe1.pdf"   -F "files[]=@annexe2.pdf"   -F "title=Contrat + annexes"

// Réponse 201 — un seul document, la somme des pages
{
  "data": {
    "id": "doc-uuid-...",
    "title": "Contrat + annexes",
    "page_count": 11,
    "merged_from": 3
  }
}

POST /api/v1/sign-requests

Définissez les signataires, le canal OTP (email ou SMS), les zones de signature et la durée de validité.

curl -X POST https://www.jurisign.fr/api/v1/sign-requests \
  -H "Authorization: Bearer VOTRE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "document_id": "doc-uuid-...",
    "subject": "Signature du contrat de bail",
    "message": "Merci de bien vouloir signer ce document.",
    "signing_order_type": 0,
    "expiry_hours": 168,
    "signers": [
      {
        "prenom": "Jean",
        "nom": "Dupont",
        "email": "jean.dupont@email.com",
        "otp_channel": "sms",
        "telephone": "+33612345678"
      },
      {
        "prenom": "Marie",
        "nom": "Martin",
        "email": "marie.martin@email.com",
        "otp_channel": "email"
      }
    ],
    "zones": [
      {
        "signer_index": 0,
        "page": 5,
        "x": 10,
        "y": 75,
        "width": 35,
        "height": 10
      },
      {
        "signer_index": 1,
        "page": 5,
        "x": 55,
        "y": 75,
        "width": 35,
        "height": 10
      }
    ]
  }'

POST /api/v1/sign-requests/{uuid}/send

Déclenche l'envoi des invitations par email à chaque signataire. Le signataire reçoit un lien sécurisé unique pour signer.

curl -X POST https://www.jurisign.fr/api/v1/sign-requests/sr-uuid-.../send \
  -H "Authorization: Bearer VOTRE_TOKEN"

// Réponse 200
{
  "message": "Demande envoyée aux signataires.",
  "data": {
    "id": "sr-uuid-...",
    "status": "pending",
    "sent_at": "2026-03-31T10:05:00+02:00"
  }
}

Recevez des notifications en temps réel sur votre serveur lorsqu'un événement se produit :

Enregistrer un webhook

POST /api/v1/webhooks

curl -X POST https://www.jurisign.fr/api/v1/webhooks \
  -H "Authorization: Bearer VOTRE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://votre-serveur.com/webhooks/jurisign",
    "events": ["sign_request.completed", "signer.signed"]
  }'

// Réponse 201 - conservez le secret !
{
  "data": {
    "id": 1,
    "url": "https://votre-serveur.com/webhooks/jurisign",
    "events": ["sign_request.completed", "signer.signed"],
    "secret": "wh_sec_abc123..."
  }
}

Le champ redirect_url affiche au signataire, une fois sa signature faite, un bouton « Revenir sur votre-site.fr ». Il est facultatif : sans lui, l'API fonctionne entièrement et le signataire voit la page de confirmation JuriSign.

Pour l'utiliser, votre nom de domaine doit être déclaré au préalable auprès du support. Tant qu'aucun domaine n'est déclaré, toute redirect_url est refusée (HTTP 422), et la demande n'est pas créée.

JuriSign supporte deux canaux de validation OTP pour vérifier l'identité du signataire :

L'API retourne des codes HTTP standards avec un corps JSON décrivant l'erreur :

// Exemple d'erreur 422
{
  "message": "Les données fournies ne sont pas valides.",
  "errors": {
    "document_id": ["Le champ document id est requis."],
    "signers.0.email": ["L'adresse email est invalide."]
  }
}