Dispositivos y tokens de API

En Mis dispositivos gestionas lo que puede entrar en tu cuenta sin pasar por el navegador.

Dispositivos móviles

Cada sesión activa de la app móvil aparece con su nombre, cuándo se conectó y su último uso. Si pierdes un móvil, pulsa Revocar acceso: tendrá que iniciar sesión de nuevo. Un dispositivo que lleva más de 90 días sin usarse se desconecta solo.

Crear un token de API

Un token sirve para integraciones y scripts (se envía en la cabecera Authorization: Bearer). Para crearlo:

1. Ponle un nombre que explique para qué es (por ejemplo, «Panel de Grafana»).
2. Elige el permiso: Acceso completo o Solo lectura. Un token de solo lectura únicamente puede consultar datos.
3. Elige la caducidad: sin caducidad, 30 días, 90 días o 1 año.
4. Opcionalmente, limítalo a ciertas áreas. Si no marcas ninguna, accede a todas.
5. Pulsa Crear token y cópialo en ese momento: no se vuelve a mostrar.

Los tokens sin caducidad se desactivan solo por inactividad. Guarda cada token como una contraseña.

Limitar desde dónde se puede usar un token

Al crear el token puedes añadir dos restricciones opcionales (sepáralas con comas o saltos de línea):

• Direcciones IP permitidas (por ejemplo 203.0.113.7, 10.0.0.0/24): el token solo funciona desde esas direcciones. Útil para servidores con IP fija. Desde otra IP, la API responde 403.
• Orígenes web permitidos (CORS) (por ejemplo https://panel.ejemplo.com): permiten usar el token desde una página web concreta. Sin orígenes, el navegador no puede llamar a la API con ese token (los scripts de servidor no se ven afectados).

Un token comprometido con estas restricciones es mucho menos útil para quien lo robe. Para saber si la API está viva, GET /api/v1/health responde sin necesidad de token.

Para desarrolladores

La documentación de la API, con un explorador interactivo, está en https://app.guildawork.com/docs/.