Autenticação
Chaves de API, a URL base, o que cada escopo de chave permite e como os agentes de IA entram sem chave.
URL base
https://app.argorant.com/api/v1Chaves de API
Entre em app.argorant.com/profile e crie uma chave em Chaves de API. As chaves começam com ag_live_ e são exibidas uma única vez. Dê a cada chave o nome do que a usa, como zapier, ci ou laptop, para que você possa revogar uma sem quebrar as outras.
Envie a chave em toda chamada:
curl "https://app.argorant.com/api/v1/account" \
-H "Authorization: Bearer $ARGORANT_API_KEY"A resposta informa em nome de quem a chave age, o seu plano, os seus créditos, quantas requisições por minuto a chave pode enviar e o que resta dos limites de hoje. Chame antes de um trabalho grande.
As chaves de API funcionam durante o teste grátis de 7 dias e em todos os planos. A ferramenta de linha de comando lê a mesma chave de npx argorant login ou da variável ARGORANT_API_KEY.
Escopos
Uma chave criada no app tem todos os escopos abaixo. Uma chave mais restrita recebe 403 com o código scope_missing quando chama algo fora dos seus escopos.
| Escopo | Permite | Pode custar |
|---|---|---|
argorant:read_counts | Contagens, listas de termos, conta, leitura de campanhas, a caixa de entrada, caixas de e-mail e webhooks | Nada |
argorant:search_segments | Prévias mascaradas de pessoas e empresas | Nada |
argorant:manage_lists | Listas, campanhas, início de campanhas, resposta a respostas, status, caixas de e-mail, a lista de bloqueio, webhooks, pedidos de caixas de e-mail | Pedidos de caixas de e-mail custam dinheiro, depois de um sim |
argorant:unlock_contacts | Liberações, números de telefone, enriquecimento de pessoas, o localizador de e-mails | Créditos |
argorant:create_exports | Exportações e exportações de listas | Créditos |
argorant:verify_emails | Verificação das suas próprias listas | Créditos, meio crédito por verificação nova |
Agentes de IA fazem login, nunca veem a chave
Clientes MCP como Claude e ChatGPT se conectam a https://mcp.argorant.com/mcp e fazem login com OAuth 2.1 (authorization code com PKCE). Eles agem pela sua conta com os escopos que você aprova, e a sua chave de API nunca vai para um chat. Veja Conecte um cliente.
Permissões dentro de um workspace
Uma chave age como a pessoa que a criou. Proprietários e membros veem apenas o próprio workspace. Algumas ações, como pedir caixas de e-mail, são do proprietário do workspace; um membro recebe 403 com uma mensagem clara dizendo isso. Itens de outros workspaces sempre respondem 404 not_found, igual a itens que não existem.
Introdução
O que a API do Argorant faz, o que é grátis, o que custa créditos e como a API, a ferramenta de linha de comando e o servidor MCP se encaixam.
Erros e limites
O formato único de erro, todos os códigos de erro, o ID da requisição, os limites de requisições por plano, os limites de buscas e contagens, os limites diários, as páginas e as novas tentativas seguras.