Claves de API de la organización
Conecta tus programas y automatizaciones con la misma API que usa UTILIA OS, con una clave que actúa con los permisos de una persona de tu equipo.
Actualizado el . 3 min de lectura
Incluido en todos los planes. Ver precios
Una clave de API de la organización deja que un programa de tu empresa (un script, un cuadro de mando o una automatización que corre en un servidor) trabaje con UTILIA OS por la misma API que usa la aplicación, en https://os.utilia.ai/api. La clave actúa en nombre de una persona responsable de tu equipo, con sus permisos y recortada a lo que marques al crearla, y todo lo que hace queda a nombre de esa persona.
La pantalla donde se crean, paso a paso, está en la guía Crear y gestionar claves de API.
Cuándo usar esta clave
Cada credencial de UTILIA OS abre su propia puerta. Esta es la que necesitas si el programa es de tu empresa y trabaja con los datos de tu organización:
¿Qué credencial necesitas?
¿Qué va a llamar a UTILIA OS?
Un programa de tu empresa:
Clave de API de la organización
Authorization: Bearer utk_…
La misma API que la aplicación, con los permisos de una persona. Es esta sección.Tu app, para tus usuarios:
Tu web, solo para leads:
Un asistente de IA:
Claude, ChatGPT o Cursor, con los permisos de quien lo conecta.
Si tu aplicación tiene que actuar en nombre de cada persona que la usa, con su propio consentimiento, lo tuyo es Iniciar sesión con UTILIA. La comparación completa de las credenciales está en Autenticación con clave de acceso.
Antes de empezar
- El aplicativo Integraciones en el plan. Si sale del plan, las claves dejan de funcionar (
403 MODULE_NOT_ENABLED), pero se siguen viendo y se pueden revocar. - El permiso «Gestionar las claves de API» para crearlas. Con «Ver las claves de API» solo se consultan. De partida, el Super Administrador tiene los dos y el Gerente, solo el de ver.
- Una persona responsable activa. De partida eres tú. Solo un Super Administrador puede poner una clave a nombre de otra persona.
- Un servidor donde guardarla. UTILIA OS rechaza la clave cuando la petición llega desde un navegador.
Crear la clave
En Ajustes, Claves de API, pulsa Nueva clave y, si te pregunta para qué la quieres, elige Acceso a la API. Le das un nombre, eliges los permisos y la caducidad y, en Opciones avanzadas, el límite de peticiones por hora. Si tienes la verificación en dos pasos, te pide el código antes de crearla.
Al pulsar Crear la clave ves el secreto entero una sola vez: utk_ seguido de 43 caracteres. Guárdalo en el gestor de secretos de tu servidor. UTILIA OS solo conserva su huella, y en la lista verás sus 12 primeros caracteres (utk_Ab12Cd34), que bastan para reconocerla.
De la clave a tu programa
Una clave pasa por cuatro momentos, y cada uno tiene su página en esta sección:
La vida de una clave
Los cupos de peticiones y dónde queda anotado lo que hace la clave están en Límites, uso y auditoría. Las rutas con las que la pantalla crea, cambia y revoca claves, para quien quiera automatizar esa gestión con la sesión de una persona, están en La API de gestión de claves.
Trátala como una contraseña
Una clave no pide la verificación en dos pasos: quien la tenga puede usarla. Guárdala en un gestor de secretos, nunca en el código de una web ni en un repositorio, y revócala en cuanto sospeches que se ha filtrado. Una clave sin caducidad vale hasta que la revoques.
Siguiente paso
Ponlo en práctica
Lo encontrarás en Claves de API. Para abrirlo, entra con tu cuenta de UTILIA OS.