Документация BILLmanager 5

Перепродажа лицензий 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
    Пояснения