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.
Enviar la clave
Sección titulada «Enviar la clave»En cualquiera de estas cabeceras:
X-API-Key: kn_...Authorization: Bearer kn_...Si llegan las dos, gana X-API-Key.
curl https://<tu-kana>/api/public/v1/projects \ -H "X-API-Key: $KANA_API_KEY"Qué puede hacer una clave
Sección titulada «Qué puede hacer una clave»- 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.
Buenas prácticas
Sección titulada «Buenas prácticas»- 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.