Registro de auditoría de la organización
Consulta el registro de actividad de solo adición de la organización — quién hizo qué, y cuándo, en toda la organización.
El registro de auditoría es un registro de solo adición de acciones significativas realizadas dentro de la organización: rotaciones de claves, cambios de miembros, ediciones de enrutamiento y más. Estos endpoints alimentan la pantalla de auditoría del Dashboard.
Las entradas nunca se editan ni se eliminan, lo que es lo que hace que el registro sea confiable para el cumplimiento normativo y la revisión de incidentes. Filtra por actor, acción o ventana de tiempo para reconstruir exactamente lo que sucedió.
Estos endpoints alimentan la interfaz del Tokeflow Dashboard a nivel de organización. Están autenticados por sesión (JWT bearer) — el token proviene de iniciar sesión en el Dashboard, no de una clave de API sk_/pk_. Las solicitudes también llevan el header x-organization-id, y el usuario que inició sesión debe ser miembro de esa organización.
Endpoints
GET/api/v1/org/audit-trail
Auth: Dashboard session (JWT bearer). Se requiere membresía de la Organization.
Lista las entradas del registro de auditoría de la organización.
Parámetros de consulta
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
entity_type | string | No | Filtra por tipo de entidad (por ejemplo, merchant, merchant_connector, routing_profile, api_key) |
action | string | No | Filtra por acción (por ejemplo, created, updated, deleted, activated, deactivated) |
actor_id | string | No | Filtra por ID del actor (usuario o clave de API) |
merchant_id | string | No | Acota el registro de la organización a un solo merchant. El alcance de la organización se sigue aplicando, por lo que un merchant fuera de él no coincide con nada. |
start_date | string | No | Filtra desde esta fecha (formato ISO 8601) |
end_date | string | No | Filtra hasta esta fecha (formato ISO 8601) |
limit | number | No | Número de registros a devolver. Predeterminado 20, mín. 1, máx. 100. |
offset | number | No | Número de registros a omitir. Predeterminado 0, mín. 0. |
Ejemplo de solicitud
curl -G https://api.tokeflow.com/api/v1/org/audit-trail \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9…" \
-H "x-organization-id: org_4b21e7c3" \
--data-urlencode "entity_type=merchant_connector" \
--data-urlencode "action=created" \
--data-urlencode "actor_id=string" \
--data-urlencode "merchant_id=mrc_1"GET/api/v1/org/audit-trail/merchant
Auth: Dashboard session (JWT bearer). Se requiere membresía de la Organization.
Lista las entradas del registro de auditoría del merchant seleccionado.
Parámetros de consulta
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
entity_type | string | No | Filtra por tipo de entidad (por ejemplo, merchant, merchant_connector, routing_profile, api_key) |
action | string | No | Filtra por acción (por ejemplo, created, updated, deleted, activated, deactivated) |
actor_id | string | No | Filtra por ID del actor (usuario o clave de API) |
merchant_id | string | No | Acota el registro de la organización a un solo merchant. El alcance de la organización se sigue aplicando, por lo que un merchant fuera de él no coincide con nada. |
start_date | string | No | Filtra desde esta fecha (formato ISO 8601) |
end_date | string | No | Filtra hasta esta fecha (formato ISO 8601) |
limit | number | No | Número de registros a devolver. Predeterminado 20, mín. 1, máx. 100. |
offset | number | No | Número de registros a omitir. Predeterminado 0, mín. 0. |
Ejemplo de solicitud
curl -G https://api.tokeflow.com/api/v1/org/audit-trail/merchant \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9…" \
-H "x-organization-id: org_4b21e7c3" \
--data-urlencode "entity_type=merchant_connector" \
--data-urlencode "action=created" \
--data-urlencode "actor_id=string" \
--data-urlencode "merchant_id=mrc_1"Errores
Los errores usan el envoltorio estándar. Los casos más comunes aquí:
| HTTP | Significado |
|---|---|
400 | Parámetros inválidos o un estado que no permite esta operación. |
401 | Token de sesión del Dashboard ausente, expirado o inválido. |
403 | Autenticado, pero el usuario que inició sesión no tiene acceso a esta entidad. |
404 | El registro no existe o no es visible para esta entidad. |