Trifaco API
Claves de API

Crear clave de integración

POST/v1/api-keys

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

Alcance: Crea una clave para un actor existente sin ampliar los permisos efectivos del solicitante ni del destinatario. Máximo 20 claves activas; el secreto se entrega una sola vez. Repetir la creación devuelve 409 SECRET_ALREADY_DELIVERED.

Muestra el secreto solo una vez. Replay devuelve 409 SECRET_ALREADY_DELIVERED con la referencia del recurso; no crea otra clave. Recuperar metadatos y revocar/crear si se perdió el secreto.

Authorization

ClientApiKey
X-API-Key<token>

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

In: header

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Permisos concedidos no superan la intersección de credencial llamante, actor creador y actor destino; nunca otorga permisos internos. keys:write por sí solo no permite escalar privilegios.

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" \  -H "Idempotency-Key: string" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "actor_id": "04f37679-bfbf-4906-b749-01756515cecf",    "permissions": [      "company:read"    ]  }'
{  "key": {    "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  },  "secret": "string"}

Listar claves sin secretos GET

**Estado:** implementada. **Ambientes:** simulation, qualification. **Permisos:** `keys:write`. **Alcance:** Lista metadatos de claves propias con paginación por cursor y estado calculado activo, revocado o vencido; nunca devuelve secretos ni huellas. Listar claves sin secretos

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