En esta sección3 artículos
Crear y revocar un token
Crea un token personal de la API en Ajustes → API, cópialo una vez y revócalo allí cuando una app ya no lo necesite.
Necesitas el plan Label para crear un token. Consulta Acceso a la API en el plan Label. Crea y revoca tokens con la sesión iniciada en la app: un token no puede crear ni revocar otros tokens.
Crear un token
- Comprueba que está activo el espacio de trabajo correcto. El token lee los datos del espacio de trabajo en el que estás ahora.
- Abre Ajustes → API y selecciona Nuevo token.
- Escribe un Nombre del token que te diga dónde lo usas, por ejemplo «Pipeline de CI». Selecciona Crear token.
- Selecciona Copiar token y guárdalo en un lugar seguro, como un gestor de contraseñas o los ajustes secretos de tu app.
- Selecciona Ya lo guardé.
Ver tus tokens
Ajustes → API lista tus tokens activos del espacio de trabajo actual con su nombre, el inicio del token, cuándo lo creaste y su Último uso. Nunca significa que aún no se usó en ninguna solicitud.
Revocar un token
- En Ajustes → API, busca el token en la lista. En la web, selecciona el icono de la papelera que está a su lado. En las apps, selecciona Revocar.
- En ¿Revocar este token?, selecciona Revocar token.
Cualquier app que use el token deja de funcionar al instante. No se puede deshacer. Al revocar se libera un hueco, así que puedes crear un token nuevo.
En las apps de iPhone y Android
Ajustes → API funciona igual en las apps. El campo Nombre del token y Crear token están siempre en la página, el token nuevo aparece en Tu token nuevo y cada token de la lista tiene un botón Revocar.
Preguntas
Perdí mi token de la API. ¿Puedo volver a verlo?
No. Mostramos el token completo una sola vez. Revoca el token perdido en Ajustes → API y crea uno nuevo.
¿Cerrar sesión revoca mis tokens de la API?
No. Cerrar sesión termina tus sesiones en la app, pero los tokens siguen funcionando hasta que los revocas. Dejar un espacio de trabajo, que te quiten de él o borrar tu cuenta anula sus tokens.
¿Por qué no puedo crear otro token?
Puedes tener 5 tokens activos. Revoca uno que ya no uses y luego crea el nuevo.