Comment intégrer la signature électronique de bail dans votre logiciel
Guide technique pas-à-pas pour intégrer la signature eIDAS de bail dans votre application SaaS. REST API, JWT, webhooks, exemples curl et SDK.
<1h
Temps d’intégration pour un développeur expérimenté
7
Endpoints de signature à maîtriser
JWT
Authentification — token Bearer scopé organisation
SDK
Client OpenAPI générable depuis la spec swagger.json
⚡ 5 endpoints pour intégrer la signature en 1h
- JWT auth : POST /auth/login → Bearer token
- Créer le bail : POST /leases
- Initier : POST /leases/{id}/signature/initiate
- Valider OTP : POST /leases/{id}/signature/validate/{type}
- Récupérer PDF : GET /leases/{id}/pdf
Étape 1 — Authentification JWT
Authentification — Bearer JWT
curl -X POST https://api.faireplace.com/api/auth/login
-H 'Content-Type: application/json'
-d '{"email":"[email protected]","password":"..."}'
// Réponse :
{ "access_token": "eyJhbGci...", "expires_in": 3600 }Étape 2 — Créer le bail et initier la signature
01
Créer l’immeuble et le lot
POST /places → POST /estates → récupérer les UUIDs
02
Créer le bail
POST /leases avec les données locataire, loyer et bail_type_id
03
Initier le workflow de signature
POST /leases/{id}/signature/initiate — déclenche l’envoi des OTP
04
Écouter les webhooks
Événement lease.signature.completed déclenché quand tous les signataires ont signé
05
Récupérer le PDF signé
GET /leases/{id}/pdf — disponible dès que le webhook est reçu
Prêt à intégrer la signature en production ?
Documentation interactive, exemples curl, sandbox gratuit.