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://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://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"
  }
}

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://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://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://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..."
  }
}

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."]
  }
}