Consultar alertas não lidos do usuário

GET

/v2/monitoring/alerts/unread-count

Devolve a quantidade de alertas de risco não lidos dos monitoramentos criados pelo usuário autenticado, e se algum deles tem módulo bloqueado; serve ao selo de notificações.

Diferente da listagem de monitoramentos, considera só os monitoramentos do próprio usuário, não os da empresa toda. unreadCount soma os alertas vigentes não lidos de todos esses monitoramentos, em qualquer status; alertas limpos ou de módulos desligados não contam. hasBlockedModules indica módulo indisponível, ou desligado sem permissão, no perfil de permissão do usuário.

A consulta também confere a permissão do usuário: se o perfil de permissão dele deixou de dar acesso a um módulo ligado, o módulo é desligado e a mudança entra no histórico. Se todos os módulos de um monitoramento SCHEDULED ou ACTIVE forem desligados, ele passa a INACTIVE, com motivo PERMISSION_REVOKED. Não recebe parâmetros.

Requer autenticação via Bearer JWT ou header x-api-key e a permissão de ver monitoramentos. Usuário sem perfil de permissão recebe 403 (Acesso negado); perfil inexistente, 401 (Permissão inválida!); perfil sem a permissão, 400 (Permissão não encontrada); usuário inativo, 404 (Usuário não encontrado).

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Header

Respostas

🟢200Sucesso

application/json

Alertas não lidos do usuário

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠400Sem permissão para ver monitoramentos

🟠403Acesso negado

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v2/monitoring/alerts/unread-count' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Com alertas não lidos

{
    "unreadCount": 5,
    "hasBlockedModules": false
}

Modificado em 2026-10-21 13:20:06

Página anterior

Pesquisar clientes para monitoramento

Próxima página

Calcular previsão de créditos de um monitoramento