Об этом видео

Ответы в этом видео — настоящие ответы API, сокращённые. Для API-ключей, массовой и файловой проверки нужен платный аккаунт.

Расшифровка видео

1. 00:00Первый запрос

   Первый запрос — это POST на /verify/single. Отправьте одно поле JSON, email. Положите ваш API-ключ в заголовок BV-API-KEY. Это весь запрос. Храните этот ключ в переменной окружения на сервере, никогда не в клиентском коде. Для создания ключа нужен платный аккаунт, и любая покупка кредитов его открывает.

2. 00:24Читаем ответ

   Это настоящий ответ для адреса поддержки. Начните со status. Там role, потому что support — это название общего ящика, а не человека. Оценка — 0,6. Это значение по фиксированным правилам, а не вероятность. Поэтому ветвитесь по status, а не по оценке. Is deliverable равно true, значит, почтовый сервер принял этот адрес. Is catch-all тоже true, значит, этот домен принимает любой адрес. Role занимает status, а флаги всё равно показывают остальное. Reason объясняет причину одним кодом. Здесь это catch-all deliverable.

3. 01:02Почему credits_used равно 0

   В документации есть страница со списком всех кодов. Теперь credits used. Здесь ноль, но это не значит, что проверки бесплатны. Этот аккаунт уже проверял этот адрес за последние 24 часа, поэтому повтор не тарифицировался. Первая проверка, как эта, стоит один кредит. Verification mode говорит, откуда взят ответ. Этот пришёл из кэшированной истории. Используйте его, чтобы понять результат. Для биллинга читайте credits used.

4. 01:23До 50 адресов

   Короткий список? Используйте /verify/bulk. Заголовок тот же, а тело принимает массив emails, до 50 адресов. Результаты приходят в этом же ответе. У каждого адреса те же поля, что вы только что видели. Первый — catch-all. Второй — невалидный, потому что такого ящика нет. Третий — одноразовый. Все три списали кредит. Невалидный засчитывается. Одноразовый засчитывается здесь, потому что в этом запросе check_smtp выставлен в true. Уберите его, и совпадение с одноразовым остановится раньше, бесплатно. Поэтому по умолчанию неизвестно, неверный синтаксис и одноразовый ничего не стоят. Всё остальное — один кредит, включая catch-all и роль. Под результатами идут итоги. Valid emails равно нулю, потому что catch-all не считается валидным. А категории группируют партию: один пригодный с catch-all, два недоставляемых. Отправите больше 50 — получите HTTP 400 с кодом 3103. Список не делится за вас и не превращается в файловое задание. Ошибка указывает на файловый эндпоинт.

5. 02:28Списки побольше

   Для списков побольше загрузите файл. Он работает асинхронно, поэтому загрузка возвращает ID задания. По этому ID проверяйте ход выполнения. Когда задание завершится, скачайте результаты. Оставьте флаг -L, потому что скачивание может перенаправлять. Скачивается CSV. Ваши исходные столбцы сохраняются, а новые идут следом, например ev_status и ev_reason.

6. 02:49Проверяем кредиты

   /credits показывает, сколько осталось. Это GET, с тем же заголовком. Проверяйте его перед большой загрузкой, потому что при нехватке кредитов API вернёт 402.

7. 03:00Две опции запроса

   Две опции меняют поведение проверки. SMTP включён по умолчанию, и письмо никогда не отправляется. check_smtp false пропускает почтовый сервер, поэтому большинство адресов возвращается как неизвестно. force_refresh true пропускает кэш, и вы платите за новый результат.

8. 03:17Ошибки и лимиты

   Сначала обработайте три ошибки. 401 — отсутствующий или недействительный ключ. 402 — не хватает кредитов. 429 — лимит запросов, поэтому сделайте паузу и повторите. Лимиты действуют на каждый API-ключ. 6000 запросов в минуту для single. 1500 для bulk.

9. 03:37Что дальше

   300 для загрузки файлов. Вот и весь быстрый старт. Single, bulk, файлы и кредиты. Полный справочник API, SDK и вебхуки — на billionverify.com/docs. 20 бесплатных кредитов в каждый день использования аккаунта, до 600 в месяц. Банковская карта не нужна. Начните на billionverify.com.

Показано в этом видео