Skip to main content
Logs da API são o extrato da integração: cada chamada HTTP fica registrada com request, response e status. Quando algo quebra, você vê exatamente o que entrou e o que a API respondeu.

​
O que são logs da API?

É o histórico de todas as chamadas feitas à API no seu workspace: método, endpoint, body enviado, resposta e código HTTP. Pense no extrato do cartão: não mostra se a mensagem chegou ao cliente, mas mostra cada transação entre seu sistema e a Notifique.

​
Para que serve?

Com logs você pode:
  • Debugar erros 401, 403 ou 400 na integração
  • Auditar qual API Key gerou cada chamada
  • Ver request e response exatos (com dados sensíveis mascarados)
  • Filtrar por status, método, data ou chave
  • Cruzar com Respostas de erro para entender o code retornado

​
Logs vs webhooks

São complementares, não substitutos:
Webhook avisa o que aconteceu com uma mensagem (entregue, falhou, lida). Log da API registra quem chamou a API e o que a API respondeu na hora da requisição.

​
Como consultar

​
No painel

  1. Abra Logs no menu lateral (ou pelo Developer Hub)
  2. Escolha o workspace (se tiver mais de um)
  3. Filtre por status, método ou data
  4. Clique em um item para ver request e response completos

​
Via API

​
1. Permissão

A chave precisa do escopo logs:read. Os logs ficam restritos ao workspace da chave.

​
2. Listar logs

Retorna histórico paginado do workspace.
Resposta paginada (pagination.total, pagination.page, pagination.limit, pagination.totalPages). Cada item inclui:

​
3. Filtrar resultados

Exemplo filtrando erros 403 em POST:
Tokens e dados sensíveis nos logs aparecem como [REDACTED] antes de salvar. Veja Segurança e Confiabilidade.

​
Próximos passos