API V2
A versão 2 da API Captain Verify já está disponível e inclui novos recursos. Se você está procurando uma maneira confiável de verificar a validade de seus e-mails, pode integrar a API de verificação de e-mail do Captain Verify em seus próprios aplicativos. Aconselhamos usar a API a posteriori porque uma verificação pode ser mais ou menos longa (1 minuto).
Chave API
É necessária uma conta para gerar a chave da API, é isso que lhe dará acesso ao serviço.
limites de API
A API está limitada a um máximo de 2 conexões simultâneas e 50 verificações por minuto. Ao integrar a API, certifique-se de que seu aplicativo não exceda esse limite.
O pedido
Para fazer uma solicitação à API, basta chamar o protocolo GET nesta URL:
https://api.captainverify.com/v2/verify?apikey=XXXXXXXXXXXXXXXXXXXX&email=john.doe@gmail.com
Substitua john.doe@gmail.com pelo seu e-mail para verificar.
A resposta
Uma tabela json será retornada com estas variáveis:
{
"credits":870,
"result":"invalid",
"details":"unknown_email",
"free":true,
"role":false,
"disposable":false,
"ok_for_all":false,
"protected":false,
"did_you_mean":"john.doe@gmail.com",
"email":"john.doe@gmail.com",
"email_normalized":"john.doe@gmail.com",
"success":true,
"message":null
}
| Variáveis | valor possível |
|---|---|
| credits | Créditos disponíveis em sua conta. |
| result | valid, invalid, risky, unknown O status do e-mail. caso todos os seus créditos tenham sido esgotados, o status desconhecido sempre será retornado, para não bloquear sua inscrição. |
| details | null, email error, greylisting, low quality, low deliverability, mailboxfull... Entenda o resultado de uma auditoria. |
| free | true, false Se o provedor de e-mail for gratuito, por exemplo, Gmail.com. |
| role | true, false Se o usuário do e-mail tiver uma função, ex: suporte@exemplo.com. |
| disposable | true, false O e-mail é válido, mas descartável após pouco tempo não será mais possível entrar em contato com o usuário. |
| ok_for_all | true, false Ok para todos: o servidor de correio remoto aceita todos os e-mails (pega-tudo). |
| protected | true, false O e-mail é protegido por uma solução antispam proprietária |
| mailboxfull | true, false O endereço de e-mail está cheio. Ela não pode mais receber correspondência |
| did_you_mean | default : null Se, por exemplo, o e-mail for john.doe@gmil.com, a API enviará uma proposta como john.doe@gmail.com. |
| O e-mail que você deseja verificar. | |
| email_normalized | O e-mail foi normalizado, removendo tags para gmail... suporte+teste@gmail.com será suporte@gmail.com. |
| success | true, false Se a autenticação falhar, seus créditos serão esgotados. |
| message | default : null Quando o sucesso for falso, uma mensagem de erro será enviada. |