API para Desarrolladores
LeyApp ofrece una API pública para consultar la disponibilidad de abogados e iniciar reservas de consultas. Diseñada para asistentes de IA, integraciones y herramientas de terceros.
Únete a la beta de la API de LeyApp
Regístrate para recibir acceso anticipado a claves de API, límites de tasa más altos y nuevos endpoints a medida que los lancemos.
Notificaremos a los desarrolladores cuando las claves de API estén disponibles.
Endpoints disponibles
/api/v1/lawyers/{lawyer_id}/availabilityDevuelve los horarios de consulta disponibles para un abogado específico. No requiere autenticación. El rango de fechas está limitado a 14 días.
Parámetros de consulta
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| start_date | YYYY-MM-DD | No | Fecha de inicio del rango (por defecto: hoy) |
| end_date | YYYY-MM-DD | No | Fecha de fin del rango (por defecto: hoy + 13 días) |
Ejemplo de respuesta
{
"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ón de reserva y devuelve una URL de confirmación. El usuario debe visitar esta URL para autenticarse y completar el pago. Las reservas no pueden completarse solo a través de la API.
Cuerpo de la solicitud
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"
}Ejemplo de respuesta
{
"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ón importante
Autenticación del usuario siempre requerida
Los asistentes de IA deben presentar la URL de confirmación al usuario. El usuario siempre debe iniciar sesión y confirmar el pago en LeyApp.
Límites de tasa
Disponibilidad: 10 solicitudes/minuto por IP. Inicio de reserva: 5 solicitudes/hora por IP.
Las intenciones expiran en 15 minutos
Los enlaces de confirmación de reserva caducan a los 15 minutos. Comprueba siempre la disponibilidad antes de crear una nueva intención.
Los precios están en céntimos de EUR
Todos los importes están en céntimos (ej. 12000 = 120,00 €). La moneda siempre es EUR.
Próximamente
Claves de API y autenticación
Registro de desarrollador con claves de API para límites de tasa más altos y rastreo de uso.
Endpoint de búsqueda de abogados
Busca abogados por especialidad, ciudad, idioma y rango de precios a través de la API.
Notificaciones por webhooks
Recibe notificaciones en tiempo real cuando se confirmen, cancelen o modifiquen reservas.
Autenticación OAuth 2.1
Flujo OAuth delegado para socios de IA de confianza para completar reservas en nombre de los usuarios.
¿Necesitas más información o quieres integrar la API de LeyApp?