API pour Développeurs
LeyApp propose une API publique pour consulter la disponibilité des avocats et initier des réservations de consultations. Conçue pour les assistants IA, les intégrations et les outils tiers.
Rejoignez la bêta de l'API LeyApp
Inscrivez-vous pour un accès anticipé aux clés API, des limites de taux plus élevées et de nouveaux endpoints au fur et à mesure de leur lancement.
Nous informerons les développeurs lorsque les clés API seront disponibles.
Endpoints disponibles
/api/v1/lawyers/{lawyer_id}/availabilityRetourne les créneaux de consultation disponibles pour un avocat spécifique. Aucune authentification requise. Plage de dates limitée à 14 jours.
Paramètres de requête
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| start_date | YYYY-MM-DD | Non | Début de la plage de dates (par défaut : aujourd'hui) |
| end_date | YYYY-MM-DD | Non | Fin de la plage de dates (par défaut : aujourd'hui + 13 jours) |
Exemple de réponse
{
"lawyer_id": "a1b2c3d4-...",
"lawyer_name": "Ana García López",
"hourly_rate_cents": 12000,
"currency": "EUR",
"booking_fee_cents": 200,
"slots": [
{
"date": "2026-03-02",
"start_time": "09:00:00",
"end_time": "10:00:00",
"available": true
}
],
"booking_url": "https://leyapp.es/lawyer/a1b2c3d4#book",
"profile_url": "https://leyapp.es/lawyer/a1b2c3d4"
}/api/v1/bookings/initiateCrée une intention de réservation et retourne une URL de confirmation. L'utilisateur doit visiter cette URL pour s'authentifier et compléter le paiement. Les réservations ne peuvent pas être complétées uniquement via l'API.
Corps de la requête
POST /api/v1/bookings/initiate
Content-Type: application/json
{
"lawyer_id": "a1b2c3d4-...",
"date": "2026-03-02",
"start_time": "09:00:00",
"end_time": "10:00:00",
"source": "ai_agent",
"agent_name": "ChatGPT"
}Exemple de réponse
{
"booking_intent_id": "intent_xyz789",
"confirmation_url": "https://leyapp.es/book/confirm?intent=intent_xyz789",
"expires_at": "2026-03-02T08:00:00Z",
"slot": { "date": "2026-03-02", "start_time": "09:00:00", "end_time": "10:00:00" },
"lawyer": { "id": "a1b2c3d4-...", "name": "Ana García López", "hourly_rate_cents": 12000 },
"message": "To confirm this booking, the user must visit the confirmation URL."
}Notes importantes
Authentification utilisateur toujours requise
Les assistants IA doivent présenter l'URL de confirmation à l'utilisateur. L'utilisateur doit toujours se connecter et confirmer le paiement sur LeyApp.
Limites de taux
Disponibilité : 10 requêtes/min par IP. Initiation de réservation : 5 requêtes/heure par IP.
Les intentions expirent en 15 minutes
Les liens de confirmation de réservation expirent après 15 minutes. Vérifiez toujours la disponibilité avant de créer une nouvelle intention.
Les prix sont en centimes d'EUR
Tous les montants sont en centimes (ex. 12000 = 120,00 €). La devise est toujours EUR.
Prochainement
Clés API et authentification
Inscription développeur avec clés API pour des limites de taux plus élevées et le suivi d'utilisation.
Endpoint de recherche d'avocats
Recherchez des avocats par spécialité, ville, langue et fourchette de prix via l'API.
Notifications par webhooks
Recevez des notifications en temps réel lorsque des réservations sont confirmées, annulées ou modifiées.
Authentification OAuth 2.1
Flux OAuth délégué pour les partenaires IA de confiance pour compléter des réservations au nom des utilisateurs.
Besoin de plus d'informations ou envie d'intégrer l'API LeyApp ?