Referencia
API keys
Emitir, listar y revocar las credenciales con las que se llama a todo lo demás.
Emitir, listar y revocar las credenciales con las que se llama a todo lo demás.
El capítulo que explica este recurso, con ejemplos ejecutables, está acá.
| Método | Ruta | Qué hace |
|---|---|---|
GET | /api-keys | List API keys |
POST | /api-keys | Create API key (returns plaintext secret once) |
DELETE | /api-keys/{id} | Revoke API key |
GET /api-keys
List API keys
curl https://api.vitrinadev.com/api/v1/api-keys \
-H "Authorization: Bearer $VITRINA_KEY"Responde: 200 · 400 · 401 · 403 · 404 · 409 · 429
POST /api-keys
Create API key (returns plaintext secret once)
Cuerpo
| Campo | Tipo | Obligatorio | Restricciones |
|---|---|---|---|
name | string | sí | mín. 1, máx. 120 |
tenant_id | uuid | — | |
scopes | ai_agents:read \ | ai_agents:write \ | ai_agents:simulate \ |
expires_at | string | — | date-time |
curl -X POST https://api.vitrinadev.com/api/v1/api-keys \
-H "Authorization: Bearer $VITRINA_KEY" \
-H "Content-Type: application/json" \
-d '{ … }'Responde: 201 · 400 · 401 · 403 · 404 · 409 · 429
DELETE /api-keys/{id}
Revoke API key
| Parámetro | En | Tipo | Obligatorio | Restricciones |
|---|---|---|---|---|
id | path | uuid | sí |
curl -X DELETE https://api.vitrinadev.com/api/v1/api-keys/<id> \
-H "Authorization: Bearer $VITRINA_KEY"Responde: 204 · 400 · 401 · 403 · 404 · 409 · 429