Documentacion API - Acceso a logs

Esta documentación cubre los puntos finales para la gestión del registro de logs de cada smart locker.

1. Acceso a logs

Endpoint: GET /logs/:idlocker?createdAt=:date

Descripción: Obtiene el registro de logs de un locker específico, filtrando por la fecha solicitada.

Request Headers:

  • Authorization: Bearer token

Request Parameters:

  • idlocker: El ID único del smart locker del cual se obtendrán los logs.
  • createdAt: La fecha para filtrar los logs en formato YYYY-MM-DD (ejemplo: 2025-03-24).

Response:

                    
[
    {
        "_id": "67e18a0cf7c396563eb00aae",
        "lockerId": "67192c524b32c8c835cbd742",
        "event": " Inicio de sesion ",
        "detail": "inicio de sesion",
        "createdAt": "2025-03-24T10:36:28.000Z",
        "updatedAt": "2025-03-24T10:36:28.000Z",
        "__v": 0
    },
    {
        "_id": "67e18fa5f7c396563eb00af8",
        "lockerId": "67192c524b32c8c835cbd742",
        "event": " Inicio de sesion ",
        "detail": "inicio de sesion",
        "createdAt": "2025-03-24T11:00:21.000Z",
        "updatedAt": "2025-03-24T11:00:21.000Z",
        "__v": 0
    }
]
                    
                

Ejemplo de solicitud:

                    
curl -X GET 'https://api-lockers.unitsmartlabs.com/api/v1/logs?lockerId=67192c524b32c8c835cbd742&createdAt=2025-03-24' \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
                    
                

Códigos de respuesta:

  • 200 OK: La solicitud se completó exitosamente.
  • 400 Bad Request: Error en los parámetros de la solicitud.
  • 401 Unauthorized: Token de autenticación inválido o expirado.
  • 404 Not Found: No se encontraron logs para el locker o la fecha especificada.
  • 500 Internal Server Error: Error interno del servidor.