API per a Desenvolupadors
LeyApp ofereix una API pública per consultar la disponibilitat d'advocats i iniciar reserves de consultes. Dissenyada per a assistents d'IA, integracions i eines de tercers.
Uneix-te a la beta de l'API de LeyApp
Registra't per obtenir accés anticipat a claus d'API, límits de taxa més alts i nous endpoints a mesura que els llancem.
Notificarem els desenvolupadors quan les claus d'API estiguin disponibles.
Endpoints disponibles
/api/v1/lawyers/{lawyer_id}/availabilityRetorna els horaris de consulta disponibles per a un advocat específic. No requereix autenticació. El rang de dates està limitat a 14 dies.
Paràmetres de consulta
| Paràmetre | Tipus | Requerit | Descripció |
|---|---|---|---|
| start_date | YYYY-MM-DD | No | Inici del rang de dates (per defecte: avui) |
| end_date | YYYY-MM-DD | No | Fi del rang de dates (per defecte: avui + 13 dies) |
Exemple de resposta
{
"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/initiateCrea una intenció de reserva i retorna una URL de confirmació. L'usuari ha de visitar aquesta URL per autenticar-se i completar el pagament. Les reserves no es poden completar només a través de l'API.
Cos de la sol·licitud
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 resposta
{
"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."
}Informació important
Autenticació de l'usuari sempre requerida
Els assistents d'IA han de presentar la URL de confirmació a l'usuari. L'usuari sempre ha d'iniciar sessió i confirmar el pagament a LeyApp.
Límits de taxa
Disponibilitat: 10 sol·licituds/minut per IP. Inici de reserva: 5 sol·licituds/hora per IP.
Les intencions caduquen en 15 minuts
Els enllaços de confirmació de reserva caduquen als 15 minuts. Comprova sempre la disponibilitat abans de crear una nova intenció.
Els preus estan en cèntims d'EUR
Tots els imports estan en cèntims (ex. 12000 = 120,00 €). La moneda sempre és EUR.
Properament
Claus d'API i autenticació
Registre de desenvolupadors amb claus d'API per a límits de taxa més alts i seguiment d'ús.
Endpoint de cerca d'advocats
Cerca advocats per especialitat, ciutat, idioma i rang de preus a través de l'API.
Notificacions per webhooks
Rep notificacions en temps real quan les reserves es confirmin, cancel·lin o modifiquin.
Autenticació OAuth 2.1
Flux OAuth delegat per a socis d'IA de confiança per completar reserves en nom dels usuaris.
Necessites més informació o vols integrar l'API de LeyApp?