Sobre este vídeo

As respostas neste vídeo são respostas reais da API, abreviadas. Chaves de API, verificação em massa e de arquivos exigem uma conta paga.

Transcrição do vídeo

1. 00:00Sua primeira requisição

   A sua primeira requisição é um POST para /verify/single. Envie um campo JSON, email. Coloque a sua chave de API no cabeçalho BV-API-KEY. Essa é a requisição inteira. Guarde essa chave em uma variável de ambiente no seu servidor, nunca em código de cliente. Criar uma chave exige uma conta paga, e qualquer compra de créditos libera isso.

2. 00:24Leia a resposta

   Esta é a resposta real para um endereço de suporte. Comece por status. Ele diz role, porque support é o nome de uma caixa compartilhada, não de uma pessoa. O score é zero vírgula seis. É um valor de regras fixas, não uma probabilidade. Então decida pelo status, não pelo score. Is deliverable é true, então o servidor de e-mail aceitou este endereço. Is catch-all também é true, então este domínio aceita qualquer endereço. Role fica com o status, e os flags ainda mostram o resto. Reason dá o porquê, em um código. Aqui é catch-all deliverable.

3. 01:02Por que credits_used é 0

   A documentação tem uma página com todos os códigos. Agora credits used. Aqui é zero, mas isso não quer dizer que as checagens sejam grátis. Esta conta já checou este endereço nas últimas 24 horas, então a repetição não foi cobrada. Uma primeira checagem como esta custa um crédito. Verification mode diz de onde veio a resposta. Esta veio do histórico em cache. Use para entender o resultado. Para a cobrança, leia credits used.

4. 01:23Até 50 endereços

   Tem uma lista curta? Use /verify/bulk. O cabeçalho continua o mesmo, e o corpo recebe um array emails, com até 50 endereços. Os resultados voltam nesta mesma resposta. Cada endereço traz os mesmos campos que você acabou de ver. O primeiro é catch-all. O segundo é inválido, porque essa caixa postal não existe. O terceiro é descartável. Os três usaram um crédito. Inválido conta. O descartável conta aqui porque esta requisição definiu check_smtp como true. Deixe isso de fora, e uma correspondência de descartável para cedo, sem custo. Então, por padrão, desconhecido, sintaxe inválida e descartável não custam nada. Todo o resto é um crédito, catch-all e função incluídos. Abaixo dos resultados vêm os totais. Valid emails é zero, porque catch-all não conta como válido. E os buckets agrupam o lote: um utilizável com catch-all, dois não entregáveis. Envie mais de 50 e você recebe um HTTP 400 com código 3103. A lista não é dividida para você, e não vira um trabalho de arquivo. O erro indica o endpoint de arquivos.

5. 02:28Listas maiores

   Para listas maiores, envie um arquivo. É assíncrono, então o envio devolve um ID de trabalho. Use esse ID para acompanhar o progresso. Quando o trabalho terminar, baixe os resultados. Mantenha a flag dash L, porque o download pode redirecionar. O download é um CSV. Suas colunas originais continuam, e novas vêm depois, como ev_status e ev_reason.

6. 02:49Confira seus créditos

   /credits mostra o que sobrou. É um GET, com o mesmo cabeçalho. Confira antes de um envio grande, porque sem créditos suficientes a API devolve um 402.

7. 03:00Duas opções de requisição

   Duas opções mudam o que uma checagem faz. O SMTP vem ativado por padrão, e nenhum e-mail é enviado. check_smtp false pula o servidor de e-mail, então a maioria dos endereços volta como desconhecido. force_refresh true pula o cache, e você paga pelo novo resultado.

8. 03:17Erros e limites

   Trate três erros primeiro. 401 é chave ausente ou inválida. 402 quer dizer créditos insuficientes. 429 é limite de taxa, então espere e tente de novo. Os limites de taxa valem por chave de API. 6.000 requisições por minuto em single. 1.500 em bulk.

9. 03:37Próximos passos

   300 em envios de arquivo. Esse é o início rápido. Single, bulk, arquivo e créditos. A referência completa da API, os SDKs e os webhooks estão em billionverify.com/docs. 20 créditos grátis por dia em que você usa sua conta, até 600 por mês. Sem cartão de crédito. Comece em billionverify.com.

Apresentada neste vídeo