Monitore chaves de API: logs e uso
Inspecione os logs de requisições da Developer API e as estatísticas de uso — contagem de requisições, taxas de erro e latência por chave e por rota — para depurar integrações e detectar abuso.
- 1
O que você pode monitorar
As requisições de cada chave de API de Desenvolvedor: contagens por chave e por rota, taxa de erro, latência e logs de requisições individuais com IDs de requisição.
- 2
Abra Configurações → API
A seção API tem três abas: Chaves de API, Logs e Uso. Essa seção é somente admin/proprietário — outras funções veem um aviso de que o gerenciamento de chaves é restrito.
- 3
Leia a aba Uso
Totais em uma janela móvel (padrão de 7 dias): total de requisições e taxa de erro geral, depois uma quebra por chave e por rota para você ver qual chave ou endpoint gera mais tráfego e erros.
- 4
Aprofunde-se na aba Logs
Cada linha de requisição mostra o método, o padrão de rota, o status HTTP, a latência (ms), o prefixo da chave que a fez, um código de erro (se houver) e um ID de requisição para suporte.
- 5
Depure uma integração com falha
Percorra os Logs procurando valores de
statusque não sejam 2xx, leia oerrorCode, e associe okeyPrefixà chave causando o problema. Cite orequestIdao contatar o suporte. - 6
Identifique abuso ou um script descontrolado
Um pico nas requisições de uma única chave na quebra por chave, ou uma taxa de erro crescente no Uso, é o sinal para revogar essa chave na aba Chaves de API e emitir uma nova com escopo adequado.
Dicas de especialista
Atalhos conquistados na prática que mantêm o aquecimento nos trilhos.
Comece em Uso, aprofunde-se em Logs
Use o Uso para ver a dimensão do problema — qual chave, qual rota, quão grave — depois vá para Logs para as requisições individuais com falha. De cima para baixo é mais rápido que rolar logs brutos.
O ID da requisição é o que o suporte precisa
Copie o ID da requisição de uma linha de log com falha em vez de descrever "um erro 500 mais cedo hoje" — é a forma mais rápida de conseguir ajuda.
Verifique escopos antes de culpar a API
Uma taxa de erro crescente em uma chave geralmente significa uma suposição expirada naquela integração (campo renomeado, escopo revogado) — verifique os escopos dessa chave primeiro.
Verifique a função antes de investigar acesso
Somente admins/proprietários veem essa seção; se um colega de equipe "não encontra os logs de API", verifique a função dele antes de supor que algo está quebrado.
Perguntas frequentes
O FirstSales expõe logs de requisições de API?
Sim — Configurações → API → Logs mostra por requisição o método, rota, status, latência, prefixo da chave, código de erro e um ID de requisição.
Onde vejo o quanto minhas chaves estão sendo usadas?
A aba Uso: total de requisições, taxa de erro e quebras por chave e por rota em uma janela móvel (7 dias por padrão).
Quem pode ver logs e uso da API?
Somente administradores e proprietários da organização. Outras funções veem um aviso de que o gerenciamento de chaves é restrito a admin/proprietário.
Como depuro uma chamada de API com falha?
Em Logs, encontre a requisição pelo status diferente de 2xx, leia seu errorCode, anote o keyPrefix e o requestId, e compartilhe esse ID com o suporte.
Uma chave parece comprometida — o que faço?
Revogue-a na aba Chaves de API e emita uma nova apenas com os escopos necessários; observe as contagens por chave em Uso para confirmar que o tráfego parou.
Posso mudar a janela de uso?
A visão de Uso é padronizada nos últimos 7 dias. Use a aba Logs (com seus filtros) para inspeção mais estreita, no nível de requisição.
Pronto para colocar isso em prática?
Comece seu teste do FirstSales e lance uma caixa de e-mail aquecida e autenticada em minutos.
Comece por $1