Ir al contenido

Autenticación

Cómo autenticar las llamadas a la API pública con una clave de API.

Cada llamada a /api/public/v1/* necesita una clave de API (kn_…). Créala desde el menú de tu avatar → Claves de API → Nueva clave de API. Se muestra una sola vez.

En cualquiera de estas cabeceras:

X-API-Key: kn_...
Authorization: Bearer kn_...

Si llegan las dos, gana X-API-Key.

Ventana de terminal
curl https://<tu-kana>/api/public/v1/projects \
-H "X-API-Key: $KANA_API_KEY"
Personal
puede lo mismo que quien la creó; si esa persona queda inactiva, deja de autenticar.
Con alcance
cada endpoint exige un permiso; sin él, 403.
Por proyectos
si los eliges, solo ve esos proyectos.
Sin datos sensibles por defecto
llegan como identifier_hash. En claro exigen el permiso en el proyecto y la opción Incluir datos sensibles.
  • Una clave por integración, de solo lectura, con proyectos limitados y vencimiento.
  • Si se filtra, revócala en Claves de API y crea otra.