Перепродажа модулей ispmanager через API

Модули ispmanager — это платные расширения функционала панели, оформляемые в личном кабинете в разделе Лицензии → Модули ispmanager. Лицензии на модули действуют только на серверах с ispmanager, а их установка и настройка происходит через веб-интерфейс панели.

Автоматизация перепродажи модулей ispmanager с помощью API позволяет гибко управлять продажами и обслуживанием клиентов, а также адаптировать процесс под собственные потребности и стратегию бизнеса.

Схема перепродажи

Выбор и заказ модуля. Находясь в панели ispmanager, конечный клиент видит цены на модули, которые установил партнер. Он выбирает нужный модуль и нажимает кнопку Купить.
Перенаправление в биллинг партнера. После нажатия на кнопку Купить происходит автоматическое перенаправление в биллинг партнера. Здесь конечный клиент продолжает оформление заказа и оплачивает выбранный модуль.
Заказ модуля в личном кабинете ispmanager. Далее партнер обрабатывает заказ конечного клиента и покупает модуль в личном кабинете ispmanager. Для этого настраивается автоматизация через API, либо совершается покупка вручную.
Обновление информации о модуле в панели. После успешной обработки заказа, панель ispmanager обновляет данные о лицензии и получает информацию о купленном модуле. Это гарантирует корректную активацию и использование модуля со стороны конечного клиента.
Активация и управление модулями. Конечный клиент активирует модуль через панель и управляет им через свой личный кабинет в биллинге партнера.

Шаг 1. Настройка биллинга парнера

Чтобы в панели ispmanager для конечных клиентов отображались цены партнера на модули, реализуйте в партнерском биллинге обработку GET-запросов на получение цен.

Пример запроса:

https://api.БИЛЛИНГ_ПАРТНЕРА.com/?func=pricelist.export&itemtype=addition&onlyavailable=on

Подробнее

itemtype — фильтр по типу продукта. Возможные значения:
- addition — модули

Дополнительные параметры:

onlyavailable=on — фильтр, означающий только доступные модули

Панель ispmanager ожидает ответ в формате XML. Например:

<doc>
  <pricelist>
    <id>23221</id>
<name>DDoS-GUARD</name>
   <intname>DDoSGUARD</intname>
    <additionintname>DDoSGUARD</additionintname>
    <price currency="RUB">
      <period cost="950.0000" type="month" length="1">monthly</period>
    </price>
  </pricelist>
</doc>

Подробнее

id — идентификатор тарифа модуля
additionintname — служебное название модуля, предоставляющее информацию о типе или категории модуля
price — стоимость модуля за указанный период времени. При покупке и загрузке цены всегда используется с параметрами цены за месяц type="month" и length="1"
intname — еще одно служебное название модуля, предоставляющее информацию о типе или категории модуля
name — название модуля

Если цены на модуль отсутствуют в XML-ответе, модуль не отобразится в веб-интерфейсе панели ispmanager, и кнопка Купить не появится.

Не будут отображаться неподдерживаемые модули, даже если цены для них указаны в XML. Например, модуль LiteSpeed WebHost Essential для ispmanager хост не отобразится в панели с тарифом лайт. Произвольные модули, несовместимые с ispmanager, добавить нельзя.

Шаг 2. Обработка заказа

В момент покупки модуля в панели ispmanager формируется запрос в биллинг партнера. Например:

https://URL_БИЛЛИНГА_ПАРТНЕРА/?module=СЛУЖЕБНОЕ_ИМЯ_МОДУЛЯ&license=ID_ЛИЦЕНЗИИ&ip=<IP_ЛИЦЕНЗИИ>&module_id=ID_МОДУЛЯ

Этот запрос может быть обработан автоматически через API или вручную.

Для ручной обработки

Авторизуйтесь в личном кабинете ispmanager и закажите модуль вручную.
Обработайте заказ в биллинге партнера.

Далее представлены функции автоматического заказа и управления модулями в системе ispmanager с использованием API.

Для всех функций поддерживаются GET и POST запросы.

Все запросы выполняются с реальными данными в вашем реальном личном кабинете ispmanager. При выполнении заказа с параметром skipbasket=on заказ будет совершен сразу, а с баланса аккаунта спишутся средства.

Перед выполнением запроса выберите API-адрес личного кабинета ispmanager, через который будет осуществляться перепродажа:

{ "openapi": "3.0.4", "info": {"version": "1.0.0" }, "servers": [ { "url": "https://api.ispmanager.ru", "description": "API адрес личного кабинета my.ispmanager.ru" }, { "url": "https://api-eu.ispmanager.com", "description": "API адрес личного кабинета eu.ispmanager.com" } ], "tags": [ { "name": "Действия с модулями для ispmanager" } ], "paths": { "/?func=pricelist.export": { "parameters": [ { "$ref": "#/components/parameters/authinfoNotRequired" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "pricelist.export" ] } }, { "name": "itemtype", "in": "query", "required": true, "description": "**Тип услуги**\n- **addition** — модули для ispmanager", "schema": { "type": "string", "enum": [ "addition" ] } }, { "$ref": "#/components/parameters/out" } ], "get": { "tags": [ "Действия с модулями для ispmanager" ], "summary": "Список всех тарифов", "responses": { "200": { "description": "ok" } } } }, "/?func=addition": { "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "addition" ] } }, { "$ref": "#/components/parameters/out" } ], "get": { "tags": [ "Действия с модулями для ispmanager" ], "summary": "Список всех модулей на аккаунте, в т. ч. лежащих в корзине, которые не оплачены", "responses": { "200": { "description": "ok" } } } }, "/mancgi/bitninja_check_email.py": { "get": { "tags": [ "Действия с модулями для ispmanager" ], "summary": "Проверка возможности использования электронной почты для заказа BitNinja", "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "email", "in": "query", "required": true, "description": "**Электронная почта для проверки**", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "doc": { "type": "object", "properties": { "$status": { "type": "string", "enum": [ "busy" ] } } } } }, { "type": "object", "properties": { "doc": { "type": "object", "properties": { "$status": { "type": "string", "enum": [ "free" ] } } } } }, { "type": "object", "properties": { "doc": { "type": "object", "properties": { "$status": { "type": "string", "enum": [ "linked to your account" ] } } } } }, { "type": "object", "properties": { "doc": { "type": "object", "properties": { "error": { "type": "object", "properties": { "$type": { "type": "string", "enum": [ "client" ] }, "$object": { "type": "string", "enum": [ "error" ] }, "detail": { "type": "object", "properties": { "$": { "type": "string" } } } } } } } } } ] }, "examples": { "busy": { "summary": "Адрес занят", "value": { "doc": { "$status": "busy" } } }, "free": { "summary": "Адрес свободен", "value": { "doc": { "$status": "free" } } }, "linked": { "summary": "Адрес привязан к вашему аккаунту", "value": { "doc": { "$status": "linked to your account" } } }, "error": { "summary": "Ошибка (неверные учетные данные)", "value": { "doc": { "error": { "$type": "client", "$object": "error", "detail": { "$": "Invalid username or password " } } } } } } } } } } } }, "/?func=addition.order.param": { "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "addition.order.param" ] } }, { "$ref": "#/components/parameters/periodWithTrial" }, { "$ref": "#/components/parameters/pricelistAddition" }, { "name": "item", "description": "**ID лицензии ispmanager, для которой приобретается модуль**", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "domain", "description": "**Доменное имя**\n- Обязательно для DDoS-GUARD", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "target_ip", "description": "**IP-адрес ресурса**\n- Обязательно для DDoS-GUARD", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "bitninja_email", "description": "**Электронная почта**\n- Только для BitNinja", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "addon_55391", "description": "**Количество защищенных сайтов**\n- Возможные значения — от 10 до 1000. Шаг — 10\n- Обязательно для Blackwall (платная версия)", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 10, "maximum": 1000, "multipleOf": 10 } }, { "name": "addon_55399", "description": "**Количество генераций сайтов**\n- Возможные значения — от 10 до 1000. Шаг — 10\n- Обязательно для AI WordPress (для api-eu.ispmanager.com)", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 10, "maximum": 1000, "multipleOf": 10 } }, { "name": "addon_55405", "description": "**Количество генераций сайтов**\n- Возможные значения — от 10 до 1000. Шаг — 10\n- Обязательно для AI WordPress (для api.ispmanager.ru)", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 10, "maximum": 1000, "multipleOf": 10 } }, { "$ref": "#/components/parameters/autoprolong" }, { "$ref": "#/components/parameters/skipbasket" }, { "$ref": "#/components/parameters/comment" }, { "$ref": "#/components/parameters/out" }, { "$ref": "#/components/parameters/sok" } ], "get": { "tags": [ "Действия с модулями для ispmanager" ], "summary": "Заказ модуля", "responses": { "200": { "description": "ok" } } } }, "/?func=addition.edit": { "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "addition.edit" ] } }, { "$ref": "#/components/parameters/elidForAddition" }, { "$ref": "#/components/parameters/autoprolong" }, { "name": "item", "description": "**ID лицензии ispmanager, для которой был приобретен модуль**", "in": "query", "schema": { "type": "integer" } }, { "name": "domain", "description": "**Доменное имя, для которого был заказан модуль**\n- Только для модуля DDoS-GUARD", "in": "query", "schema": { "type": "string" } }, { "name": "target_ip", "description": "**IP-адрес, для которого был заказан модуль**\n- Только для модуля DDoS-GUARD", "in": "query", "schema": { "type": "integer" } }, { "name": "comment", "description": "**Комментарий к услуге**", "in": "query", "schema": { "type": "string" } }, { "$ref": "#/components/parameters/out" }, { "name": "sok", "description": "**Подтверждение операции**", "in": "query", "schema": { "type": "string", "enum": [ "ok" ] } } ], "get": { "tags": [ "Действия с модулями для ispmanager" ], "summary": "Просмотр и изменение информации по одному модулю", "description": "Для просмотра информации укажите только обязательные параметры. Для изменения параметров укажите новое значение в соответствующем поле и выберите **ok** в поле **sok**", "responses": { "200": { "description": "ok" } } } }, "/?func=service.prolong": { "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "service.prolong" ] } }, { "$ref": "#/components/parameters/elid" }, { "$ref": "#/components/parameters/period" }, { "$ref": "#/components/parameters/out" }, { "$ref": "#/components/parameters/sok" } ], "get": { "tags": [ "Действия с модулями для ispmanager" ], "summary": "Продление модуля", "description": "Услуга будет продлена сразу после выполнения запроса, поэтому на балансе личного кабинета должно быть достаточно средств", "responses": { "200": { "description": "ok" } } } }, "/?func=service.changepricelist": { "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "service.changepricelist" ] } }, { "$ref": "#/components/parameters/elidForAddition" }, { "name": "pricelist", "description": "**ID тарифа модуля**\n\n**Для api.ispmanager.ru:**\n- **55393** — LiteSpeed WebHost Essential для ispmanager лайт\n- **55398** — LiteSpeed WebHost Essential для ispmanager про\n- **55400** — LiteSpeed WebHost Essential для ispmanager хост\n- **55401** — LiteSpeed WebHost Professional\n- **55402** — LiteSpeed WebHost Enterprise\n- **55403** — LiteSpeed WebHost Elite \n\n**Для api-eu.ispmanager.com:**\n- **55380** — LiteSpeed WebHost Essential для ispmanager лайт\n- **55382** — LiteSpeed WebHost Essential для ispmanager про\n- **55378** — LiteSpeed WebHost Essential для ispmanager хост\n- **55384** — LiteSpeed WebHost Professional\n- **55376** — LiteSpeed WebHost Enterprise\n- **55386** — LiteSpeed WebHost Elite\n- **55390** — Blackwall (бесплатная версия)\n- **55372** — Blackwall (платная версия)", "in": "query", "required": true, "schema": { "type": "integer" } }, { "$ref": "#/components/parameters/out" }, { "$ref": "#/components/parameters/sok" } ], "get": { "tags": [ "Действия с модулями для ispmanager" ], "summary": "Смена тарифа модуля", "description": "Для смены тарифа выберите ID нового тарифа в поле **pricelist**. Доступно для модулей LiteSpeed и Blackwall", "responses": { "200": { "description": "ok" } } } }, "/?func=addition.suspend": { "get": { "tags": [ "Действия с модулями для ispmanager" ], "summary": "Выключение модуля", "description": "Политики выключения и включения модулей могут различаться и зависят от вендора", "responses": { "200": { "description": "ok" } } }, "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "addition.suspend" ] } }, { "$ref": "#/components/parameters/elid" }, { "$ref": "#/components/parameters/out" } ] }, "/?func=addition.resume": { "get": { "tags": [ "Действия с модулями для ispmanager" ], "summary": "Включение модуля", "description": "Политики выключения и включения модулей могут различаться и зависят от вендора", "responses": { "200": { "description": "ok" } } }, "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "addition.resume" ] } }, { "$ref": "#/components/parameters/elid" }, { "$ref": "#/components/parameters/out" } ] }, "/?func=service.history": { "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "service.history" ] } }, { "$ref": "#/components/parameters/elid" }, { "$ref": "#/components/parameters/out" } ], "get": { "tags": [ "Действия с модулями для ispmanager" ], "summary": "Просмотр истории услуги", "responses": { "200": { "description": "ok" } } } }, "/?func=addition.delete": { "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "addition.delete" ] } }, { "$ref": "#/components/parameters/elidForAddition" }, { "$ref": "#/components/parameters/out" } ], "get": { "tags": [ "Действия с модулями для ispmanager" ], "summary": "Удаление модуля", "responses": { "200": { "description": "ok" } } } } }, "components": { "parameters": { "authinfo": { "name": "authinfo", "description": "**Логин и пароль в формате ЛОГИН:ПАРОЛЬ**", "in": "query", "required": true, "schema": { "type": "string" } }, "authinfoNotRequired": { "name": "authinfo", "description": "**Логин и пароль в формате ЛОГИН:ПАРОЛЬ**\n- Для api.ispmanager.ru параметр обязателен", "in": "query", "required": false, "schema": { "type": "string" } }, "out": { "name": "out", "description": "**Формат ответа**\n- **xml** — данные будут возвращены в формате XML (без пагинации и фильтра)\n- **devel** — XML, в котором дополнительно присутствуют данные, описывающие интерфейс пользователя (полезно для отладки своих плагинов)\n- **text** — данные в текстовом формате (без пагинации и фильтра)\n- **sjson** — данные в формате JSON\n- **json** — аналогично sjson, только Pretty Print (полезно для отладки)\n- **JSONdata** — аналогично json, но без описаний интерфейса, только данные (без пагинации и фильтра)\n- **xjson** — аналогично формату вывода по умолчанию (HTML) только в формате JSON (рекомендуется для создания собственных тем оформления)\n- **bjson** — данные в формате JSON, но более структурированном виде в отличие от sjson. Рекомендуется для работы с API по умолчанию\n- **print** — HTML, пригодный для печати. Работает только для списков данных", "in": "query", "schema": { "type": "string", "enum": [ "xml", "devel", "text", "sjson", "json", "JSONdata", "xjson", "bjson", "print" ], "example": "bjson" } }, "period": { "name": "period", "description": "**Период оплаты в месяцах**\n- Значения **3** и **6** месяцев доступны только для BitNinja, DDosGuard и Litespeed", "in": "query", "required": true, "schema": { "type": "integer", "enum": [ 1, 3, 6, 12 ] } }, "pricelistAddition": { "name": "pricelist", "description": "**ID тарифа модуля**\n\n**Для api.ispmanager.ru:**\n- **55404** — Конструктор сайтов AI WordPress\n- **23221** — DDoS-GUARD\n- **55390** — BitNinja\n- **55393** — LiteSpeed WebHost Essential для ispmanager лайт\n- **55398** — LiteSpeed WebHost Essential для ispmanager про\n- **55400** — LiteSpeed WebHost Essential для ispmanager хост\n- **55401** — LiteSpeed WebHost Professional\n- **55402** — LiteSpeed WebHost Enterprise\n- **55403** — LiteSpeed WebHost Elite \n\n**Для api-eu.ispmanager.com:**\n- **55398** — Конструктор сайтов AI WordPress\n- **23221** — DDoS-GUARD\n- **55371** — BitNinja\n- **55380** — LiteSpeed WebHost Essential для ispmanager лайт\n- **55382** — LiteSpeed WebHost Essential для ispmanager про\n- **55378** — LiteSpeed WebHost Essential для ispmanager хост\n- **55384** — LiteSpeed WebHost Professional\n- **55376** — LiteSpeed WebHost Enterprise\n- **55386** — LiteSpeed WebHost Elite\n- **55390** — Blackwall (бесплатная версия)\n- **55372** — Blackwall (платная версия)", "in": "query", "required": true, "schema": { "type": "integer" } }, "sok": { "name": "sok", "description": "**Подтверждение операции**", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "ok" ] } }, "elid": { "name": "elid", "description": "**ID лицензии модуля**", "in": "query", "required": true, "schema": { "type": "integer" } }, "elidForAddition": { "name": "elid", "description": "**ID лицензии модуля**", "in": "query", "required": true, "schema": { "type": "integer" } }, "autoprolong": { "name": "autoprolong", "description": "**Период автопродления в месяцах**\n- Должно быть равно значению **period**\n- Если будет указано другое значение или **null**, или параметр вообще не передан, то автопродление не будет подключено для услуги", "in": "query", "schema": { "type": "string" } }, "skipbasket": { "name": "skipbasket", "description": "**Списать средства и активировать услугу сразу, игнорируя корзину**", "in": "query", "schema": { "type": "string", "enum": [ "off", "on" ] } }, "periodWithTrial": { "name": "period", "description": "**Период оплаты в месяцах**\n- Значения **3** и **6** месяцев доступны только для BitNinja, DDosGuard и Litespeed\n- Значение **-100** означает триальный период и доступно только для BitNinja", "in": "query", "required": true, "schema": { "type": "integer", "enum": [ 1, 3, 6, 12, -100 ] } }, "comment": { "name": "comment", "description": "**Комментарий**\n- Упростит поиск модуля в списке заказов", "in": "query", "required": false, "schema": { "type": "string" } } } } }

Шаг 3. Обновление данных о лицензии

Информация о лицензии и приобретенных модулях обновляется автоматически 1 раз в сутки. Чтобы ускорить этот процесс, обновите данные вручную в разделе панели ispmanager Управление лицензией:

Для партнеров

Перепродажа модулей ispmanager через API

Схема перепродажи

Шаг 1. Настройка биллинга парнера

Шаг 2. Обработка заказа

Шаг 3. Обновление данных о лицензии