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

API адрес биллинговой платформы ispmanager: https://api.ispmanager.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 — код тарифного плана.
    Коды тарифного плана будут различаться в зависимости от страны регистрации аккаунта, который используется для перепродажи. Для клиентов РФ:

Версия

pricelist

Ispmanager 6 Trial

55235

Ispmanager 6 Business Trial

55241

Ispmanager 6 Lite

55231

Ispmanager 6 Pro

55232

Ispmanager 6 Host

55233

Ispmanager 6 Business

55234

Для клиентов других стран:

Версия

pricelist

Ispmanager 6 Trial

55239

Ispmanager 6 Business Trial

55240

Ispmanager 6 Lite

55227

Ispmanager 6 Pro

55228

Ispmanager 6 Host

55229

Ispmanager 6 Business

55230

  • addon_X — количество узлов у лицензий ispmanager 6 Business. Возможные значения:

    Для клиентов РФ:

    addon_55234=<количество>
    Для клиентов других стран:

    addon_55230=<количество>

Пример вызова функции

https://api.ispmanager.com/manager/billmgr?authinfo=user:passwd&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
CODE

Если указаны коды тарифных планов не для той страны регистрации аккаунта, то может возникнуть ошибка "subaccount_disabled:The client's account is suspended by administrator".

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


Для продления используйте функцию service.prolong с параметрами:

  • elid — код продлеваемой лицензии;

  • period — период продления. Может принимать значения:

    • period=1 — 1 месяц;

    • period=12 — 1 год.

Пример вызова функции

https://api.ispmanager.com/manager/billmgr?authinfo=user:passwd&func=service.prolong&elid=334673&period=1&sok=ok
CODE

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


С помощью функции soft.edit можно изменить IP-адрес лицензии и название лицензии. Новое название лицензии передаётся параметром licname, IP-адрес — ip.

Пример вызова функции

https://api.ispmanager.com/manager/billmgr?authinfo=user:passwd&func=soft.edit&elid=334673&licname=<новое название лицензии>&ip=<новый IP-адрес>&sok=ok
CODE

Изменение тарифа лицензии


Вы можете изменить тариф с помощью функции service.changepricelist.

Пример вызова функции

https://api.ispmanager.com/manager/billmgr?authinfo=user:passwd&func=service.changepricelist&elid=<код лицензии>&pricelist=<код тарифа>&sok=ok
CODE

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


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

Пример вызова функции

https://api.ispmanager.com/manager/billmgr?authinfo=user:passwd&func=soft.suspend&elid=<код лицензии>
CODE

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


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

Пример вызова функции

https://api.ispmanager.com/manager/billmgr?authinfo=user:passwd&func=soft.resume&elid=<код лицензии>
CODE

Проверка заказа лицензии


Проверить возможность заказа лицензии на определённый IP-адрес можно с помощью функции soft.checkip.

Пример вызова функции

https://api.ispmanager.com/manager/billmgr?authinfo=user:passwd&func=soft.checkip&pricelist=7&period=1&ip=82.145.17.16
CODE

Смена ключа лицензии


Для смены ключа лицензии необходимо вызвать функцию soft.edit, параметр clicked_button=newkey определяет необходимость сгенерировать новый ключ.

Пример вызова функции

https://api.ispmanager.com/manager/billmgr?authinfo=user:passwd&clicked_button=newkey&elid=2512171&func=soft.edit&sok=ok
CODE

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


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

Пример вызова функции

https://api.ispmanager.com/manager/billmgr?authinfo=user:passwd&func=soft.delete&elid=<код лицензии>
CODE

Просмотр всех лицензий ispmanager


Чтобы просмотреть все лицензии ispmanager, включая триальные, выполните запрос:

Пример запроса для просмотра списка лицензий

https://api.ispmanager.com/billmgr?authinfo=user:passwd&func=soft&project=1
CODE

Где:

  • project=1 — параметр, который указывает на провайдера