Skip to main content
As configurações da API controlam como você acessa a API da Enrow e como ela se comporta em cada requisição. Esta página explica quem pode acessar a API, onde encontrar sua chave de API, como definir uma URL de webhook padrão e como o parâmetro country_code altera o comportamento da busca.

​
Quem pode acessar a API da Enrow?

A API da Enrow está disponível para clientes com uma assinatura ativa ou créditos pré-pagos. Se sua conta não tiver nenhum dos dois, a seção da API não ficará acessível. Para ver como os créditos são consumidos por endpoint, consulte Créditos e cobrança.

​
Onde encontro minha chave de API?

Sua chave de API está no Painel da Enrow — clique em API no menu à esquerda e copie a chave. A mesma chave autentica todos os endpoints através do cabeçalho x-api-key. Para exemplos de requisição e tratamento de erros, consulte Autenticação.
Mantenha sua chave de API segura. Nunca faça commit da chave de API em sistemas de controle de versão nem a compartilhe publicamente. Trate-a como uma senha.

​
Como defino uma URL de webhook padrão?

Você pode definir uma URL de webhook padrão na página API do painel. A Enrow verifica a URL quando você a salva: consulte Como verifico meu endpoint de webhook?. Essa URL é usada sempre que nenhum webhook for especificado em uma requisição individual, então você não precisa repeti-la em cada chamada. Quando uma requisição inclui um webhook no objeto settings, ele substitui o padrão do painel nas requisições do Phone Finder e do Email Verifier. Nas requisições do Email Finder, a Enrow notifica as duas URLs. Para formatos de payload, entregas e segurança, consulte Como Funcionam os Webhooks.

​
O que o parâmetro country_code faz?

O parâmetro country_code (ISO 3166-1 alpha-2) define qual versão local do Google a API usa para resolver uma empresa. Passe-o no objeto settings da sua requisição. Se nada for fornecido, o padrão é US.
O código do país só é útil ao pesquisar com company_name (não com company_domain). Ele informa à Enrow qual versão local do Google usar para resolver a empresa — por exemplo, google.de para a Alemanha ou google.fr para a França.
O código do país é particularmente útil para homônimos — empresas que compartilham o mesmo nome em países diferentes:
O objeto settings também aceita webhook (uma URL de webhook por requisição) e retrieve_gender (booleano). Consulte a referência Find Single Email para a lista completa de configurações disponíveis.

​
FAQ

Não. Uma única chave de API autentica todos os endpoints — Email Finder, Email Verifier e Phone Finder. Passe a chave no cabeçalho x-api-key em cada requisição.
Não. O parâmetro country_code só afeta buscas que usam company_name. Quando você passa um company_domain, o domínio já identifica a empresa, então o código do país não tem efeito.
Depende do endpoint. Nas buscas do Email Finder, a Enrow envia o resultado para as duas URLs (uma única vez se forem iguais). Nas buscas do Phone Finder e nas verificações do Email Verifier, o webhook por requisição no objeto settings substitui o padrão do painel, que só é usado quando uma requisição não inclui sua própria URL de webhook.

​
Próximos passos

Autenticação

Como passar sua chave de API no cabeçalho x-api-key.

Como Funcionam os Webhooks

Configure webhooks para ser notificado quando uma busca for concluída.

Créditos e cobrança

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

Encontrar um e-mail

Execute uma única busca de e-mail com configurações personalizadas.