Trifaco API
Claves de API

Listar claves sin secretos

GET/v1/api-keys

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

Authorization

ClientApiKey
X-API-Key<token>

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

In: header

Query Parameters

cursor?string

Opaco y ligado a filtros/empresa/ambiente; caduca en 24 h. CURSOR_EXPIRED exige reiniciar listado.

Length1 <= length <= 2048
limit?integer
Range1 <= value <= 100
Default50

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/api-keys"
{  "items": [],  "next_cursor": "string",  "as_of": "2019-08-24T14:15:22Z"}

Configurar destinatarios y entrega PUT

**Estado:** parcial. **Ambientes:** simulation, qualification. **Permisos:** `company:write`. **Alcance:** Requiere company:write y documents:deliver, If-Match, Idempotency-Key y razón. Uno a cinco destinatarios automáticos separados del correo fiscal; nuevas revisiones congelan configuración. Solo ensayo local. Requiere además documents:deliver. Canal local o SES optativo en habilitación. Guardar configuración no demuestra verificación de identidad ni entrega.

Crear clave de integración POST

**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.