Quickstart
Get started with email checker API in 5 minutes. Free API key, code examples, and email verification integration guide.
Начните работу с EmailVerify API всего за 5 минут. Это руководство проведёт вас через процесс верификации первого email-адреса.
Предварительные требования
Перед началом вам понадобится:
- Аккаунт EmailVerify (Зарегистрироваться бесплатно)
- Базовые знания HTTP-запросов или знакомство с одним из поддерживаемых языков программирования
Шаг 1: Создание аккаунта
- Перейдите на EmailVerify и нажмите Начать
- Зарегистрируйтесь с помощью email или аккаунта Google/GitHub
- Подтвердите свой email-адрес
Шаг 2: Получение API-ключа
- Войдите в панель управления EmailVerify
- Перейдите в раздел API-ключи
- Нажмите Создать новый ключ
- Дайте ключу описательное имя (например, "Разработка", "Продакшн")
- Скопируйте API-ключ и сохраните его в безопасном месте
Никогда не раскрывайте API-ключ в клиентском коде или публичных репозиториях. Используйте переменные окружения для безопасного хранения ключа.
Шаг 3: Проверка первого email
Выберите предпочтительный способ для выполнения первого запроса на верификацию:
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);Шаг 4: Понимание ответа
Успешная верификация возвращает ответ следующего вида:
{
"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
}Ключевые поля ответа
| Поле | Тип | Описание |
|---|---|---|
status | string | Общий статус: valid, invalid, unknown или accept_all |
deliverable | boolean | Может ли email получать сообщения |
disposable | boolean | Является ли адрес временным/одноразовым |
role | boolean | Является ли адрес ролевым (info@, support@) |
catchall | boolean | Принимает ли домен все письма |
score | number | Оценка уверенности от 0 до 1 (чем выше, тем лучше) |
Значения статусов
| Статус | Значение | Рекомендуемое действие |
|---|---|---|
valid | Email существует и может получать сообщения | Безопасно отправлять |
invalid | Email не существует или не может получать сообщения | Удалить из списка |
unknown | Не удалось определить статус | Повторить позже или действовать с осторожностью |
accept_all | Домен принимает все письма (catch-all) | Отслеживать возвраты |
Шаг 5: Использование SDK (рекомендуется)
Для упрощения интеграции установите один из наших официальных SDK:
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"Что дальше?
Теперь, когда вы проверили свой первый email, изучите дополнительные возможности:
Справочник API
Полная документация API со всеми эндпоинтами
Документация SDK
Подробные руководства по каждому SDK
Типы верификации
Понимание различных типов результатов
Интеграция с ИИ
Использование с Claude, ChatGPT и другими
Типичные сценарии использования
Валидация форм
Проверяйте email в реальном времени при регистрации пользователей:
const onEmailBlur = async (email) => {
const result = await client.verify(email);
if (result.status === 'invalid') {
showError('Пожалуйста, введите действительный email');
} else if (result.result.disposable) {
showError('Одноразовые email не разрешены');
}
};Очистка списков
Очищайте список email перед отправкой кампаний:
for email in email_list:
result = client.verify(email)
if result.status == 'valid':
clean_list.append(email)
else:
remove_list.append(email)Квалификация лидов
Оценивайте лиды на основе качества email:
const qualifyLead = (verificationResult) => {
let score = verificationResult.score * 50; // Базовый балл
if (!verificationResult.result.free) score += 20; // Корпоративный email
if (!verificationResult.result.role) score += 15; // Личный адрес
if (!verificationResult.result.disposable) score += 15; // Постоянный email
return score;
};Нужна помощь?
- Изучите наши руководства по интеграции с примерами реализации
- Свяжитесь с support@emailverify.ai для получения помощи