Registros y operaciones de auditoría

Registros y operaciones de auditoría

Propósito: consultar el historial de operaciones para conocer las acciones del proveedor, la ejecución de trabajos y la resolución de problemas.

Flujo de interfaz de usuario

1. La interfaz de usuario carga los registros más recientes por cuenta.
2. El usuario filtra los registros por tarea/trabajo/correo electrónico/eventos de credenciales.
3. La interfaz de usuario expone la página de detalles del ámbito para cada registro.
4. La interfaz de usuario puede ejecutar una limpieza controlada de registros antiguos utilizando primero el ensayo de búsqueda y eliminación.

Flujo de la biblioteca del cliente

const logs = await api.logs.list(accountId, { limit: 50, offset: 0 });
const filtered = await api.logs.search(accountId, {
  query: "smtp_send_message",
  limit: 20,
});
if (filtered.data.length > 0) {
  await api.logs.get(filtered.data[0].id);
}

Flujo HTTP/curl

API_BASE_URL="https://api.inbox-manager.com"

curl -sS "${API_BASE_URL}/api/accounts/${ACCOUNT_ID}/logs?limit=20&offset=0" \
  -H "authorization: Bearer ${BEARER_TOKEN}"

curl -sS -X POST "${API_BASE_URL}/api/accounts/${ACCOUNT_ID}/logs/search" \
  -H "authorization: Bearer ${BEARER_TOKEN}" \
  -H "content-type: application/json" \
  --data '{"query":"imap_fetch_body","limit":20,"offset":0}'

curl -sS "${API_BASE_URL}/api/logs/${LOG_ID}" \
  -H "authorization: Bearer ${BEARER_TOKEN}"

curl -sS -X POST "${API_BASE_URL}/api/accounts/${ACCOUNT_ID}/logs/search-delete" \
  -H "authorization: Bearer ${BEARER_TOKEN}" \
  -H "content-type: application/json" \
  --data '{"query":"debug","dry_run":true,"limit":100,"older_than":"2026-01-01T00:00:00.000Z"}'

Notas

• Los registros tienen como ámbito la cuenta y la aplicación.
• La política de seguridad excluye el texto sin formato de credenciales de los registros.
• older_than es necesario para search-delete.