Obtener notificaciones del dashboard
GET/dashboard
Retorna un resumen de las notificaciones no leídas y las últimas notificaciones para el usuario autenticado.
Casos de uso:
- Mostrar contador de notificaciones no leídas en la UI
- Listar notificaciones recientes en el panel de usuario
- Sincronizar estado de notificaciones entre dispositivos
- Actualizar el estado de notificaciones en tiempo real
- Integración con sistemas de monitoreo empresarial
Flujo típico:
- El cliente llama a este endpoint al cargar el dashboard o cuando detecta cambios
- El servidor valida el token JWT y obtiene el ID de la compañía
- Consulta las notificaciones no leídas y las últimas 10 notificaciones
- Retorna el conteo de no leídas y el listado de notificaciones
- El cliente actualiza la UI mostrando el contador y la lista
Consideraciones:
- Las notificaciones se ordenan por fecha de creación descendente
- El límite máximo de notificaciones retornadas es 10
- Solo se incluyen notificaciones de la compañía del usuario
- El endpoint es cacheable por 60 segundos para optimización
Ejemplo de implementación:
// Ejemplo de llamada desde frontend
async function fetchDashboardNotifications() {
const response = await fetch('/company/notifications/dashboard', {
headers: {
'Authorization': `Bearer ${userToken}`
}
});
const data = await response.json();
updateNotificationBadge(data.unreadCount);
renderNotificationsList(data.lastNotifications);
}
Responses
- 200
- 401
- 404
Operación exitosa
No autorizado - Token JWT inválido o no proporcionado
Usuario o compañía no encontrada - El token no corresponde a un usuario válido