API Immobilier France — Le guide complet pour développeurs
Tout ce qu’il faut pour intégrer la gestion locative française en moins d’une heure. JWT Bearer, sandbox complet, OpenAPI 3.0 générable en SDK — et zéro conformité Loi Alur à coder vous-même.
30 min
De zéro à premier bail créé en sandbox
200ms
Latence API FairePlace production (P95)
300
Requêtes/min en production (rate limit)
OpenAPI
3.0 spec — SDK générable Python, TS, PHP, Go, Java, .NET
🚀
Développeur junior
Problème : Pas sûr de comprendre toute la réglementation des baux français.
Solution : L’API retourne des erreurs 422 avec références légales. Pas besoin d’être juriste.
🏗️
CTO / Tech Lead
Problème : 3 mois de dev de conformité Alur avant de livrer une seule feature.
Solution : 3 mois de dev → 1 jour d’intégration API. OpenAPI 3.0 générable en SDK.
💼
Product Manager PropTech
Problème : Roadmap surchargée par la conformité réglementaire FR.
Solution : Déléguez la conformité à l’API. Focalisez l’équipe sur la valeur produit.
Base URL et conventions REST
Base URL — Production
https://api.faireplace.com/api🔑
Bearer JWT
Authentification par token JWT scopé à votre organisation
🆔
UUID v4
Tous les identifiants de ressources sont des UUID v4
📅
ISO 8601
Dates au format YYYY-MM-DD, timestamps en UTC
📖
OpenAPI 3.0
Spec disponible à /api/docs/openapi.json — SDK générable
🧪
Sandbox gratuit
Environnement de test complet — pas de carte bancaire
🔔
Webhooks
Événements temps réel pour tous les objets métier
Authentification — Obtenir un token JWT
POST /auth/login
curl -X POST https://api.faireplace.com/api/auth/login
-H 'Content-Type: application/json'
-d '{"email":"[email protected]","password":"..."}'
// Réponse 200 OK
{
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"token_type": "Bearer",
"expires_in": 3600
}Codes de réponse HTTP
| Code | Signification | Cas d’usage |
|---|---|---|
| 200 | OK | Requête GET/PUT réussie |
| 201 | Created | Ressource créée (POST) |
| 422 | Unprocessable Entity | Données invalides (bail hors plafond loyer, DPE manquant…) |
| 401 | Unauthorized | Token JWT manquant ou expiré |
| 429 | Too Many Requests | Rate limit dépassé — réessayer après Retry-After |
Commencez à builder en moins d’une heure
Sandbox gratuit, OpenAPI 3.0, exemples curl pour chaque endpoint.