Лицензии BitNinja

Речь о лицензии BitNinja, которую можно приобрести в разделе Лицензии → Сторонние лицензии личного кабинета. Эту версию можно использовать на сервере без ispmanager. Установка происходит через консоль сервера.

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

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

  • period — период действия услуги. Возможные значения:
    • period=1 — покупка лицензии на 1 месяц;
    • period=3 — покупка лицензии на 3 месяца;
    • period=6 — покупка лицензии на 6 месяцев;
    • period=12 — покупка лицензии на 1 год;
    • period=-100 — заказ триальной лицензии.
  • pricelist — код тарифного плана. Возможные значения:
    • pricelist=55391 — если заказ через https://api.ispmanager.ru;
    • pricelist=55369 — если заказ через https://api-eu.ispmanager.com.
  • licname — название лицензии. Возможно написание как русскими, так и латинскими буквами. Ограничение в 255 символов.
  • skipbasket — списать средства и активировать услугу сразу, игнорируя корзину. Возможные значения:
    • skipbasket=on — игнорировать корзину. Заказать, списать средства и сразу активировать услугу;
    • skipbasket=off — положить в корзину. Заказать, но не активировать, услуга ждёт оплаты в корзине.
  • autoprolong — автопродление. Должно быть равно значению period. Если будет указано другое значение, автопродление не будет подключено для услуги. Возможные значения:
    • autoprolong=1 — автопродление на 1 месяц;
    • autoprolong=3 — автопродление на 3 месяца;
    • autoprolong=6 — автопродление на 6 месяцев;
    • autoprolong=12 — автопродление на 1 год;
    • autoprolong=null — без автопродления.
Пример заказа лицензии
https://api.ispmanager.ru/manager/billmgr?authinfo=user:passwd&func=softexternal.order.param&period=1&pricelist=55391&licname=name&autoprolong=1&sok=ok&skipbasket=on

В результате запроса будет оплачена и сразу активирована лицензия BitNinja сроком на 1 месяц в личном кабинете my.ispmanager.ru. С названием name и автопродлением на 1 месяц.

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

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

  • elid — ID услуги;
  • period — период действия услуги. Возможные значения:
    • period=1 — 1 месяц;
    • period=3 — 3 месяца;
    • period=6 — 6 месяцев;
    • period=12 — 1 год.

Услуга будет продлена сразу после выполнения запроса, поэтому на балансе личного кабинета должно быть достаточно средств.

Пример продления лицензии
https://api.ispmanager.ru/manager/billmgr?authinfo=user:passwd&func=service.prolong&elid=123456789&period=1&sok=ok

В результате лицензия BitNinja с ID 123456789 будет продлена на 1 месяц. Средства спишутся с баланса аккаунта.

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

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

  • elid — ID услуги.
Пример удаления лицензии
https://api.ispmanager.ru/manager/billmgr?authinfo=user:passwd&func=softexternal.delete&elid=123456789

В результате лицензия BitNinja с ID 123456789 будет удалена из личного кабинета.

Просмотр лицензий BitNinja

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

  • out — вывод данных. Возможные значения:
    • out=xml — данные будут возвращены в формате XML (без пагинации и фильтра);
    • out=devel — то же самое, что XML, но в документе будут присутствовать данные, описывающие интерфейс пользователя (полезно для отладки своих плагинов);
    • out=text — данные в текстовом формате(без пагинации и фильтра);
    • out=sjson — данные в формате JSON;
    • out=json — то же самое, что и sjson, только Pretty Print (полезно для отладки);
    • out=JSONdata — то же самое что и JSON, но без описаний интерфейса, только данные (без пагинации и фильтра);
    • out=xjson — аналогично дефолтному формату вывода (html) только в формате JSON (рекомендуется для создания своих тем оформления);
    • out=print — html пригодный для печати, работает только для списков данных;
Пример просмотра информации о лицензиях
https://api.ispmanager.ru/manager/billmgr?authinfo=user:passwd&func=softexternal&out=json

В результате будет получена JSON строка, где в elem будет массив всех лицензий BitNinja.

Если нужно просмотреть данные одной лицензии BitNinja, то используйте функцию softexternal.edit с параметрами:

  • elid — ID услуги;
  • out — вывод данных.
Пример просмотра информации об одной лицензии
https://api.ispmanager.ru/manager/billmgr?authinfo=user:passwd&func=softexternal.edit&elid=123456789&out=json

В результате будет получена JSON строка, где будет информация об одной лицензии BitNinja с ID 123456789.