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 | ![]() |
| ||||||
block_nod | ![]() |
|||||||
block_dwb | ![]() |
|||||||
block_avt | ![]() |
|||||||
block_avr | ![]() |
|||||||
block_bdf | ![]() |
|||||||
block_nrt | ![]() |
|||||||
block_pnd | ![]() |
|||||||
block_trm | ![]() |
|||||||
block_cmd | ![]() |
|||||||
block_mcf | ![]() |
|||||||
block_gsb | ![]() |
|||||||
block_ysb | ![]() |
|||||||
block_gdt | ![]() |
|||||||
block_ems | ![]() |
|||||||
block_wot | ![]() |
|||||||
block_rkn | ![]() |
|||||||
block_adg | ![]() |
|||||||
block_adb | ![]() |
Пример реализации на 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 ) )