1. Адреса доступа к сервису
Существует два адреса для запроса активационной информации (лицензионного файла, серийного номера или ссылки активации):
- для продуктов Avast —
https://belrus.net/bxrequest.xml
- для продуктов 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.