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

Перепродажа лицензий v6 ISPsystem через API

Перепродажа услуг может выполняться c помощью удалённых вызовов посредством API. В данной статье описано как с помощью API осуществлять продажу лицензий ISPsystem.

API адрес биллинговой платформы ISPsystem: https://api.ispmanager.com

Авторизация в системе осуществляется с помощью параметра authinfo, который принимает значение: authinfo=user:passwd. Где user — имя пользователя в биллинговой платформе https://my.ispmanager.com, passwd — пароль пользователя. 

Заказ лицензии

Чтобы заказать лицензию, используйте функцию platform.order.param. Доступные параметры: 

  • skipbasket — списать средства и активировать сразу, игнорируя корзину. Возможные значения: 
    • on — активировать без перехода в корзину; 
    • off — активировать с переходом в корзину. Значение по умолчанию, допускается не указывать в запросе; 
  • comment — можно задать
  • period — период оплаты лицензии. Может принимать значения:
    • period=1 — 1 месяц; 
    • period=12 — 1 год; 
    • period=-100 — триальный период;
  • autoprolong — параметр, отвечающий за автопродление лицензии. Возможные значения:
    • autoprolong=1 — при заказе лицензии будет выставлено автопродление на 1 месяц;
    • autoprolong=12 — автопродление на год;
    • autoprolong=null — без автопродления;
  • pricelist — код тарифного плана. Возможные значения:
    • pricelist=55163 — VMmanager 6; 
    • pricelist=55161 — DCImanager 6;
  • addon_id — код дополнения к лицензии. Набор дополнений отличается для каждой лицензии: 
    • addon_55165=N — количество узлов кластера, доступных для подключения к VMmanager 6; 
    • addon_55164=N — количество виртуальных машин, доступных для создания в VMmanager 6. 
Пример запроса
https://api.ispsystem.com/manager/billmgr?authinfo=user:passwd&out=xml&func=platform.order.param&clicked_button=finish&period=1&pricelist=55163&addon_55165=1&autoprolong=1&sok=ok&skipbasket=on

Продление лицензии

Для продления используйте функцию 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

    Изменение параметров лицензии

    С помощью функции platform.edit можно изменить комментарий и значения дополнения к лицензии. Новый комментарий передаётся параметром comment, значения дополнения — addon_id. 

    Пример вызова функции
    https://api.ispsystem.com/manager/billmgr?authinfo=user:passwd&out=xml&func=platform.edit&elid=334673&comment=<новый комментарий>&addon_55165=<новое значение дополнения>&sok=ok

    Выключение лицензии

    За выключение лицензии отвечает функция platform.suspend

    Пример вызова функции
    https://api.ispsystem.com/manager/billmgr?authinfo=user:passwd&out=xml&func=platform.suspend&elid=<код лицензии>

    Включение лицензии

    За включение лицензии отвечает функция platform.resume

    Пример вызова функции
    https://api.ispsystem.com/manager/billmgr?authinfo=user:passwd&out=xml&func=platform.resume&elid=<код лицензии>

    Удаление лицензии

    Чтобы удалить лицензию, используйте функцию platform.delete

    Пример вызова функции
    https://api.ispsystem.com/manager/billmgr?authinfo=&out=xml&func=platform.delete&elid=<код лицензии>