API-интерфейс

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

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

Метод позволяет быстро проверить один или несколько (до 20) доменов на бан антивирусами.


Для этого нужно, отправить GET-запрос:
http://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", "block_avr":"0", "losses":"0" },
    "google.com" : { "block_kis":"0", "block_nod":"0", "block_avt":"0", "block_dwb":"0", "block_avr":"0", "losses":"0" }, 
    "auto.mail.ru" : { "block_kis":"0", "block_nod":"0", "block_avt":"0", "block_dwb":"0", "block_avr":"0", "losses":"0" }
}
Параметры ответа
Параметр Описание Возможные значения
block_kis Kaspersky Internet Security
1 блокируется
0 не блокируется
-1 не удалось проверить
block_nod ESET NOD32 Smart Security
block_dwb Dr.Web Security Space
block_avt Avast Internet Security
block_avr Avira Antivirus Pro
block_bdf BitDefender Internet Security
block_nrt Norton Security
block_pnd Panda Antivirus Pro
block_trm Trend Micro Internet Security
block_cmd Comodo Internet Security
block_mcf McAfee Internet Security
block_gsb Google Safe Browsing
block_ysb Yandex Safe Browsing
block_gdt G-Data Internet Security
block_ems Emsisoft Anti-Malware
block_wot Web of trust (WOT)
block_rkn Роскомнадзор
block_adg Adguard
Пример реализации на PHP
  function avsScan($sApiKey, $aDomains) {
    if($sApiKey && count($aDomains)) {
      $aRes = json_decode(file_get_contents('http://avscan.ru/api/?key='.$sApiKey.'&method=scan&format=json&domains='.implode('|', $aDomains)), true);
      if($aRes != NULL) return $aRes;   
	} else echo 'error_func_params';
    return false;
  }
	
  # пример
  $aRes = avsScan('5cfa88f0fb74abbc1f3ca44ce269c17d', array('ya.ru', 'google.ru', 'auto.mail.ru'));
  print_r($aRes);	
  				  
Результат выполнения кода
Array
(
    [ya.ru] => Array
        (
            [block_kis] => 0
            [block_nod] => 0
            [block_avt] => 0
            [block_dwb] => 0
            [block_avr] => 0
        )

    [google.ru] => Array
        (
            [block_kis] => 0
            [block_nod] => 0
            [block_avt] => 0
            [block_dwb] => 0
            [block_avr] => 0
        )

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

)