1. Адреса доступа к сервису

Существует два адреса для запроса активационной информации (лицензионного файла, серийного номера или ссылки активации):

  1. для продуктов Avast — https://belrus.net/bxrequest.xml
  2. для продуктов AVG — https://belrus.org/bxrequest.xml

Будьте внимательны! Если Вы запросите продукт AVG, обратившись к сервису продуктов Avast, или наоборот — в ответ Вы получите ошибку.

2. Параметры доступа

Дилер должен быть зарегистрирован в Сервисе и иметь предоставленное ему имя пользователя и ключ доступа.

URL для запроса должен содержать следующие поля:

  • user = имя_пользователя
  • pwd = ключ

Таким образом, URL запроса приводится к следующему виду: https://belrus.net/bxrequest.xml?user=lola&pwd=supperwoman

3. Параметр command

При запросе к Сервису пользователь отправляет помимо данные своего логина (имя пользователя и ключ) еще и параметр command, который содержит управляющие команды для Сервиса.

Параметр command представляет собой URL-закодированный (url-encoded) документ XML, который передается Сервису с помощью метода POST.

Параметр command не должен содержать символа & и кириллических символов. Например, имя компании Пупкин & Компания должны быть приведены к Pupkin & Kompania.

4. Внимание:

  • Параметр command НЕ ДОЛЖЕН содержать кириллические символы и символ &.
  • Параметр command ДОЛЖЕН БЫТЬ в формате UTF-8.
  • Параметр command ДОЛЖЕН БЫТЬ URL-ЗАКОДИРОВАННЫМ (URL encoded).

5. Пример обработки параметра command на PHP

$command = str_replace('&', '&', $command);
$command = utf8_encode($command);
$command = urlencode($command);

6. Структура параметра command

Как уже упоминалось выше, параметр command является документом формата XML. Например:

<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE alwil-b2b SYSTEM "order-template.dtd">
    <alwil-b2b>
        <order Renewal="Yes" ResellerOrderId="1">
            <customer CustomerNo="10000" />
            <product InternalId="STDS" Quantity="10"/>
        </order>
    </alwil-b2b>

Обратите внимание на заголовок этого документа:

<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE alwil-b2b SYSTEM "order-template.dtd">
    <alwil-b2b>

и заключительную его часть:

</alwil-b2b>

Эти два параметра неизменны во всех вариантах запросов. Элемент order в данном примере сообщает Сервису, что запрашивается 10 лицензий avast! Standart Suite для пользователя, зарегистрированного в базе данных пользователей Avast под номером 10000.