Заказ лицензий ISPsystem в BILLmanager 5

Материал из ISPWiki
Перейти к: навигация, поиск


API из BILLmanager 4 доступно и не прекратит работу. Но для большей надежности рекомендуется использовать новое API.

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

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

Значение period - это период оплаты. Для всех типов лицензии одинаково.

  • period=1 - 1 месяц
  • period=12 - 1 год
  • period=0 - вечная

addon_X - это количество узлов у некоторых видов лицензий.

Параметр autoprolong отвечает за автопродление лицензии. Возможные значения:

  • autoprolong=1 - при заказе лицензии будет выставлено автопродление на 1 месяц
  • autoprolong=12 - автопродление на год
  • autoprolong=0 - продление будет сразу до вечной лицензии
  • autoprolong=null - без автопродления

Значение pricelist для каждого вида лицензии уникально.

ISPmanager Lite
pricelist=3541
ISPmanager Business
pricelist=4601
Количество узлов:
addon_4602=количество
BILLmanager
pricelist=5577
BILLmanager Corporate
pricelist=5579
IPmanager
pricelist=2891
VMmanager KVM
pricelist=3045
Количество узлов:
addon_3049=количество
VMmanager Cloud
pricelist=3887
Количество узлов:
addon_3889=количество
VMmanager OVZ
pricelist=3651
Количество узлов:
addon_3698=количество
DCImanager
pricelist=3934
DCImanager Enterprise
pricelist=3936
DNSmanager
pricelist=3136

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

https://api.ispsystem.com/manager/billmgr?authinfo=USER:PASSWD&out=xml&func=soft.suspend&elid=код_лицензии

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

https://api.ispsystem.com/manager/billmgr?authinfo=USER:PASSWD&out=xml&func=soft.resume&elid=код_лицензии

Изменить "IP-адрес" и/или "имя лицензии":

https://api.ispsystem.com/manager/billmgr?authinfo=USER:PASSWD&out=xml&func=soft.edit&elid=334673&licname=NEWLICNAME&ip=111.222.111.223&sok=ok

Обратите внимание на то, что:
elid=334673 - это уникальный идентификатор лицензии. Посмотреть его можно при вызове списка лицензий (см. пример 1)
Параметры licname и ip можно использовать как вместе, так и по отдельности, если вы хотите изменить только один параметр.

Для лицензий 4й версии также существует поле "IP-сервера" - параметр remoteip.

Продлить лицензию (пример ISPmanager Lite (без поддержки) на 1 месяц):

https://api.ispsystem.com/manager/billmgr?authinfo=USER:PASSWD&out=xml&func=service.prolong&elid=334673&period=1&sok=ok

Проверить можно ли заказать лицензию на определенный IP-Адрес

https://api.ispsystem.com/manager/billmgr?authinfo=USER:PASSWD&out=xml&func=soft.checkip&pricelist=7&period=1&ip=82.145.17.16

Сменить ключ лицензии

https://api.ispsystem.com/manager/billmgr?authinfo=USER:PASSWD&out=xml&clicked_button=newkey&elid=2512171&func=soft.edit&sok=ok

Продление срока получения обновлений на вечных лицензиях

Для продления срока получения обновлений необходимо выполнить API запрос со следующими параметрами: func=soft.prolong.update elid=код_лицензии sok=ok

Например: https://api.ispsystem.com/manager/billmgr?authinfo=USER:PASSWD&out=xml&func=soft.prolong.update&sok=ok&elid=код_лицензии

Дополнительная информация

  • Вы можете использовать периоды без строгого соответствия. Например, чтобы при покупке в вашем биллинге лицензии на месяц, в биллинге ISPsystem покупалась вечная лицензия.Для этого необходимо создать файл конфигурации [путь до папки с BILLmanager(по умолчанию /usr/local/ispmgr)]/etc/cpbillmgr5.conf
  • После того, как все будет настроено, в cron необходимо добавить задание */5 * * * * /usr/local/ispmgr/sbin/cpbillmgr5 checkevent