Saltar al contenido principal

Listar notificaciones no leídas

GET 

/notifications/unread

Propósito

Obtener solo notificaciones pendientes de lectura del usuario autenticado.

Objetivo

Reducir el payload del centro de notificaciones cuando la UI solo necesita pendientes.

Casos de uso

  • Panel “No leídas”.
  • Bandeja compacta en header.
  • Carga incremental de pendientes.

Detalles técnicos

  • Ruta protegida por userMiddleware.isLoged.
  • Query validada por validateNotificationQuery.
  • page default real: 1.
  • limit default real: 20 (máximo 100).
  • No tiene middleware de rate-limit en esta ruta, por lo que no aplica 429.
  • Respuesta de éxito en envelope tools.returnOK: { status, data, 0 }.

Autenticación

Requiere JWT (bearerAuth) o API key (apiKeyAuth).

Request

Responses

Notificaciones no leídas obtenidas correctamente.