Trifaco API
Claves de API

Revocar clave

POST/v1/api-keys/{id}/revocation

Estado: implementada. Ambientes: simulation, qualification. Permisos: keys:write.

Alcance: Requiere If-Match e idempotencia. La repetición autorizada devuelve el resultado anterior antes de comprobar otra vez la versión.

Revocar clave

Authorization

ClientApiKey
X-API-Key<token>

Secreto ligado a empresa, actor, permisos y ambiente. No admite cambiar empresa por body/header.

In: header

Path Parameters

id*string

Identificador opaco. No autoriza acceso por sí mismo.

Formatuuid
Length1 <= length <= 36

Header Parameters

Idempotency-Key*string

Obligatoria en mutaciones. Alcance: empresa/ambiente/operación/recurso destino. Retención mínima 90 días y mientras haya trabajo pendiente. Mismo contenido recupera resultado; contenido diferente produce 409.

Match^[A-Za-z0-9][A-Za-z0-9._:-]{7,127}$
Length1 <= length <= 128
If-Match*string

ETag de versión vigente. Replay idempotente se resuelve ANTES de revalidar If-Match; un comando nuevo con versión antigua produce 409 VERSION_CONFLICT.

Match^"[1-9][0-9]*"$
Length1 <= length <= 30

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/api-keys/497f6eca-6276-4993-bfeb-53cbbbba6f08/revocation" \  -H "Idempotency-Key: string" \  -H "If-Match: string" \  -H "Content-Type: application/json" \  -d '{    "reason": "string"  }'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "name": "string",  "actor_id": "04f37679-bfbf-4906-b749-01756515cecf",  "environment": "simulation",  "permissions": [    "company:read"  ],  "status": "active",  "created_at": "2019-08-24T14:15:22Z",  "expires_at": "2019-08-24T14:15:22Z",  "last_used_at": "2019-08-24T14:15:22Z",  "version": 1}

Consultar clave sin secreto GET

**Estado:** implementada. **Ambientes:** simulation, qualification. **Permisos:** `keys:write`. **Alcance:** Devuelve metadatos de una clave propia y su ETag, nunca el secreto. Requiere keys:write. Consultar clave sin secreto

Aportar evidencia sin verificarla automáticamente POST

**Estado:** parcial. **Ambientes:** simulation, qualification. **Permisos:** `company:write`. **Alcance:** Recibe evidencia cifrada en cuarentena, sin aprobarla automáticamente. Requiere custodia configurada; archivo de hasta 1 MiB y hasta 100 registros por empresa. Aportar evidencia sin verificarla automáticamente