ApiLog


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.

Estructura de Datos

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"
}

Endpoints

Listar ApiLog

{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

Mostrar ApiLog

{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

Relaciones