LeyApp per a desenvolupadors

Visió general

API exposa les mateixes dades d'advocats verificats que leyapp.es: cerca, perfils públics, ressenyes, disponibilitat i intencions de reserva. L'accés anònim funciona amb límits de velocitat baixos; una clau API augmenta els límits i desbloqueja els punts finals protegits per clau i les anàlisis d'ús.

Inici ràpid

De zero a una intenció de reserva (de prova) en quatre sol·licituds. Crea primer una clau de prova gratuïta a Dashboard → Developer.

# 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"}'

Autenticació

Envia la teva clau com un token Bearer en cada petició:

Authorization: Bearer leyk_...

• Les claus es presenten en variants live (leyk_) i test (leyk_test_) i s'exhibeixen exactament una vegada en crear-se — guarda-les en un gestor de secrets.
• No envieu mai una clau al codi client ni a un repositori públic. Gireu les claus creant-ne una de nova, desplegant-la i revocant la vella (sense temps d'inactivitat).
• La revocació és instantània. Les claus perdudes no es poden recuperar — només es poden substituir.
• Els tokens MCP (ley_...) autentiquen els assistents d'IA a /api/mcp i no són vàlids a l'API REST.

Límits de velocitat

Les sol·licituds amb clau tenen límits per nivell (doble finestra: pic per minut + quota diària) amb els encapçalaments X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Reset. En el codi d'error 429, respecta Retry-After i torna a provar amb un retard exponencial aleatoritzat.

Les noves claus comencen al nivell gratuït. Els nivells de soci són atorgats per l'equip de LeyApp — contacta'ns a través del formulari de suport si la teva integració necessita més capacitat. Les sol·licituds anònimes utilitzen límits per IP separats i més baixos.

Mode de prova

Les claus de prova (leyk_test_) es comporten exactament com les claus en viu — mateixos punts finals, mateixa validació, mateixes formes de resposta — però no passa res de real: no s'emmagatzema cap intenció de reserva, no es notifica cap advocat, no es pot confirmar ni pagar res.

El trànsit de prova apareix al registre de sol·licituds del teu tauler de control (marcat), però s'exclou dels agregats diaris. Substitueix la clau per una de real quan facis el desplegament — no cal cap altre canvi.

Punts finals

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

Subscriu un punt final HTTPS (Tauler de control → Desenvolupador → Webhooks) als esdeveniments de les intencions de reserva creades amb la teva clau. Les entregues segueixen l'especificació de Webhooks estàndard i es tornen a provar automàticament.

• Esdeveniments: booking_intent.confirmed / booking_intent.expired (l'etapa d'intenció), a més del cicle complet de vida de la reserva per a les reserves originades aAPI: booking.approved, booking.cancelled, booking.completed.
• Verifica cada entrega amb el secret de signatura whsec_ que es mostra una sola vegada en la creació de l'endpoint — les biblioteques oficials de standardwebhooks ho fan en una sola crida. Rebutja els segells de temps més antics de ±5 minuts.
• La lliurament és com a mínim un sol cop: es fa la desduplicació mitjançant l'encapçalament webhook-id (i també l'ID de la càrrega útil). Les càrregues útils només contenen IDs i estats — obtingueu els detalls de l'API si els necessiteu.

# 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 i agents d'IA

Prefereixes parlar en lloc de programar? LeyApp inclou un servidor MCP amb 15 eines — cerca, disponibilitat, reserves i (amb el teu consentiment) les teves pròpies reserves — per a Claude, ChatGPT, Cursor i qualsevol client compatible amb MCP. OAuth amb consentiment i nivells de permís granulars; revoca-ho en qualsevol moment des del Dashboard → Developer.

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.

Diari de canvis

API v1 és només d'addició: els camps s'afegeixen, mai no es renominen ni s'eliminen. Els canvis incompatibles es publicarien com una nova versió amb un període de deprecació de 90 dies anunciat aquí i mitjançant els encapçalaments Deprecation/Sunset.