---
title: "Claves de «API» para desarrolladores"
description: "Crea y gestiona claves de API para integrar los flujos de búsqueda, disponibilidad y reserva de LeyApp en tu propio producto."
source: https://staging.leyapp.es/help/developer-api-keys
locale: es
updated: 2026-07-25T12:00:00Z
---

# Claves de «API» para desarrolladores

Crea y gestiona claves de API para integrar los flujos de búsqueda, disponibilidad y reserva de LeyApp en tu propio producto.

_Fuente: https://staging.leyapp.es/help/developer-api-keys — Última actualización: 25 de julio de 2026_

> **Nota**
> Este artículo trata sobre las **claves de API** (leyk_...) para desarrolladores que utilizan el servicio REST de LeyApp API desde su propio software. Si solo quieres conectar un asistente de IA como Claude o ChatGPT a tu cuenta de LeyApp, no necesitas una clave de API; en ese caso, consulta «Connectar tu asistente de IA a LeyApp».

## ¿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.

> **Advertencia**
> La clave completa se muestra exactamente una vez, justo después de su creación. LeyApp solo almacena una huella digital de la misma, por lo que nunca podrá volver a mostrarse. Si pierdes una clave, revócala y crea una nueva.

## 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.

> **Consejo**
> Crea primero tu integración utilizando una clave de prueba. Cuando todo funcione, sustitúyela por una clave real; no es necesario realizar ningún cambio en el código, salvo el cambio de la propia clave.

## Claves del bufete

Si formas parte de un bufete de abogados en LeyApp, en «Panel de control» → «Desarrollador» aparecerán dos listas distintas: tus claves personales y las claves de tu bufete. Una clave de bufete pertenece al bufete, no a la persona que la creó, por lo que sigue funcionando aunque esa persona cambie de cargo o abandone el bufete.

Los propietarios y administradores pueden gestionar las claves de la empresa de inmediato. El resto de miembros no tienen ningún tipo de acceso inicialmente y se les debe conceder una autorización cada vez, desde la lista de miembros de la empresa:

- Ver: consulta las claves de la empresa, sus prefijos y cuándo se utilizó cada una por última vez. La clave en sí nunca se vuelve a mostrar a nadie, ni siquiera a los propietarios.
- Gestionar: crear, revocar, suspender y restringir las claves de la empresa.
- Webhooks: gestiona los puntos finales de webhooks de la empresa.

Las claves de la empresa están sujetas a dos controles adicionales. Puedes restringir una clave a una lista de direcciones IP o rangos, de modo que, aunque se filtre una clave, no se acepte desde ningún otro lugar. Además, puedes suspender una clave para dejarla inactiva sin eliminarla, lo cual resulta útil mientras investigas algún asunto extraño.

> **Nota**
> Cuando un miembro que ha creado claves de la empresa abandona la misma, dichas claves siguen funcionando y se envía un correo electrónico a los propietarios y administradores de la empresa para informarles de ello. Esto es intencionado: revocar las claves al abandonar la empresa provocaría que dejaran de funcionar todos los sistemas de la empresa que dependen de ellas. En su lugar, hay que sustituirlas: crear una clave nueva, transferir la integración a la nueva y, a continuación, revocar la antigua.

## 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.

No puedo levantar la suspensión de una de las claves de mi empresa.

Una clave puede ser suspendida por tu empresa o por LeyApp. Las suspensiones impuestas por tu propia empresa pueden ser levantadas por cualquier propietario o administrador. Una suspensión impuesta por LeyApp —por ejemplo, mientras investigamos un tráfico inusual— solo puede ser levantada por nosotros, así que ponte en contacto con support@leyapp.es.

> **Nota**
> En el portal para desarrolladores, en leyapp.es/developers, encontrarás la documentación completa sobre los puntos finales, ejemplos de solicitudes y respuestas, y guías de integración.