Api keys
Crea las llaves con las que tu backend llama a kiban y elige qué herramientas abre cada una.
Una api key es la llave con la que tu backend llama a kiban. Cada llave abre sólo las herramientas que le asignes: si una llave es de workfloo, con ella no se puede consultar link.
Las encuentras en Desarrolladores › Api keys. Recuerda confirmar primero si estás en Producción o en Sandbox: son dos listas distintas.
Crear una api key
- Elige el ambiente, Producción o Sandbox.
- Haz clic en Nueva api key.
- Ponle un nombre con el que la reconozcas después —por ejemplo backend de originación—. Es el nombre que vas a ver cuando tengas diez llaves y necesites saber cuál es cuál.
- Marca las herramientas que abre. Hay que elegir al menos una, y la llave no va a abrir nada más que eso.
- Guarda.
La llave se muestra una sola vez:Al terminar el alta aparece el valor de la llave con el aviso de copiarla en ese momento. No se vuelve a mostrar y no hay forma de recuperarla después: no se guarda en claro de nuestro lado. Si la pierdes, elimina esa llave y crea una nueva.
Guárdala en el gestor de secretos de tu backend, no en el código ni en un chat.
Qué ves en la lista
| Columna | Qué muestra |
|---|---|
| Nombre | El que le pusiste al crearla |
| Herramientas | Las que abre esa llave |
| Creada | La fecha de alta |
Cada renglón tiene Editar y Eliminar, según tus permisos.
Editar una api key
Puedes cambiarle el nombre y las herramientas que abre. El valor de la llave no cambia: tu backend sigue usando el mismo.
Quitarle una herramienta tiene efecto de inmediato — las llamadas a esa herramienta con esa llave empiezan a ser rechazadas—, así que revisa antes quién la está usando.
Eliminar una api key
Al eliminarla se te pide confirmar, porque las llamadas que la usen van a empezar a fallar. No hay un paso intermedio de desactivación: si quieres rotarla sin cortar el servicio, crea primero la llave nueva, cámbiala en tu backend y elimina la vieja al final.
Mensajes que te puedes encontrar
| Mensaje | Qué significa |
|---|---|
| Ya tienes una api key con ese nombre | Los nombres no se repiten dentro del mismo ambiente. Ponle otro |
| Elige al menos una herramienta | Una llave que no abre nada no sirve de nada |
Updated 5 days ago