Uma chave de API permite que um programa aja em nome da sua conta. A ferramenta de linha de comando, a API REST, uma etapa no Zapier ou o seu próprio script usam uma. Apps de IA que aceitam login, como Claude e ChatGPT, não precisam de chave nenhuma.
Crie uma chave
Abra Configurações e escolha Chaves de API.
- Digite um nome no campo ao lado de Nova chave. Use o nome do lugar onde ela será usada, como "cli no meu notebook" ou "zapier".
- Clique em Criar chave.
- Copie a chave na hora. Ela começa com
ag_live_e aparece completa só uma vez. Depois, a lista mostra os primeiros caracteres, quando ela foi criada e quando foi usada pela última vez.
Guarde a chave num gerenciador de senhas ou nas configurações de segredos da sua ferramenta. Nunca a coloque num documento compartilhado, numa captura de tela ou num chat.
Use a chave
A ferramenta de linha de comando pede a chave uma vez, quando você roda npx argorant login, e a guarda no seu computador. Na API REST, você a envia num cabeçalho em cada requisição.
curl https://app.argorant.com/api/mcp/account \
-H "Authorization: Bearer ag_live_..."Essa primeira chamada mostra o seu plano e o seu saldo, o que é um bom jeito de confirmar que a chave funciona. Chaves de API e a API REST lista os principais endpoints, e a CLI do Argorant cobre a ferramenta de linha de comando.
Uma chave por ferramenta
Dê a cada ferramenta e a cada pessoa a sua própria chave. Assim você vê qual chave foi usada e quando, e consegue desligar uma sem quebrar todo o resto. As chaves compartilham os créditos da sua conta, então uma chave não vem com saldo próprio. Cada chave tem o seu próprio limite de velocidade, e as buscas têm limites diários durante o teste. Limites de requisições e cotas diárias traz os números de cada plano.
Troque e revogue
Para substituir uma chave, crie a nova primeiro, coloque-a na ferramenta, confira se funciona e só então clique em Revogar ao lado da antiga. A revogação vale na hora. A próxima requisição com a chave antiga é recusada.
Se uma chave for parar onde não deveria, como um repositório de código público ou uma tela compartilhada, revogue-a imediatamente e crie uma nova. Depois, olhe as suas exportações recentes para ver se rodou algo que você não iniciou. O que fazer se uma chave de API vazar tem o checklist completo.
Webhooks
Abaixo das chaves, você pode adicionar um webhook. O Argorant passa a chamar o seu endereço quando algo acontece, por exemplo quando uma exportação fica pronta, uma lista termina de ser preenchida, chega uma resposta ou uma campanha é pausada. Cole o endereço em Novo webhook, escolha os eventos e clique em Adicionar webhook. Cada chamada é assinada, para que o seu servidor possa confirmar que veio de nós. Webhooks mostra o que cada evento contém.
