Bitácora de acciones de negocio (no de peticiones HTTP crudas). Cada fila registra una acción
(action) hecha por una cuenta sobre un modelo concreto, con el detalle en payload. Es la
fuente de las relaciones logs / allLogs que exponen casi todos los modelos.
Vive en la conexión metrics y es de sólo lectura (endpoints api-logs); account y
related se resuelven contra la conexión principal. Filtrando por related_model +
related_id se obtiene el historial de un registro concreto.
| Atributo | Tipo | Descripción |
|---|---|---|
id |
int |
|
account_id |
int |
ID de la cuenta que ejecutó la acción. |
type |
string |
Tipo de actor de la cuenta (por ejemplo admin, client, provider). |
role |
string |
Rol con el que se ejecutó la acción. |
action |
string |
Acción registrada (por ejemplo create, update, delete o una acción de negocio). |
related_model |
string |
Clase del modelo afectado (relación polimórfica related). |
related_id |
int |
ID del modelo afectado. |
payload |
array |
Detalle de la acción (cambios, parámetros, contexto). |
created_at |
datetime\|null |
Fecha de la acción. |
updated_at |
string\|null |
Sin uso real (el modelo no gestiona timestamps). |
account |
Account\|null |
Cuenta que ejecutó la acción. |
allLogs |
Collection<int, ApiLog> |
Registros de auditoría de la API, incluidos los internos. |
logs |
Collection<int, ApiLog> |
Registros de auditoría de la API visibles. |
related |
Model\|Eloquent |
Modelo afectado por la acción. |
{
"id": 17647914,
"account_id": 1,
"type": "admin",
"role": "super_admin",
"action": "updated",
"related_model": "App\Currency",
"related_id": 730,
"payload": {
"id": 730,
"conversion_factor": 966.78,
"updated_at": "2025-09-10T04:45:10.000000Z"
},
"created_at": "2025-09-10 04:45:10",
"updated_at": "2025-09-10 04:45:10"
}
{info} Soporta: Paginación Filters Carga dinámica
Listar registros de auditoría
Devuelve los ApiLog (acciones de negocio), paginados. Pasando related_model +
related_id se obtiene el historial de un registro concreto.
| Método | URI | Cabeceras |
|---|---|---|
| GET | /api-logs |
Authorization |
{info} Soporta: Carga dinámica
Ver un registro de auditoría
Devuelve el ApiLog indicado con el detalle de la acción en payload.
| Método | URI | Cabeceras |
|---|---|---|
| GET | /api-logs/{apiLogId} |
Authorization |