Inscrivez vous dès aujourd'hui et obtenez l'envoi d'une lettre recommandée électronique à valeur probante.

Tools
API REST v1 — Production

Documentation API
Signature électronique par lot

Intégration REST clé-en-main pour signer, en une opération, des lots de documents avec un ou plusieurs signataires. Exemples curl copiables, calculateur de temps d'upload, guide gros volumes.

Swagger UI interactif Télécharger OpenAPI JSON← Retour à la page produit

Vue d'ensemble

L'API LRE Trust est une API REST JSON, versionnée en /v1, sécurisée par une clé API à passer dans l'en-tête HTTP X-API-Key. Un seul environnement, une seule URL — le mode Sandbox ou Production est déterminé par le type de clé utilisée.

Sandbox
onee_test_...
OTP fixe 0000, aucun email/SMS réel envoyé, aucun crédit facturé.
Production
onee_live_...
Signatures réelles, notifications réelles, crédits débités.
URL de base : https://lretrust.com/api

Testeur interactif

Testez notre API sans écrire une seule ligne de code. Collez votre clé onee_test_* ouonee_live_*, choisissez un endpoint, cliquez sur envoyer — la réponse s'affiche en temps réel avec le status HTTP, le temps de réponse et le corps JSON.

Testeur interactif
Appelle notre API en direct depuis votre navigateur — aucun serveur intermédiaire.
Votre clé reste dans votre navigateur — nous ne la stockons ni ne la loggons côté client.
Endpoint le plus simple : valide votre clé et renvoie les infos entreprise.
Réponse
La réponse de l'API s'affichera ici (status, temps, corps JSON).
Pas encore de clé ? Demandez un accès Sandbox — activation en 24h, OTP de test 0000.

Authentification

Chaque requête doit inclure l'en-tête X-API-Key. Testez que votre clé est valide et que votre entreprise est active via l'endpoint /v1/batch/auth.

bash
curl -X POST "https://lretrust.com/api/v1/batch/auth" \
  -H "X-API-Key: VOTRE_CLE"

Réponse 200 OK avec le nom de l'entreprise et l'environnement. 401 si la clé est invalide.

Solde de crédits

Consultez à tout moment votre solde disponible et vos crédits réservés (verrouillés sur des lots en cours de signature).

bash
curl -X GET "https://lretrust.com/api/v1/batch/balance" \
  -H "X-API-Key: VOTRE_CLE"

Injection standard (petits lots)

Injecte N documents groupés en une seule transaction pour un signataire unique. Recommandé pour les lots de moins de 10 documents ou moins de 20 MB cumulés. Chaque signature consomme 1 crédit.

bash
curl -X POST "https://lretrust.com/api/v1/batch/signatures" \
  -H "X-API-Key: VOTRE_CLE" -H "Content-Type: application/json" \
  -d '{
    "signatory": {
      "email": "karim@onee.ma",
      "first_name": "Karim",
      "last_name": "Benali",
      "phone": "+212600112233"
    },
    "documents": [
      {"name": "contrat.pdf", "content_base64": "<PDF_BASE64>"}
    ],
    "webhook_url": "https://serveur.onee.ma/webhooks/lretrust",
    "reference": "LOT-2026-001"
  }'

Circuit multi-signataires

Faites signer un même document par plusieurs personnes en circuit séquentiel (l'un après l'autre) ou parallèle (indépendamment). Détection automatique des signataires internes vs externes ; les externes reçoivent un lien magique valable 15 jours.

Sequential
Le signataire N+1 est notifié uniquement quand N a signé. Idéal pour parapheur hiérarchique.
Parallel
Tous les signataires notifiés simultanément. Ordre libre, chacun signe quand il veut.
bash
curl -X POST "https://lretrust.com/api/v1/batch/signatures" \
  -H "X-API-Key: VOTRE_CLE" -H "Content-Type: application/json" \
  -d '{
    "documents": [{"name": "contrat.pdf", "content_base64": "<PDF_BASE64>"}],
    "signatories": [
      {"email": "chef@onee.ma",       "first_name": "Karim",  "phone": "+2126...", "order": 1},
      {"email": "avocat@cabinet.ma",  "first_name": "Mounir", "phone": "+2126...", "order": 2}
    ],
    "workflow": "sequential",
    "webhook_url": "https://serveur.onee.ma/webhooks/lretrust",
    "reference": "LOT-2026-042"
  }'

Tarification : 1 crédit par signature électronique. Un document signé par 3 personnes = 3 crédits. Les crédits sont libérés automatiquement si un signataire refuse ou si le circuit expire à J+15.

Upload en 3 étapes (gros volumes)

Pour les lots volumineux (recommandé à partir de 10 documents ou 20 MB cumulés), utilisez le flow d'upload segmenté qui évite les timeouts et permet de paralléliser côté client.

Calculateur — Combien de temps pour uploader ?

MB
Mbps
Endpoint monolithique (base64)
106.4s
Payload : 133.0 MB (base64)
Risque de timeout (> 60s)
Upload en 3 étapes (multipart)
13.3s
50 requêtes parallèles ×6 — 100.0 MB binaire
Méthode recommandée

Étape 1 — Init (créer le brouillon)

bash
curl -X POST "https://lretrust.com/api/v1/batch/signatures/init" \
  -H "X-API-Key: VOTRE_CLE" -H "Content-Type: application/json" \
  -d '{
    "signatories": [
      {"email": "chef@onee.ma", "order": 1},
      {"email": "avocat@cabinet.ma", "order": 2}
    ],
    "workflow": "sequential",
    "expected_documents": 50,
    "webhook_url": "https://serveur.onee.ma/webhooks/lretrust",
    "reference": "LOT-2026-042"
  }'

Étape 2 — Upload doc-par-doc (parallélisable)

Multipart/form-data (fichier binaire, pas de base64). L'en-tête Idempotency-Key permet de rejouer un upload en toute sécurité en cas d'échec réseau. Rate-limit : 20 requêtes/seconde/lot.

bash
curl -X POST "https://lretrust.com/api/v1/batch/{BATCH_ID}/documents" \
  -H "X-API-Key: VOTRE_CLE" \
  -H "Idempotency-Key: doc-001-retry-1" \
  -F "file=@facture_001.pdf" -F "name=facture_001.pdf"

Étape 3 — Commit

Vérifie la cohérence (uploaded == expected), verrouille les crédits (N × M) et déclenche l'initialisation du circuit + les notifications aux signataires.

bash
curl -X POST "https://lretrust.com/api/v1/batch/{BATCH_ID}/commit" \
  -H "X-API-Key: VOTRE_CLE"
Max docs / lot
200
Max taille / PDF
20 MB
Max cumulé / lot
500 MB
Expiration brouillon
24 h
Rate-limit
20 req/s/lot
Concurrence conseillée
6 uploads

Télécharger le PDF signé

Une fois un document signé, récupérez-le par 3 méthodes complémentaires : inline dans le webhook document.signed, ou à la demande via l'endpoint dédié ci-dessous.

bash
# PDF signé binaire (par défaut)
curl -X GET "https://lretrust.com/api/v1/batch/documents/{DOC_ID}/download" \
  -H "X-API-Key: VOTRE_CLE" --output contrat_signe.pdf

# Fichier de preuve légal (ZIP)
curl -X GET "https://lretrust.com/api/v1/batch/documents/{DOC_ID}/download?format=proof" \
  -H "X-API-Key: VOTRE_CLE" --output preuve.zip

# JSON avec base64 (intégration server-to-server)
curl -X GET "https://lretrust.com/api/v1/batch/documents/{DOC_ID}/download?format=json" \
  -H "X-API-Key: VOTRE_CLE"

Gérer les signataires

Les 4 endpoints de gestion des collaborateurs signataires acceptent votre clé X-API-Key(auth machine-to-machine unifiée) ou un JWT admin entreprise.

bash
# Lister les collaborateurs
curl -X GET "https://lretrust.com/api/enterprise/collaborators" \
  -H "X-API-Key: VOTRE_CLE"

# Créer un collaborateur
curl -X POST "https://lretrust.com/api/enterprise/collaborators" \
  -H "X-API-Key: VOTRE_CLE" -H "Content-Type: application/json" \
  -d '{
    "email": "nouveau@onee.ma",
    "full_name": "Nouveau Collaborateur",
    "phone": "+212611111111",
    "send_invitation": true
  }'

# Modifier
curl -X PUT "https://lretrust.com/api/enterprise/collaborators/{USER_ID}" \
  -H "X-API-Key: VOTRE_CLE" -H "Content-Type: application/json" \
  -d '{"full_name": "Nom Modifie"}'

# Relancer l'invitation
curl -X POST "https://lretrust.com/api/enterprise/collaborators/{USER_ID}/resend-invitation" \
  -H "X-API-Key: VOTRE_CLE"

Webhooks (restitution)

Deux webhooks sont émis par document vers votre webhook_url. Répondez en HTTP 2xx pour acquitter, sinon retry automatique avec backoff (jusqu'à 6 tentatives).

document.signed

json
{
  "event": "document.signed",
  "delivery_id": "d_...",
  "timestamp": "2026-07-13T10:15:22+00:00",
  "environment": "production",
  "batch_id": "batch_onee_987654321",
  "document_id": "doc_lre_001",
  "document_name": "contrat_1.pdf",
  "status": "signed",
  "reference": "LOT-2026-001",
  "signatory": {
    "full_name": "Karim Benali",
    "email": "collab@onee.ma",
    "first_name": "Karim",
    "last_name": "Benali",
    "phone": "+212600112233"
  },
  "signed_at": "2026-07-13T10:15:20+00:00",
  "signed_pdf_base64": "<PDF_SIGNE_BASE64>",
  "proof_available": false
}

document.proof_ready (~6h après)

json
{
  "event": "document.proof_ready",
  "document_id": "doc_lre_001",
  "status": "signed",
  "proof_available": true,
  "proof_file_base64": "<ZIP_PREUVE_BASE64>",
  "proof_format": "ZIP"
}

Renvoi manuel

bash
curl -X POST "https://lretrust.com/api/v1/batch/webhooks/{DELIVERY_ID}/retry" \
  -H "X-API-Key: VOTRE_CLE"

Conformité

Chaque signature électronique produite par LRE Trust est conforme aux réglementations suivantes :

eIDAS
Règlement européen n°910/2014 — reconnaissance transfrontalière UE.
Loi 53-05
Loi marocaine sur l'échange électronique de données juridiques.
Loi 43-20
Loi marocaine sur les services de confiance électroniques.

Chaque document signé est accompagné d'un dossier de preuves (fichier ZIP) contenant le certificat, l'horodatage qualifié et le fichier de preuve d'archivage.

Besoin d'un point technique ?

Nous accompagnons vos équipes intégration en visio (Google Meet ou Teams) pour valider votre architecture.

Nous contacter Découvrir la solution