Commander les licences d'ISPsystem via API de BILLmanager

De ISPWiki.

La création automatique (le renouvellement) des licences pour le logiciel de la société ISPsystem est une question fréquemment posée.

BILLmanager détient le support de l'appel distant des fonctions - API. Vous pouvez réaliser les actions via le navigateur manuellement ainsi que via les scripts distants.

Veuillez consulter certains exemples qui vous disent comment fonctionner sous API de BILLmanager. Vous pouvez créer l'appel d'url de toute fonction à l'aide d'API. Veuillez savoir les valeurs des champs en utilisant le code initial de la page de BILLmanager, plus précisément en utilisant le code-HTML du tableau approprié.

Vous pouvez appeler l'url ci-dessous cité via le navigateur, à l'aide des programmes tels que wget, curl et etc. ou à l'aide des fonctions des bibliothèques appropriées de votre langage de programmation préféré.

1. Obtenir la liste de licences:

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

1а. Obtenir la liste de licences de 15 à 25 octobre 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

2. Créer une nouvelle licence (exemple d'ISPmanager Lite (sans support) pour un mois):

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

Les valeurs de Price et de pPriod pour commander la licence d'ISPmanager

ISPmanager Lite (sans support)
price=7
period=7 - Période d'essai (2 semaines)
period=8 - 1 mois
period=9 - perpétuelle

ISPmanager Pro (sans support)
price=11
period=15 - Période d'essai (2 semaines)
period=16 - 1 mois
period=17 - perpétuelle

3. Renouveler la licence (exemple d'ISPmanager Lite (sans support) pour 1 mois):

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

Attention:

elid=334673 - un identificateur de la licence. Vous pouvez le savoir en demandant la liste de licences (vois. exemple 1)
period=8 - la période 8 est accessible seulement pour la licence Litе. La période de renouvellement pour un mois est accessible pour Pro, à savoir  period=16

Si l'action a été réussie, vous recevrez le document-XML avec la balise <ok/>. S'il y avait une erreur, vous recevrez la balise <error/> avec le code d'erreur (voir. Code des erreurs).

Toutes les procédures sont effectuées analogiquement.