Quickstart
Get started with email checker API in 5 minutes. Free API key, code examples, and email verification integration guide.
Comece a usar a API EmailVerify em apenas 5 minutos. Este guia orienta você na verificação do seu primeiro endereço de email.
Pré-requisitos
Antes de começar, você precisará de:
- Uma conta EmailVerify (Cadastre-se gratuitamente)
- Conhecimento básico de requisições HTTP ou familiaridade com uma das linguagens suportadas
Passo 1: Criar uma Conta
- Visite EmailVerify e clique em Começar
- Cadastre-se com seu email ou conta Google/GitHub
- Verifique seu endereço de email
Passo 2: Obter sua Chave de API
- Faça login no seu painel EmailVerify
- Navegue até a seção Chaves de API
- Clique em Criar Nova Chave
- Dê um nome descritivo à sua chave (por exemplo, "Desenvolvimento", "Produção")
- Copie sua chave de API e armazene-a com segurança
Nunca exponha sua chave de API em código do lado do cliente ou repositórios públicos. Use variáveis de ambiente para armazenar sua chave com segurança.
Passo 3: Verificar seu Primeiro Email
Escolha seu método preferido para fazer sua primeira requisição de verificação:
curl -X POST https://api.emailverify.ai/v1/verify \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email": "test@example.com"}'const response = await fetch('https://api.emailverify.ai/v1/verify', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.EMAILVERIFY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
email: 'test@example.com',
}),
});
const result = await response.json();
console.log(result);import os
import requests
response = requests.post(
'https://api.emailverify.ai/v1/verify',
headers={
'Authorization': f'Bearer {os.environ["EMAILVERIFY_API_KEY"]}',
'Content-Type': 'application/json',
},
json={'email': 'test@example.com'}
)
result = response.json()
print(result)package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
"os"
)
func main() {
data := map[string]string{"email": "test@example.com"}
body, _ := json.Marshal(data)
req, _ := http.NewRequest("POST",
"https://api.emailverify.ai/v1/verify",
bytes.NewBuffer(body))
req.Header.Set("Authorization", "Bearer "+os.Getenv("EMAILVERIFY_API_KEY"))
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
fmt.Println(result)
}<?php
$apiKey = getenv('EMAILVERIFY_API_KEY');
$ch = curl_init('https://api.emailverify.ai/v1/verify');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $apiKey,
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode(['email' => 'test@example.com']),
]);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
print_r($result);Passo 4: Entender a Resposta
Uma verificação bem-sucedida retorna uma resposta como esta:
{
"email": "test@example.com",
"status": "valid",
"result": {
"deliverable": true,
"valid_format": true,
"valid_domain": true,
"valid_mx": true,
"disposable": false,
"role": false,
"catchall": false,
"free": false,
"smtp_valid": true
},
"score": 0.95,
"credits_used": 1
}Campos Principais da Resposta
| Campo | Tipo | Descrição |
|---|---|---|
status | string | Status geral: valid, invalid, unknown ou accept_all |
deliverable | boolean | Se o email pode receber mensagens |
disposable | boolean | Se é um email temporário/descartável |
role | boolean | Se é um endereço baseado em função (info@, support@) |
catchall | boolean | Se o domínio aceita todos os emails |
score | number | Pontuação de confiança de 0 a 1 (quanto maior, melhor) |
Valores de Status Explicados
| Status | Significado | Ação Recomendada |
|---|---|---|
valid | Email existe e pode receber mensagens | Seguro para enviar |
invalid | Email não existe ou não pode receber mensagens | Remover da lista |
unknown | Não foi possível determinar o status | Tentar novamente mais tarde ou usar com cautela |
accept_all | Domínio aceita todos os emails (catch-all) | Monitorar por devoluções |
Passo 5: Usar um SDK (Recomendado)
Para facilitar a integração, instale um dos nossos SDKs oficiais:
npm install @emailverify/nodeimport { EmailVerify } from '@emailverify/node';
const client = new EmailVerify({
apiKey: process.env.EMAILVERIFY_API_KEY,
});
const result = await client.verify('test@example.com');
console.log(result.status); // 'valid'pip install emailverifyfrom emailverify import Client
import os
client = Client(api_key=os.environ['EMAILVERIFY_API_KEY'])
result = client.verify('test@example.com')
print(result.status) # 'valid'go get github.com/emailverify/go-sdkimport emailverify "github.com/emailverify/go-sdk"
client := emailverify.NewClient(os.Getenv("EMAILVERIFY_API_KEY"))
result, err := client.Verify(ctx, "test@example.com")
fmt.Println(result.Status) // "valid"composer require emailverify/php-sdkuse EmailVerify\Client;
$client = new Client(getenv('EMAILVERIFY_API_KEY'));
$result = $client->verify('test@example.com');
echo $result->status; // 'valid'<dependency>
<groupId>com.emailverify</groupId>
<artifactId>emailverify-java</artifactId>
<version>1.0.0</version>
</dependency>import com.emailverify.Client;
Client client = new Client(System.getenv("EMAILVERIFY_API_KEY"));
VerificationResult result = client.verify("test@example.com");
System.out.println(result.getStatus()); // "valid"Próximos Passos
Agora que você verificou seu primeiro email, explore mais recursos:
Referência da API
Documentação completa da API com todos os endpoints
Documentação do SDK
Guias detalhados para cada SDK
Tipos de Verificação
Entenda os diferentes tipos de resultado
Integração com IA
Use com Claude, ChatGPT e muito mais
Casos de Uso Comuns
Validação de Formulário
Verifique emails em tempo real durante o registro de usuário:
const onEmailBlur = async (email) => {
const result = await client.verify(email);
if (result.status === 'invalid') {
showError('Por favor, insira um email válido');
} else if (result.result.disposable) {
showError('Emails descartáveis não são permitidos');
}
};Limpeza de Lista
Limpe sua lista de emails antes de enviar campanhas:
for email in email_list:
result = client.verify(email)
if result.status == 'valid':
clean_list.append(email)
else:
remove_list.append(email)Qualificação de Leads
Pontue leads com base na qualidade do email:
const qualifyLead = (verificationResult) => {
let score = verificationResult.score * 50; // Pontuação base
if (!verificationResult.result.free) score += 20; // Email corporativo
if (!verificationResult.result.role) score += 15; // Endereço pessoal
if (!verificationResult.result.disposable) score += 15; // Email permanente
return score;
};Precisa de Ajuda?
- Navegue pelos nossos Guias de Integração para exemplos de implementação
- Entre em contato com support@emailverify.ai para assistência