Referencia: API keys
Formato de las API keys de un proyecto, cómo se crean, se listan y se revocan, y cómo se envían en el encabezado Authorization.
Formato de la clave
Las claves siguen la estructura qbly_<lookupId>_<secret>. Incorporan un prefijo constante, un identificador público de 6 bytes para ubicar el registro y un secreto criptográfico de 32 bytes para la autenticación. Qably almacena únicamente el hash SHA-256 y realiza comprobaciones en tiempo constante. El token en texto plano no puede recuperarse tras su emisión.
Crear, listar y revocar
| Acción | Endpoint | Rol requerido |
|---|---|---|
| Listar keys | GET /projects/:projectId/api-keys | Cualquier miembro de la organización |
| Crear una key | POST /projects/:projectId/api-keys (cuerpo: { "name": string }) | owner o admin |
| Revocar una key | POST /projects/:projectId/api-keys/:id/revoke | owner o admin |
Revocación y uso de las claves
Las claves revocadas permanecen archivadas en el sistema para conservar la trazabilidad de las ejecuciones históricas. Se envían en el encabezado Authorization: Bearer qbly_<lookupId>_<secret>.