LeyApp pour les développeurs

Présentation générale

L'API «API » fournit les mêmes données vérifiées sur les avocats que le site leyapp.es : recherche, profils publics, avis, disponibilités et intentions de prise de rendez-vous. L'accès anonyme est soumis à des limites de requêtes peu élevées ; une clé « API » permet d'augmenter ces limites et de débloquer des points de terminaison protégés par clé ainsi que des analyses d'utilisation.

Guide de démarrage rapide

De zéro à une intention de réservation (à titre d'essai) en quatre requêtes. Commencez par créer une clé d'essai gratuite dans Tableau de bord → Développeur.

# 1. Get a test key at leyapp.es/dashboard/developer
export LEYAPP_API_KEY="leyk_test_..."

# 2. Find a lawyer
curl "https://leyapp.es/api/v1/lawyers/search?city=Barcelona&practice_area=immigration" \
  -H "Authorization: Bearer $LEYAPP_API_KEY"

# 3. Check availability (id from step 2)
curl "https://leyapp.es/api/v1/lawyers/<lawyer_id>/availability" \
  -H "Authorization: Bearer $LEYAPP_API_KEY"

# 4. Create a (test) booking intent
curl -X POST "https://leyapp.es/api/v1/bookings/initiate" \
  -H "Authorization: Bearer $LEYAPP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: demo-1" \
  -d '{"lawyer_id":"<lawyer_id>","date":"<date>","start_time":"09:00:00","end_time":"10:00:00"}'

Authentification

Envoyez votre clé sous forme de jeton « Bearer » à chaque requête :

Authorization: Bearer leyk_...

• Les clés existent en deux versions : « live » (leyk_) et « test » (leyk_test_) ; elles s'affichent une seule fois lors de leur création — conservez-les dans un gestionnaire de secrets.
• N'envoie jamais une clé dans du code côté client ni dans un dépôt public. Procède à la rotation en créant une nouvelle clé, en la déployant, puis en révoquant l'ancienne (sans interruption de service).
• La révocation est immédiate. Les clés perdues ne peuvent pas être récupérées, mais uniquement remplacées.
• Les jetons MCP (ley_...) permettent d'authentifier les assistants IA sur /api/mcp et ne sont pas valides sur l'API REST.

Limites de débit

Les requêtes avec clé sont soumises à des limites par niveau (double fenêtre : rafale par minute + quota journalier) via les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset. En cas de code d'erreur 429, respecter le paramètre Retry-After et effectuer une nouvelle tentative avec un recul exponentiel à variation aléatoire.

Les nouvelles clés sont disponibles dès le niveau gratuit. Les niveaux de partenariat sont attribués par l'équipe LeyApp — contactez-nous via le formulaire d'assistance si votre intégration nécessite davantage de capacité. Les requêtes anonymes sont soumises à des limites distinctes et inférieures par adresse IP.

Mode test

Les clés de test (leyk_test_) fonctionnent exactement comme les clés de production — mêmes points de terminaison, même validation, mêmes formats de réponse — mais aucune action réelle n'est effectuée : aucune demande de réservation n'est enregistrée, aucun avocat n'est averti, rien ne peut être confirmé ni payé.

Le trafic de test apparaît dans le journal des requêtes de votre tableau de bord (signalé), mais il est exclu des agrégats quotidiens. Remplacez la clé par une clé de production lors du déploiement — aucune autre modification n'est nécessaire.

Critères d'évaluation

curl "https://leyapp.es/api/v1/lawyers/search?city=Barcelona&practice_area=immigration&language=en" \
  -H "Authorization: Bearer $LEYAPP_API_KEY"

curl "https://leyapp.es/api/v1/lawyers/<lawyerId>" \
  -H "Authorization: Bearer $LEYAPP_API_KEY"

curl "https://leyapp.es/api/v1/lawyers/<lawyerId>/availability" \
  -H "Authorization: Bearer $LEYAPP_API_KEY"

curl "https://leyapp.es/api/v1/lawyers/<lawyerId>/reviews" \
  -H "Authorization: Bearer $LEYAPP_API_KEY"

curl "https://leyapp.es/api/v1/practice-areas" \
  -H "Authorization: Bearer $LEYAPP_API_KEY"

curl "https://leyapp.es/api/v1/cities" \
  -H "Authorization: Bearer $LEYAPP_API_KEY"

{
  "lawyer_id": "<lawyer_id from search>",
  "date": "2026-09-01",
  "start_time": "09:00:00",
  "end_time": "10:00:00",
  "source": "api",
  "agent_name": "MyIntegration"
}

curl -X POST "https://leyapp.es/api/v1/bookings/initiate" \
  -H "Authorization: Bearer $LEYAPP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lawyer_id":"<lawyer_id from search>","date":"2026-09-01","start_time":"09:00:00","end_time":"10:00:00","source":"api","agent_name":"MyIntegration"}'

curl "https://leyapp.es/api/v1/booking-intents/<intentId>" \
  -H "Authorization: Bearer $LEYAPP_API_KEY"

Webhooks

Abonnez un point de terminaison HTTPS (Tableau de bord → Développeur → Webhooks) aux événements liés aux intentions de réservation créées avec votre clé. Les envois respectent la spécification Standard Webhooks et font l'objet de nouvelles tentatives automatiques.

• Événements : booking_intent.confirmed / booking_intent.expired (phase d'intention), ainsi que l'ensemble du cycle de vie des réservations effectuées via API : booking.approved, booking.cancelled, booking.completed.
• Vérifiez chaque livraison à l'aide de la clé de signature « whsec_ » affichée une seule fois lors de la création du point de terminaison — les bibliothèques officielles standardwebhooks effectuent cette opération en un seul appel. Rejetez les horodatages datant de plus de ±5 minutes.
• La livraison s'effectue au moins une fois : la déduplication s'effectue via l'en-tête « webhook-id » (qui correspond également à l'identifiant de la charge utile). Les charges utiles ne contiennent que des identifiants et des statuts — récupérez les détails sur API si vous en avez besoin.

# Delivery headers (Standard Webhooks — standardwebhooks.com):
#   webhook-id:        unique delivery id (dedup key — at-least-once delivery)
#   webhook-timestamp: unix seconds (reject if older than ±5 minutes)
#   webhook-signature: v1,<base64 HMAC-SHA256 of "{id}.{timestamp}.{body}">
#
# Payload: { "id": "...", "type": "booking_intent.confirmed",
#            "created_at": "...", "data": { "booking_intent_id": "...", "status": "..." } }
# Events: booking_intent.confirmed | booking_intent.expired
# Retries: 1m / 5m / 30m / 2h / 12h, then dead. Endpoint auto-disabled
# after 20 consecutive failures.

MCP et agents IA

Vous préférez discuter plutôt que de coder ? LeyApp fournit un serveur MCP comprenant 15 outils — recherche, disponibilité, réservation et (avec votre consentement) vos propres réservations — pour Claude, ChatGPT, Cursor et tout client compatible MCP. OAuth : donnez votre consentement avec des niveaux d’autorisation détaillés ; révoquez-le à tout moment depuis le Tableau de bord → Développeur.

Settings → Connectors → Add custom connector
Name: LeyApp
URL:  https://leyapp.es/api/mcp/mcp

Claude opens the LeyApp consent screen — sign in, pick a
permission level, and you're connected.

Historique des modifications

La version 1 de l'API est exclusivement additive : des champs sont ajoutés, mais jamais renommés ni supprimés. Les modifications rompant la compatibilité seraient publiées sous la forme d'une nouvelle version, accompagnée d'une période de dépréciation de 90 jours annoncée ici et via les en-têtes « Deprecation » et « Sunset ».