Autenticación

Dónde obtener una llave

Crea y administra tus llaves de API en platform.usecroma.com. Inicia sesión, abre tu organización y genera una llave desde la sección de llaves de API. La llave completa se muestra una sola vez al crearla, así que cópiala en un lugar seguro antes de salir de la página.

Crea una llave de API

Abre la plataforma de Croma para generar y administrar las llaves de tu organización.

Esquema bearer

Envía tu llave en el encabezado Authorization usando el esquema Bearer:

Authorization: Bearer croma_live_xxxxxxxxxxxxxxxxxxxx

Solo llaves con alcance de organización

Las llaves de Croma se generan para una organización, no para un usuario individual. La API rechaza las llaves personales con 401:

{
  "error": {
    "type": "authentication_error",
    "code": "personal_api_key_not_allowed",
    "message": "Personal API keys are not allowed. Use an organization key."
  }
}

Esto mantiene el uso, los límites de tasa y la facturación atribuidos a la organización en lugar de a quien haya creado la llave.

Formato de la llave

Las llaves se emiten con la marca croma_<env>_…. Por ejemplo, croma_live_… en producción y croma_test_… en los demás entornos. El prefijo de entorno te indica de un vistazo a qué despliegue apunta una llave; nunca uses una llave test contra datos de producción ni viceversa.

Una llave otorga acceso completo a la API de su organización. Guárdala como un secreto (variable de entorno o gestor de secretos), nunca la incluyas en el control de versiones y rótala si queda expuesta.

Autenticación fallida

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

Código	Qué significa	Cómo resolverlo
`invalid_api_key`	El encabezado `Authorization` falta o está mal formado, o la llave fue revocada o expiró.	Envía una llave válida como `Authorization: Bearer <key>`, o emite una nueva.
`personal_api_key_not_allowed`	Se usó una llave personal donde solo se aceptan llaves de organización.	Usa una llave con alcance de organización desde platform.usecroma.com.

Siguiente: Límites de tasa

Cómo se agrupan los cupos y cómo se exponen en cada respuesta.

Primeros pasos

Colombia

Perú

Global

Dónde obtener una llave

Crea una llave de API

Esquema bearer

Solo llaves con alcance de organización

Formato de la llave

Autenticación fallida

Siguiente: Límites de tasa

​Dónde obtener una llave

Crea una llave de API

​Esquema bearer

​Solo llaves con alcance de organización

​Formato de la llave

​Autenticación fallida

Siguiente: Límites de tasa

Dónde obtener una llave

Esquema bearer

Solo llaves con alcance de organización

Formato de la llave

Autenticación fallida