Claves de «API» para desarrolladores

¿Qué es el desarrollador «API»?

LeyApp Ofrece una interfaz REST pública API en la ruta /api/v1 que te permite buscar abogados, consultar la disponibilidad e iniciar reservas desde tu propia página web, aplicación o herramienta interna. El acceso básico de lectura funciona sin necesidad de credenciales, pero una clave de API aumenta tus límites de solicitudes, desbloquea puntos de conexión adicionales y te proporciona un panel de control con tus claves y tu historial de uso.

Cualquier cuenta de LeyApp puede crear claves de API; no es necesario disponer de un tipo de cuenta especial. Las reservas iniciadas a través de API nunca se cobran automáticamente: el cliente siempre confirma y paga en leyapp.es, por lo que tu integración nunca gestiona dinero ni datos de tarjetas.

Creación de una clave «API»

Las claves se gestionan desde tu panel de control:

1. Abre «Panel de control» → «Desarrollador» en la barra lateral.
2. Haz clic en «Crear clave» y asígnale un nombre descriptivo, por ejemplo, «Widget del sitio web (producción)».
3. Elige el tipo de clave: «Live» para solicitudes reales o «Test» para probar con total seguridad.
4. Copia la clave inmediatamente y guárdala en un lugar seguro, como un gestor de contraseñas o el almacenamiento seguro de tu proveedor de alojamiento web.

Claves de prueba frente a claves en producción

Las claves de prueba (leyk_test_...) se comportan exactamente igual que las claves reales —mismos puntos finales, mismas respuestas, misma validación— con una diferencia fundamental: no ocurre nada en la realidad. Una solicitud de reserva de prueba se comprueba exhaustivamente con la disponibilidad real, pero no se crea ninguna intención de reserva ni se notifica a ningún abogado.

Las claves activas (leyk_...) generan intenciones de reserva reales. Cuando un cliente hace clic en el enlace de confirmación de una intención activa, se le redirige al proceso habitual de pago y confirmación de LeyApp.

Cómo utilizar tu llave

Envía la clave en el encabezado «Authorization» de cada solicitud: «Authorization: Bearer leyk_...». Las solicitudes sin clave siguen funcionando para los puntos finales públicos, pero con límites de frecuencia más bajos para usuarios anónimos.

Cada respuesta incluye un encabezado X-Request-Id. Si algo no funciona como esperabas, incluye ese ID cuando te pongas en contacto con el servicio de asistencia; así podremos localizar tu solicitud exacta en cuestión de segundos.

Límites de frecuencia

Las nuevas claves comienzan con el nivel gratuito: 60 solicitudes por minuto y 5.000 al día. Cada respuesta te indica cuál es tu situación mediante los encabezados X-RateLimit-Limit y X-RateLimit-Remaining; si superas el límite, recibirás una respuesta 429 con un encabezado Retry-After que te indicará cuándo volver a intentarlo.

Existen niveles superiores para socios, que concede el equipo de LeyApp. Ponte en contacto con nosotros a través del formulario de asistencia si tu integración necesita más margen.

Cómo guardar las llaves de forma segura

Una clave de API es una contraseña para tu integración. Trátala como tal:

• Nunca incluyas una clave en el código del lado del cliente, en aplicaciones móviles ni en repositorios públicos: cualquiera que pueda leerla podrá agotar tu límite de solicitudes y actuar dentro de los ámbitos de la clave.
• Utiliza una clave distinta para cada integración o entorno, de modo que puedas revocar una sin que ello afecte a las demás.
• Revoca las claves que ya no utilices. La revocación es inmediata: las solicitudes que utilicen una clave revocada fallarán en la siguiente llamada.
• Si crees que una clave puede haberse filtrado, revócala inmediatamente en Dashboard → Desarrollador y crea una nueva. La rotación no implica tiempo de inactividad: crea primero la nueva clave, impleméntala y, a continuación, revoca la antigua.

Solución de problemas

Me aparece el error 401 «Clave de API no válida».

Comprueba que el encabezado sea exactamente «Authorization: Bearer leyk_...», sin espacios adicionales, y que la clave no haya sido revocada. Ten en cuenta que los tokens MCP (ley_...) de «Configuración» → «Tokens de API» son una credencial diferente y no son válidos en el API REST.

Me aparece un error 429: «Límite de solicitudes superado».

Has alcanzado el límite por minuto o por día de tu nivel. Respeta el encabezado «Retry-After» y vuelve a intentarlo con un retroceso exponencial. Si alcanzas el límite diario con frecuencia, consúltanos sobre la posibilidad de pasar a un nivel superior.

Mis reservas de prueba nunca aparecen por ningún lado.

Es así a propósito: las claves de prueba validan todo, pero no crean nada. Cambia a una clave activa para crear intenciones de reserva reales.