Qué es
Las API keys se administran en el back office de la empresa. Un administrador de esa empresa (o un superadmin) puede crearlas y revocarlas. Quien tiene rol Solo lectura puede ver la lista, pero no crear ni revocar. Tero no vuelve a mostrar el secreto. En la tabla queda el nombre, el prefijo (tero_live_xxxxxxxx…), el alcance, las fechas y el estado.
Dónde está
La ruta es Back office → Configuración → Equipo → API keys. Si no ves la entrada, desplegá el grupo Configuración en la barra lateral y abrí Equipo. Ahí está la pestaña API keys, junto a Empleados y Usuarios.Cómo se usa
1
Abrí API keys
Entrá a la empresa, desplegá Configuración → Equipo y tocá la pestaña API keys.
2
Creá la clave
Tocá Crear API key. Completá un nombre opcional (por ejemplo
Carga inicial), el alcance y, si querés, una fecha de vencimiento.3
Copiá la clave completa
Aparece un diálogo Copiá la API key ahora. Tocá Copiar y guardala en un lugar seguro. Es la única vez que se muestra.
4
Revocala cuando corresponda
En la fila activa, tocá Revocar y confirmá. Las llamadas siguientes responden
api_key_revoked.Configuración
- Nombre: etiqueta para reconocer el uso. No viaja en las llamadas.
- Alcance:
Solo lecturaoLectura y escritura. Ver Alcances. - Vencimiento: opcional. Si lo dejás vacío, la clave no vence. Al vencer, las llamadas responden
api_key_expired. - Creada por: correo de quien la generó.
- Último uso: se actualiza cuando la clave autentica una llamada.
Tips y advertencias
- Una clave revocada no se reactiva.
- No compartas la misma clave entre equipos que no deban verse. Creá una por integración.
- El superadmin puede administrar las claves de cualquier empresa desde el mismo menú, con esa empresa seleccionada.
Relacionado
Autenticación
Cómo enviar la clave a pos-api.
Usuarios del back office
Quién puede crear claves.
Ejemplos
Tareas habituales con curl.