Pular para o conteúdo
NovoVeja como

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.

Tutoriais
Desenvolvedor e CLI
min de leitura
6 min
etapas
6 · Intermediário

  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.

    Leia a aba Uso

  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 status que não sejam 2xx, leia o errorCode, e associe o keyPrefix à chave causando o problema. Cite o requestId ao 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

  • 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.

Desenvolvedor e CLI

Prospecção que continua quando você desconecta.Leads, emails, follow-ups e respostas, resolvidos.

Conecte caixas ilimitadas e deixe os agentes de IA encontrarem leads, escreverem cada email e fazerem follow-up. Ou envie seus próprios modelos no modo manual. A partir de $29/mês.

Comece seu teste de $1 Ver preços

$1 por 3 dias · Cancele quando quiser · Sem contrato

Instalar com IA

Seu agente de código configura a CLI e as skills do FirstSales para você.

Prompt para Claude Code

I'm setting up FirstSales (https://firstsales.io), an AI outbound sales platform: campaigns, contacts, a reply inbox, deliverability and lead signals. Help me get my workspace sending real, good emails end to end, from Claude Code.

Read these first so you know how FirstSales works:
- Developer docs and API: https://developer.firstsales.io
- CLI: https://www.npmjs.com/package/@firstsales.io/cli
- Skills for coding agents: https://github.com/firstsalesio/firstsales-skills (read README.md and GUIDE.md)

Setup
1. Install the CLI: npm install -g @firstsales.io/cli
2. Install the FirstSales skills:
   claude plugin marketplace add firstsalesio/firstsales-skills
   claude plugin install firstsales@firstsales
3. Ask me if I already have a FirstSales account. If not, send me to https://app.firstsales.io to sign up.
4. Ask me to create an API key under Settings → API → API Keys, with only the scopes we need.
   Never ask me to paste the key into this chat. Tell me to run this in my own terminal, so the key stays hidden:
   read -rs FS_KEY && firstsales auth login --api-key "$FS_KEY"; unset FS_KEY
5. Run `firstsales whoami` and tell me which workspace and organisation we are connected to.

Then ask me about my business: what I sell, who I sell to (roles, company size, countries), my best customers, and what I use today for outbound (tools, lists, mailboxes). Walk me through:
1. Teaching FirstSales my business: website, offer, proof points and case studies in the knowledge base, so the AI writes like someone who knows the product.
2. Connecting my sending mailboxes and checking my sending domain: SPF, DKIM, DMARC and warm-up. If anything is unhealthy, tell me the exact DNS record to add.
3. Bringing in contacts: import my CSV or CRM export into a clean list, remove duplicates and bad emails, and block domains I must never email (customers, competitors, my own).
4. Building my first campaign: the right list, senders, steps and timing. Write the sequence with me, show me the drafts, and do not launch until I say yes.
5. Setting up Signals if it fits: find people engaging with LinkedIn posts about topics my buyers care about, and turn them into leads.
6. Inviting my team and giving each person the right access.

Once campaigns run, show me how to work the reply inbox from here: which replies need an answer, draft responses in my voice, and move good conversations into deals. If I use Cal.com, connect it so follow-ups can offer my booking link (not the first email).

Throughout, as you learn about my business, proactively suggest and help create:
- Reply templates for the questions and objections my prospects are likely to raise, based on my product, site and codebase if you can see them.
- Campaign ideas and segments worth testing, with the reason for each.

Safety rules:
- Show every change as a dry run (--dry-run) first and wait for my yes. Never send emails, launch campaigns or delete anything without my yes.
- Tell me before anything that spends credits, and how many.

Be opinionated. If the docs give a sensible default, just use it. Don't make me choose between five options.
Developer docs ↗npm: @firstsales.io/cli ↗GitHub: firstsales-skills ↗