Ordering ISPsystem software licenses through BILLmanager API

From ISPWiki

Jump to: navigation, search

Automatic creation (renewal) of ISPsystem software licenses is an urgent problem for us. In BILLmanager allows you to use remote call of functions, i.e. BILLmanager API. You may perform all action either manually from your browser or using remote scripts.

The examples below describe how to work with BILLmanager API. Using API you can easily create a URL of any function call. You can see the fields meaning in the BILLmanagr HTML-source, in particular in the HTML-source of the corresponding frame, as lists and forms are displayed in a separate IFRAME.

The following URL can be called not only from your browser, but also by using the programs like wget, curl, or with the function of the corresponding libraries of your programming language.

Contents

Getting the list of the licenses

https://api.ispsystem.com/manager/billmgr?authinfo=USER:PASSWD&out=xml&func=software

You will receive the XML containing the list of licenses including the following information for each license:

  • id - license id
  • price - service package name
  • period - order period name
  • expiredate - expiration date
  • project - project name
  • price_id - license package id
  • licname - license name
  • ip - license IP address
  • ipchange - IP address last change date
  • keychange - activation key last generation date
  • status - current status: 1 - ordered, 2 - active, 3 - suspended, 4 - deleted

Getting the list of the licenses that expire on October 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
https://my.ispsystem.com/manager/billmgr?authinfo=USER:PASSWD&out=xml&func=software

Creating a new license (e. g. ISPmanager Lite (without support) for 1 month)

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

The following are prices for ordering the ISPsystem software licenses:

ISPmanager 5 Lite - код тарифа  3541
ISPmanager 5 Business - 4601
VMmanager 5 KVM - 3045
VMmanager 5 OVZ - 3651
VMmanager 5 Cloud - 3887
DCImanager 5 Essential - 3932
DCImanager 5 Progressive - 3934
DCImanager 5 Enterprise - 3936
DNSmanager 5 - 3136
IPmanager 5 - 2891

The following are periods for ordering the ISPsystem software licenses:

1 month - 1
1 year - 12
lifetime - 0
trial - -100 

The following are prices and periods for ordering the ISPsystem software licenses (please note! The following information was up-to-date until we upgraded to BILLmanager 5):.

ISPmanager Lite (without support)
price=7
period=7 - trial(2 weeks)
period=8 - 1 month
period=9 - lifetime
ISPmanager Pro (without support)
price=11
period=15 - trial(2 weeks)
period=16 - 1 month
period=17 - lifetime
ISPmanager Lite
price=5
period=3 - 1 month
period=4 - 3 months
period=5 - 1 year
period=6 - lifetime 
ISPmanager Pro
price=9
period=11 - 1 month
period=12 - 3 months
period=13 - 1 year
period=14 - lifetime

Branding:

parameter bool_3215=on
ISPmanager Cluster
price=112
period=68 - trial (2 weeks)
period=69 - 1 month
period=72 - lifetime
Branding:
parameter bool_3216=on
ISPmanager 5 Lite
price=3541
period=2307 - trial(2 weeks)
period=2308 - 1 month
period=2309 - 1 year
period=2310 - lifetime
VDSmanager-Linux
price=15
period=24 - trial(2 weeks)
period=25 - 1 month
period=1702 - 1 year
period=26 - lifetime
VDSmanager-FreeBSD
price=884
period=534 - trial (2 weeks)
period=535 - 1 month
period=1701 - 1 year
period=536 - lifetime
BILLmanager Standard
price=432
period=246 - trial (2 weeks)
period=380 - 1 month
period=381 - 1 year
period=1572 - lifetime 
BILLmanager Advanced
price=434
period=247 - Триал (2 weeks)
period=382 - 1 month
period=383 - 1 year
period=1573 - lifetime
BILLmanager Corporate
price=435
period=248 - trial(2 weeks)
period=384 - 1 month
period=385 - 1 year
period=1574 - lifetime
Branding:
parameters bool_3214=on
DSmanager
price=16
period=27 - trial(2 weeks)
period=28 - 1 month
period=29 - 1 year
period=661 - lifetime
DNSmanager
price=17
period=30 - trial (2 weeks)
period=1683 - 1 month
period=1703 - 1 year
period=31 - lifetime
IPmanager 5
price=2891
period=1814 - trial(2 weeks)
period=1815 - 1 month
period=1816 - 1 year 
period=1817 - lifetime
VMmanager 5, Basic
price=3045
period=1898 - trial(2 weeks)
period=1899 - 1 month
period=1900 - 1 year
period=1901 - lifetime
Number of nodes:
parameteraddon_3049=number
VMmanager 5, Cloud
price=3887
period=2514 - trial(2 weeks)
period=2515 - 1 month
period=2516 - 1 year
period=2517 - lifetime
Number of nodes:
parameter addon_3698=number
VEmanager 5
price=3651
period=2363 - trial(2 weeks)
period=2364 - 1 month
period=2365 - 1 year
period=2366 - lifetime
Number of nodes:
parameter addon_3698=number
DCImanager 5 Essential
price=3932
period=2543 - trial(2 weeks)
period=2544 - 1 month
period=2545 - 1 year
period=2546 - lifetime
DCImanager 5 Progressive
price=3934
period=2547 - trial(2 weeks)
period=2548 - 1 month
period=2549 - 1 year
period=2550 - lifetime
DCImanager 5 Enterprise
price=3936
period=2551 - trial (2 weeks)
period=2554 - lifetime
DNSmanager 5
price=3136
period=1926 - trial(2 weeks)
period=1927 - 1 month
period=1928 - 1 year
period=1929 - lifetime

Disabling a license

https://api.ispsystem.com/manager/billmgr?authinfo=USER:PASSWD&out=xml&func=software.disable&elid=license_id

Activating a license

https://api.ispsystem.com/manager/billmgr?authinfo=USER:PASSWD&out=xml&func=software.enable&elid=license_id

Checking IP-address availability

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

Changing the "IP address" and/or "license name"

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

Please note:

elid=334673 is a license unique identifier. You can locate it by calling the list of licenses (see Example 1)
The licname and ip parameters can be used together or separately, if you wish to edit only one parameter. 

Please note, that you may change IP-address only once a month.

Renewing an existing license (e.g.ISPmanager Lite (without support) for 1 month)

https://my.ispsystem.com/manager/billmgr?authinfo=USER:PASSWD&out=xml&func=software.period&elid=334673&period=8&sok=ok

Please, note!

elid=334673 is a license unique identifier. You can get the id by calling the list of licenses (see Example 1)
period=8 - period 8 is available for the Litе license only, if you wish to renew Pro for 1 month, use period=16

Please, be attentive to the the answers that you receive. If the operation has been successfully completed, you will receive the XML-document with the <ok/> tag. If an error occurred, an <error/> tag with the corresponding error code (see Error codes(ISPmanager)) will be shown. Use the same procedure when performing any other operation.

Was this helpful? Yes | No
Personal tools