Заказ лицензий ПО ISPsystem с использованием BILLmanager API
Материал из ISPWiki
Создание (продление) лицензий на программные продукты компании ISPsystem в автоматическом режиме - это актуальный вопрос, на который нам постоянно приходится отвечать. BILLmanager, как и любой другой продукт нашей компании, обладает 100% поддержкой удалённого вызова функций - API. Все действия, которые Вы можете выполнять из браузера вручную, можно выполнить и удалёнными скриптами.
Ниже мы приведём пару примеров по работе с API BILLmanager. Поняв принцип работы API, Вы легко сможете создать URL вызова любой необходимой вам функции. Значения полей легко узнать, заглянув в исходный код страницы BILLmanager, точнее в HTML-код соответствующей таблицы, так как списки и формы отображаются в отдельных таблицах.
Приведённые ниже URL можно вызывать не только в браузере, но и программами типа wget, curl и т.д. или с помощью функций соответствующих библиотек Вашего любимого языка программирования.
Получить список лицензий:
https://my.ispsystem.com/manager/billmgr?authinfo=USER:PASSWD&out=xml&func=software
Получить список лицензий, истекающих в период с 15 по 25 октября 2009 года:
https://my.ispsystem.com/manager/billmgr?authinfo=USER:PASSWD&out=xml&func=software.filter&expires=2009-10-15&expiree=2009-10-25&sok=ok&filter=yes https://my.ispsystem.com/manager/billmgr?authinfo=USER:PASSWD&out=xml&func=software&filter=yes
Создать новую лицензию (пример ISPmanager Lite (без поддержки) на 1 месяц):
https://my.ispsystem.com/manager/billmgr?authinfo=USER:PASSWD&out=xml&func=software.edit&price=7&period=8&licname=LICNAME&ip=111.222.111.222&sok=ok
Значения price и period для заказа лицензий
ISPmanager Lite (без поддержки) price=7 period=7 - Триал (2 недели) period=8 - 1 месяц period=9 - вечная
ISPmanager Pro (без поддержки) price=11 period=15 - Триал (2 недели) period=16 - 1 месяц period=17 - вечная
VDSmanager-Linux price=15 period=24 - Триал (2 недели) period=25 - 1 месяц period=26 - вечная
VDSmanager-FreeBSD price=884 period=534 - Триал (2 недели) period=535 - 1 месяц period=536 - вечная
BILLmanager Standard price=432 period=246 - Триал (2 недели) period=380 - 1 месяц period=381 - 1 год
BILLmanager Advanced price=434 period=247 - Триал (2 недели) period=382 - 1 месяц period=383 - 1 год
BILLmanager Corporate price=435 period=248 - Триал (2 недели) period=384 - 1 месяц period=385 - 1 год
DSmanager price=16 period=27 - Триал (2 недели) period=28 - 1 месяц period=29 - 1 год period=661 - вечная
DNSmanager price=17 period=30 - Триал (2 недели) period=31 - вечная
IPmanager price=18 period=32 - Триал (2 недели) period=33 - вечная
Проверить IP-адрес на занятость
https://my.ispsystem.com/manager/billmgr?authinfo=USER:PASSWD&out=xml&func=software.licinfo&sok=ok&price=7&period=8&ip=111.222.111.222
Изменить "IP-адрес" и/или "имя лицензии":
https://my.ispsystem.com/manager/billmgr?authinfo=USER:PASSWD&out=xml&func=software.edit&elid=334673&licname=NEWLICNAME&ip=111.222.111.223&sok=ok
Обратите внимание на то, что:
elid=334673 - это уникальный идентификатор лицензии. Посмотреть его можно при вызове списка лицензий (см. пример 1) Параметры licname и ip можно использовать как вместе, так и по отдельности, если вы хотите изменить только один параметр.
Помните, что смена IP-адреса лицензии невозможна чаще одного раза в месяц.
Продлить лицензию (пример ISPmanager Lite (без поддержки) на 1 месяц):
https://my.ispsystem.com/manager/billmgr?authinfo=USER:PASSWD&out=xml&func=software.period&elid=334673&period=8&sok=ok
Обратите внимание, что:
elid=334673 - это уникальный идентификатор лицензии. Посмотреть его можно при вызове списка лицензий (см. пример 1) period=8 - период 8 действует только для лицензии Litе, для Pro свой период продления на 1 месяц, а именно period=16
Всегда анализируйте то, что получите в ответ. Если операция выполнена успешно, то в ответ Вы получите XML-документ, содержащий тег <ok/>. Если произошла ошибка - тег <error/> с кодом ошибки (см. Коды ошибок).
Аналогичным образом можно выполнить любое другое действие.
