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

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

В этой статье описано, как с помощью API осуществлять продажу лицензий ISPmanager 5.

О перепродаже лицензий при помощи BILLmanager и WHMCS см. статьи Перепродажа лицензий ISPsystem через BILLmanager и Перепродажа через WHMCS лицензий ISPsystem.

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

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

Обратите внимание!

С 1 января 2022 года завершится поддержка и выпуск обновлений ISPmanager 5 (Lite, Business). Подробнее см. Этапы поддержки. При этом:

  • лицензии, купленные до 8 апреля 2021 года, будут поддерживаться до конца их срока действия в режиме LTS;
  • с 8 апреля до 15 июня 2021 года можно будет продлевать и покупать лицензии на срок до 31 декабря 2021 года. С 15 июня 2021 года продажа и продление лицензий будут прекращены.

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

Для заказа используйте функцию 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 Lite: pricelist=3541;
    • ISPmanager Business: pricelist=4601; addon_4602=<количество>.
  • addon_X — количество узлов у некоторых видов лицензий.
Пример вызова функции
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=4601&addon_4602=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

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

    С помощью функции 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

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

    За выключение лицензии отвечает функция 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=&out=xml&func=soft.delete&elid=<код лицензии>