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

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

ISPSystem

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

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

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 — параметр, который указывает на провайдера



Спасибо за ваш отзыв!
Была ли полезна статья?
Уточните, почему:

статья не соответствует названию

статью сложно понять

в статье нет ответа на мой вопрос

рекомендации из статьи не помогли

другая причина

Расскажите, что вам не понравилось в статье: