Лицензии ispmanager

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

Авторизация

https://api.ispmanager.ru — API адрес личного кабинета для клиентов из РФ.

https://api-eu.ispmanager.com — API адрес личного кабинета для клиентов из других стран.

Авторизация в системе происходит с помощью параметра authinfo, который принимает значение user:passwd, где user — имя пользователя в личном кабинете, а passwd — пароль пользователя.

Пример авторизации
https://api.ispmanager.ru/manager/billmgr?authinfo=user:passwd

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

Для заказа используйте функцию soft.order.param с параметрами:

  • sok=ok — подтверждение операции, обязательный параметр.
  • skipbasket — списать средства и активировать услугу сразу, игнорируя корзину. Возможные значения:
    • skipbasket=on — игнорировать корзину. Заказать, списать средства и сразу активировать услугу;
    • skipbasket=off — положить в корзину. Заказать, но не активировать, услуга ждёт оплаты в корзине.
  • ip — IP-адрес заказываемой лицензии.
  • licname — название заказываемой лицензии.
  • period — период оплаты лицензии. Может принимать значения:
    • period=1 — 1 месяц;
    • period=12 — 1 год.
  • autoprolong — параметр, отвечающий за автопродление лицензии. Возможные значения:
    • autoprolong=1 — при заказе лицензии будет выставлено автопродление на 1 месяц;
    • autoprolong=12 — автопродление на год;
    • autoprolong=null — без автопродления.
  • pricelist — код тарифного плана. Значения будут зависеть от страны регистрации аккаунта, который используется для перепродажи.

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

    ТарифКод тарифа
    Ispmanager 6 trial55235
    Ispmanager 6 business trial55241
    Ispmanager 6 lite55231
    Ispmanager 6 pro55232
    Ispmanager 6 host55233
    Ispmanager 6 business55234

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

    ТарифКод тарифа
    Ispmanager 6 trial55239
    Ispmanager 6 business trial55240
    Ispmanager 6 lite55227
    Ispmanager 6 pro55228
    Ispmanager 6 host55229
    Ispmanager 6 business55230
  • addon_X — количество узлов у лицензий ispmanager 6 business. Возможные значения:
    • addon_55237=<количество> — для клиентов РФ;
    • addon_55236=<количество>  для клиентов других стран.

Пример заказа лицензии
https://api.ispmanager.ru/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
Если возникает ошибка "subaccount_disabled:The client's account is suspended by administrator", убедитесь, что код тарифа указан для подходящей страны регистрации клиента.

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

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

  • elid — ID продлеваемой лицензии.
  • period — период продления. Может принимать значения:
    • period=1 — 1 месяц;
    • period=12 — 1 год.
Пример продления лицензии с ID 334673 на 1 месяц
https://api.ispmanager.ru/manager/billmgr?authinfo=user:passwd&func=service.prolong&elid=334673&period=1&sok=ok

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

https://api.ispmanager.ru/billmgr?authinfo=user:passwd&func=soft

Получение информации одной лицензии

https://api.ispmanager.ru/manager/billmgr?authinfo=user:passwd&func=soft.edit&elid=<ИД лицензии>