Перепродажа лицензий ISPmanager 6 через API
В этой статье описано, как с помощью API осуществлять перепродажу лицензий ISPmanager 6.
О перепродаже лицензий при помощи BILLmanager см. статью Перепродажа лицензий ISPmanager 6 через BILLmanager.
API адрес биллинговой платформы ISPsystem: https://api.ispsystem.com.
Авторизация в системе осуществляется с помощью параметра authinfo, который принимает значение: authinfo=user:passwd. Где user — имя пользователя в биллинговой платформе my.ispmanager.com, passwd — пароль пользователя.
Заказ лицензии
Для заказа используйте функцию soft.order.param с параметрами:
- skipbasket — списать средства и активировать сразу, игнорируя корзину. Возможные значения:
- on — активировать без перехода в корзину;
- off — активировать с переходом в корзину. Значение по умолчанию, допускается не указывать в запросе;
- ip — IP-адрес заказываемой лицензии;
- licname — название заказываемой лицензии;
- period — период оплаты лицензии. Может принимать значения:
- period=1 — 1 месяц;
- period=12 — 1 год;
- autoprolong — параметр, отвечающий за автопродление лицензии. Возможные значения:
- autoprolong=1 — при заказе лицензии будет выставлено автопродление на 1 месяц;
- autoprolong=12 — автопродление на год;
- autoprolong=null — без автопродления;
pricelist — код тарифного плана.
Коды тарифного плана будут различаться в зависимости от страны регистрации аккаунта, который используется для перепродажи. Возможные значения:Для клиентов РФ Для клиентов других стран - ISPmanager 6 Lite: pricelist=55231;
- ISPmanager 6 Pro: pricelist=55232;
- ISPmanager 6 Host: pricelist=55233;
- ISPmanager 6 Business:
pricelist=55234.
ISPmanager 6 Lite: pricelist=55227
- ISPmanager 6 Pro: pricelist=55228
- ISPmanager 6 Host: pricelist=55229
- ISPmanager 6 Business:
pricelist=55230.
addon_X — количество узлов у лицензий ISPmanager 6 Business. Возможные значения:
Для клиентов РФ Для клиентов других стран addon_55237=<количество>
addon_55236=<количество>
Пример вызова функции
https://api.ispsystem.com/manager/billmgr?authinfo=user:passwd&out=xml&func=soft.order.param&clicked_button=finish&ip=82.156.37.16&licname=name&period=1&pricelist=55234&addon_55237=1&autoprolong=1&sok=ok&skipbasket=on
Обратите внимание!
Если указаны коды тарифных планов не для той страны регистрации аккаунта, то может возникнуть ошибка "subaccount_disabled:The client's account is suspended by administrator".
Продление лицензии
Для продления используйте функцию service.prolong с параметрами:
- elid — код продлеваемой лицензии;
- period — период продления. Может принимать значения:
- period=1 — 1 месяц;
- period=12 — 1 год.
Пример вызова функции
https://api.ispsystem.com/manager/billmgr?authinfo=user:passwd&out=xml&func=service.prolong&elid=334673&period=1&sok=ok
Изменение параметров лицензии
С помощью функции soft.edit можно изменить IP-адрес лицензии и название лицензии. Новое название лицензии передаётся параметром licname, IP-адрес — ip.
Пример вызова функции
https://api.ispsystem.com/manager/billmgr?authinfo=user:passwd&out=xml&func=soft.edit&elid=334673&licname=<новое название лицензии>&ip=<новый IP-адрес>&sok=ok
Изменение тарифа лицензии
Вы можете изменить тариф с помощью функции service.changepricelist.
Пример вызова функции
https://api.ispsystem.com/manager/billmgr?authinfo=user:passwd&out=xml&func=service.changepricelist&elid=<код лицензии>&pricelist=<код тарифа>&sok=ok
Выключение лицензии
За выключение лицензии отвечает функция soft.suspend.
Пример вызова функции
https://api.ispsystem.com/manager/billmgr?authinfo=user:passwd&out=xml&func=soft.suspend&elid=<код лицензии>
Включение лицензии
За включение лицензии отвечает функция soft.resume.
Пример вызова функции
https://api.ispsystem.com/manager/billmgr?authinfo=user:passwd&out=xml&func=soft.resume&elid=<код лицензии>
Проверка заказа лицензии
Проверить возможность заказа лицензии на определённый IP-адрес можно с помощью функции soft.checkip.
Пример вызова функции
https://api.ispsystem.com/manager/billmgr?authinfo=user:passwd&out=xml&func=soft.checkip&pricelist=7&period=1&ip=82.145.17.16
Смена ключа лицензии
Для смены ключа лицензии необходимо вызвать функцию soft.edit, параметр clicked_button=newkey определяет необходимость сгенерировать новый ключ.
Пример вызова функции
https://api.ispsystem.com/manager/billmgr?authinfo=user:passwd&out=xml&clicked_button=newkey&elid=2512171&func=soft.edit&sok=ok
Удаление лицензии
Чтобы удалить лицензию, используйте функцию soft.delete.
Пример вызова функции
https://api.ispsystem.com/manager/billmgr?authinfo=user:passwd&out=xml&func=soft.delete&elid=<код лицензии>
Просмотр всех лицензий ISPmanager 6
Чтобы просмотреть все лицензии ISPmanager 6, включая триальные, выполните запрос:
Пример запроса для просмотра списка лицензий
https://api.ispsystem.com/billmgr?authinfo=user:passwd&func=soft&out=xml&project=1
project=1 — параметр, который указывает на провайдера