Метод проверки spam_check - проверка по черным спискам

Этот метод должен быть использован для массовых проверок IP, Email на спам активность. Для других целей используйте другие методы:

  • check_message - Проверка сообщения/комментария.
  • check_newuser - Проверка регистрации.
  • send_feedback - Метод обратной связи.
  • backlinks_check- массовая проверка обратных ссылок в спам комментариях.

Результаты метода - это информация о наличии записей об указанных IP или email в нашей базе данных за всё время. Поэтому они могут отличаться от результатов проверки по чёрным спискам на нашем сайте - https://cleantalk.org/blacklists - там выводится только текущий спам-статус.

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

Необязательные GET параметры:

  • ip - ip адрес для проверки,
  • email - email адрес для проверки (Результат выдается за последние 6 месяцев)
  • date - дата в формате YYYY-MM-DD для проверки (Этот параметр может быть применен только к IP адресам.)

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

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

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

https://api.cleantalk.org/?method_name=spam_check&auth_key=123456&email=stop_email@example.com&ip=127.0.0.1&date=2017-01-31

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

{"data":{"127.0.0.1":{"appears":0},"stop_email@example.com":{"appears":1,"frequency":"999","updated":"2019-04-24 23:33:00","spam_rate":"100","frequency_time_10m":"1","frequency_time_1h":"10","frequency_time_24h":"1000"}}}

 

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

  • data - массив с проверенными записями,
  • appears - флаг присутствия в черных списках,
  • spam_rate - спам-рейтинг от 0 до 100%. 100 означает точно спам,
  • frequency_time_10m - активность за 10 минут,
  • frequency_time_1h - активность за 1 час,
  • frequency_time_24h - активность за 24 часа.

В случае указания параметра "date" данные ответа приводятся только на указанную дату.

Проверка нескольких записей

Вы можете отправить несколько записей для теста за 1 раз, для этого используйте POST параметры:

  • data - строка с записями для проверки разделенная ','.

Например,

wget -O- --post-data='data=stop_email@example.com,10.0.0.1,10.0.0.2' https://api.cleantalk.org/?method_name=spam_check\&auth_key=123456

 

Ответ:

{"data":{"stop_email@example.com":{"appears":1,"frequency":"999","updated":"2019-04-24 23:33:00"},"10.0.0.1":{"appears":0},"10.0.0.2":{"appears":0}}}

 

Ограничения

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

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

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

 

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

{"error_message":"Recevied 1001 records to check, maximum 1000 records check perl call.","error_no":8}

Сейчас максимальное количество элементов данных установлено в 1000.

 

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

Примечание: Если в запросе передается дата, то время выполнения этого запроса будет немного увеличено.

 

Описание нескольких примеров ответов API

 

Ниже вы можете увидеть разбор и описание параметров для возможных вариантов ответа сервера, таких как:

  • "appears" - флаг присутствия в черных списках,
  • "spam_rate" - спам-рейтинг от 0 до 100%. 100 означает точно спам,
  • "frequency" - количество сайтов, которые сообщили о спам активности записи,
  • "frequency_time_10m" - активность за 10 минут,
  • "frequency_time_1h" - активность за 1 час,
  • "frequency_time_24h" - активность за 24 часа.

 

Пример:

"ip":{"appears":1}

Объяснение:

  • IP находится в черном списке;

 

Пример:

"ip":{"appears":0}

Объяснение:

  • IP не находится в черном списке;

 

Пример:

"ip":{"appears":0, "frequency":"15"}

Объяснение:

  • "appears":"0" - IP не находится в черном списке;
  • "frequency":"15" - 15 сайтов сообщили о спам активности этого IP.

Пример:

"ip":{ "appears":0,"spam_rate":"1","frequency":"1","frequency_time_10m":"1","frequency_time_1h":"1","frequency_time_24h":"1"}

Объяснение:

  • "appears":"0" - IP не находится в черном списке;
  • "spam_rate":"1" - был 1 запрос и он был определен как спам активный;
  • "frequency":"1" - 1 сайт сообщил о спам активности этого IP.;
  • "frequency_time_10m":"1" - был 1 спам запрос за 10 минут;
  • "frequency_time_1h":"1" - был 1 спам запрос за 1 час;
  • "frequency_time_24h":"1" - был 1 спам запрос за 24 часа.