Tokens de API¶
Un token de acceso personal permite que un script, un trabajo de CI o cualquier integración llame a la API REST de Empi en su nombre. Ve exactamente lo que usted ve y puede cambiar exactamente lo que usted puede cambiar.
Crear un token¶
- Abra Settings > API.
- Haga clic en Create token.
- Póngale un Name (por ejemplo "CI pipeline") para reconocerlo más tarde.
- Elija sus Permissions: Read-only (solo peticiones GET) o Read & write (leer y modificar datos).
- Elija una Expiration: 7 días, 30 días, 90 días, 1 año, o sin caducidad.
- Haga clic en Create y luego copie el secreto.
Warning
El secreto se muestra una sola vez, en el momento de la creación. Concede acceso a todo su espacio de trabajo, así que guárdelo como una contraseña (un gestor de secretos, el almacén de secretos de su CI) y nunca lo pegue en un documento compartido ni en un repositorio público. Si un token se filtra, revóquelo de inmediato: la revocación surte efecto al instante.
Cada fila de token muestra cuándo caduca y cuándo se usó por última vez, de modo que puede detectar alguno que olvidó.
Usar un token¶
Envíelo como un token bearer en sus peticiones a la API. La lista completa de endpoints, sus parámetros y sus respuestas está en la referencia de la API.
Revocar un token¶
Haga clic en Revoke en la fila del token y confirme. El token deja de funcionar de inmediato y no se puede restaurar. Cree uno nuevo si aún necesita acceso.
Las llamadas hechas con un token se atribuyen a la API en su registro de actividad.
Tip
Si su objetivo es dejar que un asistente de IA trabaje con sus tareas, no necesita ningún token en absoluto. Use en su lugar el servidor MCP: inicia sesión a través de su navegador y puede desconectarlo en cualquier momento.