O que é o HuntAPI?
Como o HuntAPI funciona e o que inclui uma conta.
O HuntAPI é uma API HTTP que chama a partir do seu backend, da sua plataforma de automação ou de um agente de IA. Envia um pedido com a sua chave de API, nós tratamos do trabalho e recebe JSON estruturado. Cada chamada bem-sucedida consome créditos do saldo da sua conta.
200
4xx / 5xx
Créditos
Os três elementos necessários
| O quê | Onde |
|---|---|
| Uma conta | Registe-se no painel em https://app.huntapi.com |
| Uma chave de API | Chaves API na barra lateral, enviada no cabeçalho x-api-key |
| Créditos | Incluídos no seu plano, recarregados manual ou automaticamente |
O que acontece num pedido
O seu backend envia a chamada
O pedido chega a https://api.huntapi.com com o cabeçalho x-api-key. Nunca coloque a chave num navegador ou numa aplicação móvel.
Verificamos a chave e o saldo
Chaves inválidas, inativas ou expiradas devolvem 401. Um saldo vazio ou uma fatura por pagar devolve 402. Os limites de taxa também devolvem 401, com uma mensagem que identifica o limite.
Executamos o endpoint e devolvemos JSON
Em caso de sucesso, recebe dados estruturados. A chamada fica registada em Registros API com o estado, a duração e o custo em créditos.
Os créditos só são descontados quando a chamada tem sucesso
As respostas bem-sucedidas são faturadas. Falhas de autenticação, parâmetros inválidos e erros de servidor não custam nada — pode experimentar sem gastar o saldo.
Para que serve o painel
A API é sem estado: autentica-se com uma chave e recebe uma resposta. O painel serve para gerir tudo à volta — explorar a Biblioteca de endpoints, emitir e revogar chaves, acompanhar o consumo, transferir faturas e convidar colegas. Nunca precisa do painel para fazer uma chamada, mas é nele que mantém a integração saudável.
Depois do registo, chega à Biblioteca. O saldo restante está também no fundo da barra lateral, em todos os ecrãs, para saber sempre quanto tempo de utilização ainda tem.