ZEITLICHT
Volver al índice

API e integraciones

Leer el registro de accesos de una clave de API

Quiero …

… ver para qué se usó una clave, desde dónde y si funcionó.

Antes de empezar

  • Solo Propietario y Admin ven las claves de API y sus registros de accesos, para todas las claves del espacio de trabajo.
  • El registro guarda las solicitudes 90 días y luego las borra.
  • Muestra las solicitudes con la clave correcta, también las rechazadas, por ejemplo después de revocar la clave. Los intentos con una clave incorrecta no aparecen.

Así se hace

  1. Abre Ajustes en el espacio de trabajo y luego Claves de API.
  2. Toca una clave. Se abre su página, con el nombre de la clave como título.
  3. Arriba ves el comienzo de la clave, Creada por … y su estado, como Activa, Caduca en 5 días, Inactiva, Caducada o Revocada, con el motivo si lo hay.
  4. Debajo están las fechas: Creada el …, Usada por última vez el … o Aún sin usar, y Caduca el …, Caducó el … o Revocada el ….
  5. Permisos muestra el nivel y cada permiso por separado. Tableros lista los tableros que la clave puede ver. Un tablero que ya no existe aparece como Tablero eliminado.
  6. Registro de accesos lista las solicitudes, las más recientes primero. Cada fila muestra la solicitud, como GET /tasks/3f2a9c1e o MCP tools/call get_task 3f2a9c1e, y una etiqueta con el código de estado de la respuesta. Una solicitud rechazada muestra además el motivo, como key-revoked.
  7. La línea de abajo indica la fecha y la hora, la dirección IP y el programa que envió la solicitud.
  8. Toca Cargar más al final de la lista para ver solicitudes más antiguas. Si la carga falla, toca Reintentar.
  9. Si una solicitud te parece extraña, toca Revocar clave y confirma con Revocar. La página sigue abierta y muestra la clave como Revocada.

El resultado

Sabes qué programa usó la clave, cuándo, desde qué dirección y con qué resultado.

Preguntas frecuentes

¿Qué significan los códigos de estado?

200 y 201 funcionaron. 401 significa que la clave fue rechazada: es incorrecta, caducó o fue revocada, o la persona que la creó ya no es admin. 403 significa que la clave no puede hacer eso: falta un permiso, la persona que la creó no tiene Ultra, el espacio de trabajo no tiene acceso a la API, o la solicitud necesita una clave para todos los tableros, como al crear una etiqueta o un tema (all-boards-required). 404 significa que la tarea o el tablero no existe o no está en los tableros de la clave. 409 significa que un ID corto encaja con varias tareas, o que una solicitud con la misma Idempotency-Key aún está en curso. 422 significa que se reutilizó una Idempotency-Key para otra solicitud. 429 significa demasiadas solicitudes en poco tiempo; el programa debe esperar y volver a intentarlo. Si un programa recibe 429 una y otra vez, el registro lo muestra más o menos una vez por minuto y clave, no cada solicitud rechazada.

Desactivé una cuenta o terminó un plan, pero la clave siguió funcionando.

Los cambios en la cuenta de quien creó la clave, como una cuenta desactivada o la pérdida de Ultra, pueden tardar hasta 30 segundos en detener la clave. Si esa persona deja de ser admin o sale del espacio de trabajo, la clave se detiene al instante.

¿Qué significa MCP?

La solicitud vino de Claude Code o de otra herramienta de IA conectada por MCP. El nombre después de tools/call, como get_task, es la herramienta que usó.

La clave está revocada, pero siguen llegando solicitudes. ¿Qué hago?

Algún programa todavía tiene la clave. Cada una de esas solicitudes se rechaza con 401 y key-revoked. Encuentra el programa por la dirección IP y el nombre del registro, y quita la clave allí.

¿Por qué está vacía la lista?

La clave no se usó en los últimos 90 días. La página dice Aún no hay solicitudes..

Temas relacionados