Skip to main content
La API se autentica con claves API del espacio de trabajo enviadas como bearer tokens.

​
Envía tu clave

Incluye la clave en el encabezado Authorization de cada solicitud:
Las claves empiezan con el prefijo failfast_. Una clave ausente, inválida, expirada o deshabilitada devuelve 401 con la envoltura de error estándar.

​
Obtén una clave

Las claves API se crean en la aplicación: abre Configuración → Espacio de Trabajo → Claves API y elige Nueva clave API. El valor de la clave se muestra una sola vez al crearla: cópialo de inmediato y guárdalo de forma segura. Consulta Claves API para ver el flujo completo. A las claves se les puede asignar una fecha de expiración, deshabilitarlas y eliminarlas. Eliminar una clave la revoca de inmediato.
Trata las claves API como contraseñas. Cualquiera que tenga la clave puede leer y modificar los datos del espacio de trabajo con los permisos del miembro al que pertenece. Nunca subas claves a repositorios de código ni las compartas en texto plano.

​
Alcance de espacio de trabajo y permisos

Cada clave está ligada a un espacio de trabajo y al miembro que la creó:
  • Las solicitudes solo ven los datos de ese espacio de trabajo.
  • Aplican el rol y los permisos de registro de ese miembro: una clave no puede leer ni modificar entidades que su miembro no puede.

​
Límites de tasa

Las solicitudes tienen un límite de tasa por clave: por defecto, 1.000 solicitudes por hora. Cada respuesta incluye el estado actual: Cuando se supera el límite, las solicitudes devuelven 429 hasta que la ventana se reinicia.