Saltar para o conteúdo principal
A API da Enrow usa autenticação por chave de API. Toda requisição deve incluir sua chave de API no cabeçalho x-api-key. Não há fluxos OAuth nem tokens bearer para gerenciar — uma única chave de API autentica todos os endpoints.

​
Como obtenho minha chave de API?

  1. Cadastre-se em app.enrow.io
  2. Clique em API no menu à esquerda
  3. Copie sua chave de API
Mantenha sua chave de API segura e nunca a inclua em controle de versão. Trate-a como uma senha. Se uma chave for exposta, rotacione-a — consulte Boas práticas.

​
Como autentico uma requisição?

Inclua sua chave de API no cabeçalho x-api-key em todas as requisições: 
curl --request POST \
  --url https://api.enrow.io/email/find/single \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "fullname": "John Doe",
    "company_domain": "example.com"
  }'
O mesmo cabeçalho x-api-key funciona para todos os endpoints — Email Finder, Email Verifier, Phone Finder e Informações da conta.

​
Por que estou recebendo um erro 401?

Uma resposta 401 Unauthorized significa que sua chave de API está ausente ou é inválida. Se a chave de API for inválida, você receberá: 
{
  "message": "This apikey is not valid"
}
Se nenhuma chave de API for fornecida, a message será "No apikey found in the x-api-key headers". Para a lista completa de códigos de status e formatos de erro, consulte Códigos de status e Tratamento de erros.

​
Como verifico minha conta e meus créditos?

Você pode obter as informações da sua conta (saldo de créditos e webhooks registrados) usando o mesmo cabeçalho x-api-key — nenhum corpo de requisição é necessário: 
curl https://api.enrow.io/account/info \
  -H "x-api-key: YOUR_API_KEY"
Resposta
{
  "credits": 8500,
  "webhooks": ["https://your-app.com/webhooks/enrow"]
}
Para entender como os créditos são consumidos por endpoint, consulte Créditos e cobrança.

​
Boas práticas

Armazene sua chave de API em variáveis de ambiente em vez de codificá-la diretamente:
export ENROW_API_KEY="your_api_key_here"
Para maior segurança, rotacione suas chaves de API periodicamente e revogue as chaves não utilizadas.
Crie chaves de API separadas para os ambientes de desenvolvimento, homologação e produção.

​
Próximos passos

Encontrar um email

Busque um endereço de email profissional a partir de um nome e uma empresa.

Verificar um email

Verifique se um endereço de email é válido e entregável.

Créditos e cobrança

Veja como os créditos são consumidos em cada endpoint.

Limites de taxa

Entenda os limites de requisições da API antes de escalar.