API метод email_check_one
 

• Описание
• Get параметры метода
• Расшифровка ответа
• Ограничения
   

Описание

Для использования метода EMAIL_CHECK_ONE необходимо приобрести отдельную лицензию — BlackList API. Цены можно посмотреть здесь: https://cleantalk.org/price-database-api

Приобрести можно на вашей странице биллинга в Панели Управления: https://cleantalk.org/my/bill/api

Результаты метода содержат информацию о существовании адреса e-mail. Метод гарантирует ответ в течение 60 секунд даже в случае, когда процесс проверки не был завершён. В таком случае метод вернёт специальный статус, означающий что проверка выполняется в фоне и финальный результат может быть получен позже.

Необходимые GET параметры при вызове:

• method_name — должен быть 'email_check_one'
• auth_key — ключ Database API. Чтобы получить ключ, зарегистрируйтесь здесь: https://cleantalk.org/register?platform=api
• email — адрес email для проверки
  
   

Пример запроса:

https://api.cleantalk.org/?method_name=email_check_one&auth_key=123456&email=stop_email@example.com

API возвращает JSON строку, например:

{"data":{"stop_email@example.com":"EXISTS"}}

Расшифровка ответа:

data — содержит JSON объект, где единственный ключ является проверяемым email адресом, результат проверки - значение.

Результат проверки может быть один из следующих:

• EXISTS — адрес существует,
• NOT_EXISTS — адрес не существует,
• MX_FAIL — невозможно получить информацию об адресе e-mail или домене.
• PROCESSING - существование email проверяется в фоне.

Замечение: запросы завершившиеся со статусом PROCESSING не считаются в лимит использования BlackList API лицензии. Однако такие запросы считаются в лимит частоты запросов.

Ограничения

Если вы превысите максимальное количество вызовов, API вернет ошибку, например,

{"error_message":"Calls limit exceeded.","error_no":10}

Сейчас максимальное количество вызовов установлено в 100 вызовов за 60 секунд.

Рекомендуемый таймаут - не более 60 секунд.

Вы может задать любой вопрос относительно Анти-Спам от CleanTalk через:

 — Систему тикетов [ https://cleantalk.org/my/support/open ].