Sobre este vídeo

As respostas neste vídeo são respostas reais da API, encurtadas. As chaves de API e a verificação de arquivos exigem uma conta paga.

Transcrição do vídeo

1. 00:00Envie o arquivo

   Envie um CSV para /verify/file e deixe um webhook avisar quando terminar. O Bulk para em 50 endereços. Para qualquer coisa maior, envie o arquivo inteiro como multipart form data. CSV, TXT e XLSX são aceitos. email_column indica a coluna a ler. Se você omitir, ela é detectada para você. Este é o arquivo de teste. Quatro linhas, mais uma coluna source que queremos manter nos resultados. O envio não espera as checagens. Ele responde com um ID de tarefa e o status pending. Também diz qual coluna leu e quantas linhas e endereços únicos encontrou. Como a própria chave de API, os trabalhos de arquivo são para contas pagas.

2. 00:43Acompanhe o trabalho

   Para acompanhar, faça um GET no mesmo caminho com o ID da tarefa no final. Mesmo cabeçalho, sem corpo. Consultado logo em seguida, este arquivo pequeno já estava em merging. Enquanto roda, o status passa por etapas como preparing, pending, processing e merging. Pare de consultar quando vir completed, completed with warning, failed ou cancelled. Eis o trabalho concluído. As contagens dividem o arquivo por status: um inválido, um de função, um catch-all e um descartável. credits_used é um, e cache_hit_not_charged é três. Três linhas eram reverificações. Esses endereços foram checados nesta conta nas últimas 24 horas, e uma reverificação dentro de 24 horas não é cobrada. Vêm dois links. download_url é o caminho estável da API, então é o que você deve guardar. direct_download_url é um link assinado de armazenamento e para de funcionar no horário de expiração indicado.

3. 01:35Obtenha os resultados

   Chame results e salve a saída em um arquivo. Sem filtros, a API redireciona para o arquivo de resultados completo, e dash L segue esse redirecionamento. Suas colunas vêm primeiro, sem alteração. Depois vêm as colunas ev_, como status, score e reason, em todas as linhas. Precisa só das linhas a remover? Adicione filtros. Eles se combinam com OR, então este pede inválido ou descartável. Com um filtro, o CSV é montado e devolvido diretamente. Voltam duas linhas, as que devem ser removidas.

4. 02:04Use um webhook

   O polling funciona, mas um trabalho longo significa muitas requisições. Um webhook inverte isso. A BillionVerify chama o seu servidor quando um trabalho de arquivo termina ou falha. Registre um com um POST em /webhooks. Informe uma URL HTTPS e os eventos que você quer. São dois: file.completed e file.failed. Essa resposta traz um segredo de assinatura, e é a única vez que você o verá. Salve-o na hora. Você precisa dele para conferir cada entrega. Cada entrega é um POST JSON com três cabeçalhos: o evento, um timestamp e uma assinatura. O corpo informa o evento e a hora. Seu campo data traz o ID do trabalho, as contagens, os créditos usados e os links de download.

5. 02:44Confira a assinatura

   Confira a assinatura antes de agir sobre uma entrega. Junte o cabeçalho de timestamp, um ponto e o corpo bruto. Rode HMAC-SHA256 sobre isso com o seu segredo e compare com o cabeçalho de assinatura. Faça o hash do corpo exatamente como chegou. Um JSON analisado e recodificado não vai coincidir. E rejeite timestamps antigos, para que uma requisição velha não possa ser reenviada. Então o fluxo inteiro é curto. Envie, guarde o ID da tarefa, espere o webhook e depois busque os resultados no link estável.

6. 03:11Próximos passos

   Os valores de status, os filtros e todos os campos do webhook estão na referência da API, em billionverify.com/docs/api-reference. 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.