API-интерфейс позволяет осуществлять взаимодействие с сервисом проверки доменов на блокировку антивирусами без обращения к веб-интерфейсу, используя обращения на специальный URL методом.
Интерфейс доступен только vip-пользователям.
Интерфейс доступен только 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 |
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
)
)
