Skip to main content

​
Dónde obtener una clave

Las claves se crean y se revocan en el dashboard de Croma Legal en legal.usecroma.com, en Desarrolladores, pestaña Claves de API. La clave completa se muestra una sola vez al crearla, así que cópiala en un lugar seguro antes de salir de la página. Una organización puede tener hasta 5 claves activas; revoca las que ya no uses.

Crea una clave de API

Abre el dashboard de Croma Legal para generar y administrar las claves de tu organización.
La gestión de claves la habilita Croma por usuario (todos los miembros de la organización ven la configuración de MCP, pero solo los usuarios habilitados ven la pestaña Claves de API). Si la necesitas, pídesela a tu contacto en Croma.

​
Esquema bearer

Envía la clave en el encabezado Authorization usando el esquema Bearer, en cada solicitud:
La misma clave autentica la API REST y el servidor MCP: el uso y los límites de tasa se comparten entre ambos.

​
Solo claves con alcance de organización

Las claves se generan para una organización, no para un usuario individual, y cada solicitud queda limitada a esa organización: la API nunca acepta un id de organización del llamante. Una clave personal se rechaza con 401:

​
Formato de la clave

Las claves se emiten con la marca croma_<env>_…: croma_live_… en producción y croma_test_… en los demás entornos. Las claves de Legal solo funcionan contra api.legal.usecroma.com; una clave de la plataforma de datos públicos de Croma (platform.usecroma.com) se rechaza aquí, y viceversa.
Una clave otorga acceso de lectura a todo el portafolio de tu organización, incluidos los números de identificación de los demandados y los datos que hayas importado. Guárdala como un secreto (variable de entorno o gestor de secretos), nunca la incluyas en el control de versiones y revócala desde el dashboard apenas sospeches que quedó expuesta. La revocación es inmediata.

​
Autenticación fallida

Toda falla de autenticación devuelve 401 con un sobre authentication_error. El campo code indica qué salió mal:

Siguiente: Paginación y filtros

Cómo paginan las listas, qué significa cada fecha y cómo sincronizar de forma incremental.