Tokens de acceso personal
Un token de acceso personal (a veces llamado clave de API) permite que tus propias herramientas accedan a tus datos de Kombine a través de la API: un script, un alias de la terminal, un agente de IA como Claude Code o un importador desde Jira. Tú decides a qué puede acceder cada token y cuánto tiempo dura, y puedes revocarlo en cualquier momento.
Los tokens son para tus propias herramientas. No pegues uno en un servicio de terceros que no controles.
Crear un token
Sección titulada «Crear un token»Los tokens se crean en la app web. Necesitas una cuenta con el correo verificado.
- En app.kombine.dev, ve a Ajustes › Cuenta y busca Tokens de acceso personal.
- Haz clic en Nuevo token.
- Ponle un Nombre (para qué es, p. ej. “Importación de Jira”) y, si quieres, una Descripción.
- Elige cuándo Caduca en: 7, 30, 90 o 365 días. Por defecto son 30. Los tokens siempre caducan.
- Configura los Permisos (mira abajo). Dale solo lo que la herramienta necesita.
- Introduce tu Contraseña actual y haz clic en Crear token.
- Copia tu token ahora. Empieza por
kmb_pat_y solo se muestra una vez. Kombine guarda únicamente una huella del token, así que no puede volver a mostrarlo. ¿Lo has perdido? Revócalo y crea uno nuevo.
Puedes tener hasta 10 tokens activos.
Permisos
Sección titulada «Permisos»Cada token tiene un nivel por área: Ninguno, Lectura o Lectura y escritura. Un token con todo en Ninguno no puede hacer nada.
| Área | Qué incluye | Niveles |
|---|---|---|
| tasks | Tareas, incluidas las importadas | Lectura / Lectura y escritura |
| goals | Objetivos de cada periodo y notas del periodo | Lectura / Lectura y escritura |
| sessions | Sesiones de concentración, entradas del registro y actividades | Lectura / Lectura y escritura |
| timer | El temporizador en curso y sus ajustes | Lectura / Lectura y escritura |
| stats | Estadísticas y resúmenes diarios | Lectura |
Hay cosas a las que nunca se puede acceder con un token, tenga los permisos que tenga: el inicio de sesión, tu contraseña y tu cuenta, los dispositivos, los ajustes de la app y la sincronización. Un token no puede cambiar tu contraseña ni eliminar tu cuenta.
Leer un área es cualquier GET. Todo lo demás (crear, cambiar, eliminar) necesita Lectura y escritura.
Ver y revocar tokens
Sección titulada «Ver y revocar tokens»Ve a Ajustes › Cuenta › Tokens de acceso personal para ver tus tokens y Revocar alguno. No puedes crear tokens en la app; para eso usa la app web.
Ve a Ajustes › Cuenta › Tokens de acceso personal para ver tus tokens y Revocar alguno. No puedes crear tokens en la app; para eso usa la app web.
Ajustes › Cuenta › Tokens de acceso personal muestra todos los tokens con sus permisos, cuándo caducan, cuándo se crearon y cuándo se usaron por última vez. Haz clic en Revocar en uno, o en Revocar todos.
La revocación es inmediata: la siguiente petición con ese token falla.
Cerrar sesión, cerrar sesión en todas partes y cambiar o restablecer tu contraseña no revocan los tokens. Solo los revoca revocarlos, que caduquen o eliminar tu cuenta. Si crees que se ha filtrado un token, revócalo.
Mantén tus tokens seguros
Sección titulada «Mantén tus tokens seguros»- Trata un token como una contraseña. Guárdalo en una variable de entorno o en tu gestor de contraseñas, nunca en código que subas a un repositorio.
- Un token por herramienta. Así, revocar uno no rompe los demás, y último uso te dice qué herramienta está activa.
- Caducidad corta para experimentos, más larga para las herramientas de las que dependes.