Claves API

Las claves API les dan a las integraciones externas acceso programático a los datos de tu espacio de trabajo sin usar el inicio de sesión de ningún miembro. Solo para admin. Cada clave lleva una etiqueta legible por el admin (para qué es) y registra su fecha de creación + la marca de tiempo de último uso, así puedes detectar claves que ya no se usan.

Crear una clave

1. Haz clic en Crear clave en la parte superior de la página.
2. Ingresa una etiqueta descriptiva — ¿para qué es? Ejemplos: "Integración con Zapier", "Herramienta interna de reportes", "App móvil".

3. Haz clic en Crear. La clave se muestra una sola vez — cópiala de inmediato. No vas a verla de nuevo después de cerrar el banner.
4. Pega la clave en tu integración. Zellbox la acepta como Authorization: Bearer <clave> en cada endpoint que acepta autenticación con JWT.

Trata las claves como si fueran contraseñas. Cualquiera con la clave tiene el mismo acceso a los datos que el admin del espacio de trabajo. Rótala de inmediato si una clave se filtra.

Rotar una clave

No hay rotación en sitio. Para rotar:

1. Crea una clave nueva con el mismo propósito.
2. Actualiza tu integración con la clave nueva.
3. Una vez que confirmes que la integración funciona, elimina la clave vieja de la lista.

Eliminar una clave

1. Encuentra la clave en la lista.
2. Haz clic en Eliminar en su fila.
3. Confirma en el diálogo. La clave queda revocada al instante — cualquier petición en curso que la esté usando empezará a fallar con 401 en la siguiente llamada.