Как защитить свой сайт от временных почт с помощью api.testmail.top?

API: Проверка домена/адреса почты

URL: https://api.testmail.top/domain/check
Метод: GET
Пример запроса: https://api.testmail.top/domain/check/data=example@mail.com&ip=8.8.8.8
Заголовки: Authorization: Bearer XXXXXXXXXX.XXXXXXXXXX.XXXXXXXXXX

Параметры запроса

Заголовки запроса

Приступим к практике

Рассмотрим запросы к api.testmail.top на примерах. Для попробуем отправить из запрос на проверку заведомо ложного домена/почты, взятого с одного из самых популярных сервисов временых почт temp-mail.org, из консоли

cURL запрос:

					curl --location --request GET 'https://api.testmail.top/domain/check?data=fovah86335@990ys.com&ip=154.115.9.195' \

--header 'Authorization: Bearer XXXXXXXXXX.XXXXXXXXXX.XXXXXXXXXX'
					
				

cURL ответ:

					{
    "error": 0,
    "result": false,
    "message": "This domain is in Blacklist"
}
					
				

В ответе получили "result": false - а это значит, что данного пользователя НЕЛЬЗЯ пускать на регистрацию

---

Теперь, попробуем отправить из запрос на проверку домена/почты при помощи PHP. Как и в прошлом примере, нет ничего сложного, теперь для примера отправим 100% трастовую почту GMAIL. От себя рекомендую выставить параметр CURLOPT_TIMEOUT на 3 секунды, хотя обычный запрос занимает доли секунды - это обезопасит вашу регистрацию от краха, в том случае если сервер api.testmail.top будет недоступен

PHP - cURL запрос:

					<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.testmail.top/domain/check?data=typicaluser@gmail.com&ip=154.115.9.195',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 3,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer XXXXXXXXXX.XXXXXXXXXX.XXXXXXXXXX'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
					
				

PHP - cURL ответ:

					{
    "error": 0,
    "result": true,
    "message": "This domain is in Whitelist"
}
					
				

В ответе получили "result": true - это значит, что данного пользователя МОЖНО пускать на регистрацию

Отлично, теперь немного углубимся в возможности api.testmail.top, рассмотрим несколько исключений:

В двух предыдущих примерах, мы рассматривали типичные почты, которые представляют BLACKLIST(временные почты, содержащиеся в нашей базе), так и WHITELIST(такие как GMAIL, YAHOO или YANDEX например...). Но что же делать в не стандартной ситуации?

1. Домен почты пока что имеет статус "НЕОПРЕДЕЛЕН"

   Пользователь передает почту своего личного или корпоративного домена например admin@habr.ru, в этом случае ответ будет таков:

   								{
   "error": 0,
   "result": true,
   "unknown": true,
   "message": "Unknown domain. We will classify this domain shortly"
   }
   								
   							

   В ответе получили "result": true - а это значит, что данного пользователя МОЖНО пускать на регистрацию, поскольку мы пока точно не знаем что это за домен, и мы не можем "разбрасываться" нашими клиентами. После чего домен будет отправлен на проверку, обязательно определен, чтоб при повторном запросе уже ответить точно принадлежит ли он какому либо из списков.

2. Пользователь допустил ошибку(синтаксическую) при вводе почты в форму регистрации

   Например admin@;habr.ru, в этом случае ответ будет таков:

   								{
       "error": 31,
       "result": false,
       "message": "Invalid email address"
   }
   								
   							

   В ответе получили "result": false - а это значит, что данного пользователя НЕЛЬЗЯ пускать на регистрацию. В этом случае необходимо обработать ошибку "error": 31 - которая подскажет вашему пользователю проверить коректность введенного им почтового адреса

3. Или домен его почты вовсе не способен принимать почту?

   Например admin@habr1.ru, в этом случае ответ будет таков:

   								{
       "error": 36,
       "result": false,
       "message": "No mail server is attached to this domain"
   }
   								
   							

   В ответе получили "result": false - а это значит, что данного пользователя НЕЛЬЗЯ пускать на регистрацию. В этом случае необходимо обработать ошибку "error": 36 - которая подскажет вашему пользователю проверить коректность введенного им почтового адреса

В любой непонятной ситуации просто скажи пользователю проверить правильность написания EMAIL

Это необходимо, для того, чтобы небыло ложного ожидания со стороны пользователя завершительного этапа регистрации - подтверждения почты