AvScan

Проверка доменов на бан антивирусами

API-интерфейс позволяет осуществлять взаимодействие с сервисом проверки доменов на блокировку антивирусами без обращения к веб-интерфейсу, используя обращения на специальный URL методом.
Интерфейс доступен только vip-пользователям.

Быстрая проверка доменов

Метод позволяет быстро проверить один или несколько (до 20) доменов на бан антивирусами.
Для этого нужно, отправить GET-запрос:
https://avscan.ru/api/?key={key}&method=scan&format={format}&domains={domains}
Параметр Описание Возможные значения
key персональный api-ключ пример: 5cfa88f0fb74abbc1f3ca44ce269c17d
method название api-метода scan
format формат вывода результата проверки xml или json
domains домены для проверки. До 20 доменов, через разделитель | пример: ya.ru|google.com|auto.mail.ru

Пример ответа с результатом проверки (json):
{
    "ya.ru" : {"block_kis":"0", "block_nod":"0", "block_avt":"0", "block_dwb":"0", "losses":"0"},
    "google.com" : {"block_kis":"0", "block_nod":"0", "block_avt":"0", "block_dwb":"0", "losses":"0"}, 
    "auto.mail.ru" : {"block_kis":"0", "block_nod":"0", "block_avt":"0", "block_dwb":"0", "losses":"0"}
}


Параметры ответа:
Параметр Описание Возможные значения
block_kis блокировка АВ Касперский 1 - блокируется,
0 - не блокируется,
-1 - не удалось проверить
block_nod блокировка Eset NOD32
block_avt блокировка АВ Avast
block_dwb блокировка АВ Dr.Web
losses приблизительный процент потерь трафика от 0 до 100
Пример реализации на PHP:
  function avsScan($sApiKey, $aDomains) {
    if($sApiKey && count($aDomains)) {
      $aRes = json_decode(file_get_contents('https://avscan.ru/api/?key='.$sApiKey.'&method=scan&format=json&domains='.implode('|', $aDomains)), $assoc=true);
      if($aRes != NULL) return $aRes;   
        } else echo 'error_func_params';
    return false;
  }
        
  # пример
  $aRes = avsScan('5cfa88f0fb74abbc1f3ca44ce269c17d', array('ya.ru', 'google.com', 'auto.mail.ru'));
  print_r($aRes);       
                                  
Результат выполнения кода:
Array
(
    [ya.ru] => Array
        (
            [block_kis] => 0
            [block_nod] => 0
            [block_avt] => 0
            [block_dwb] => 0
            [losses] => 0
        )

    [google.com] => Array
        (
            [block_kis] => 0
            [block_nod] => 0
            [block_avt] => 0
            [block_dwb] => 0
            [losses] => 0
        )

    [auto.mail.ru] => Array
        (
            [block_kis] => 0
            [block_nod] => 0
            [block_avt] => 0
            [block_dwb] => 0
            [losses] => 0
        )

)