Перепродажа лицензий ispmanager через API

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

Схема перепродажи лицензий ispmanager через API

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

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

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

Пример запроса на продление лицензии:

https://api.БИЛЛИНГ_ПАРТНЕРА.com/?action=prolong&query=startform%3Dservice.prolong%26utm_source%3Dispmanager_panel%26elid%3D8898549%26utm%5Fsource%3Dispmanager%5Fpanel&license=8898549&ip=37%2E230%2E114%2E96&utm_source=ispmanager_panel

Подробнее

action — тип вызванного действия: prolong — продление
license — ID лицензии
ip — основной IP-адрес на сервере с ispmanager

Пример запроса на смену тарифа лицензии:

https://api.БИЛЛИНГ_ПАРТНЕРА.com/?action=changepricelist&query=startform%3Dservice%2Echangepricelist%2Egetmoney%26pricelist%3D55231%26elid%3D8898549%26utm%5Fsource%3Dispmanager%5Fpanel&license=8898549&ip=37%2E230%2E114%2E96&utm_source=ispmanager_panel&pricelist=IM6L

Подробнее

action — тип вызванного действия: changepricelist — смена тарифа
pricelist — ID нового тарифа
ip — основной IP-адрес на сервере с ispmanager

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

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

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

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

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

{ "openapi": "3.0.4", "info": {"version": "1.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": { "get": { "tags": [ "Действия с лицензиями ispmanager" ], "summary": "Список всех тарифов ispmanager", "responses": { "200": { "description": "ok" } } }, "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- **soft** — лицензии ispmanager", "schema": { "type": "string", "enum": [ "soft" ] } }, { "$ref": "#/components/parameters/out" } ] }, "/?func=soft": { "get": { "tags": [ "Действия с лицензиями ispmanager" ], "summary": "Список всех лицензий ispmanager на аккаунте, в т. ч. лежащих в корзине, которые не оплачены", "responses": { "200": { "description": "ok" } } }, "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "soft" ] } }, { "$ref": "#/components/parameters/out" } ] }, "/?func=soft.checkip": { "get": { "tags": [ "Действия с лицензиями ispmanager" ], "summary": "Проверка возможности заказа лицензии на IP-адрес", "responses": { "200": { "description": "- Наличие объекта **error** означает, что при проверке произошла ошибка.\n- Значение \"$type\": \"exists\" означает, что для указанного IP-адреса уже существует лицензия.\n- Любые другие ошибки говорят о том, что сервис временно недоступен.\n- Если объект **error** отсутствует, лицензия для IP-адреса не найдена, и можно выполнять заказ новой лицензии.", "content": { "application/json": { "schema": { "type": "object", "properties": { "doc": { "type": "object", "properties": { "error": { "type": "object", "description": "Ошибка", "properties": { "$type": { "type": "string", "description": "Тип ошибки", "enum": ["exists"] } }, "required": ["$type"] } } } } }, "example": { "doc": { "error": { "$type": "exists", "$object": "ip", "$lang": "ru", "group": { "$": "__object__ со значением '__value__' уже существует" }, "msg": { "$": "IP-адрес со значением '1.1.1.1' уже существует" }, "param": [ { "$name": "object", "$type": "msg", "$msg": "IP-адрес", "$": "ip" }, { "$name": "value", "$": "1.1.1.1" } ], "stack": { "action": { "$level": "16", "$user": "1234567", "$": "soft.checkip" } } } } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "soft.checkip" ] } }, { "$ref": "#/components/parameters/pricelist" }, { "name": "ip", "description": "IP-адрес лицензии ispmanager", "in": "query", "required": true, "schema": { "type": "string" } } ] }, "/?func=soft.order.param": { "get": { "tags": [ "Действия с лицензиями ispmanager" ], "summary": "Заказ лицензии ispmanager", "responses": { "200": { "description": "ok" } } }, "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "soft.order.param" ] } }, { "$ref": "#/components/parameters/period" }, { "$ref": "#/components/parameters/pricelist" }, { "$ref": "#/components/parameters/licname" }, { "$ref": "#/components/parameters/ip" }, { "$ref": "#/components/parameters/autoprolong" }, { "$ref": "#/components/parameters/skipbasket" }, { "$ref": "#/components/parameters/out" }, { "$ref": "#/components/parameters/sok" } ] }, "/?func=soft.edit": { "get": { "description": "Для просмотра информации укажите только обязательные параметры. Для изменения параметров укажите новое значение в соответствующем поле и выберите ok в поле sok", "tags": [ "Действия с лицензиями ispmanager" ], "summary": "Просмотр и изменение информации по одной лицензии ispmanager", "responses": { "200": { "description": "ok" } } }, "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "soft.edit" ] } }, { "$ref": "#/components/parameters/elid" }, { "$ref": "#/components/parameters/licname" }, { "$ref": "#/components/parameters/ip" }, { "name": "clicked_button", "description": "**Ключ лицензии ispmanager**", "in": "query", "schema": { "type": "string", "enum": [ "newkey" ] } }, { "$ref": "#/components/parameters/out" }, { "name": "sok", "description": "Подтверждение операции", "in": "query", "schema": { "type": "string", "enum": [ "ok" ] } } ] }, "/?func=service.prolong": { "get": { "tags": [ "Действия с лицензиями ispmanager" ], "summary": "Продление лицензии ispmanager", "description": "Услуга будет продлена сразу после выполнения запроса, поэтому на балансе личного кабинета должно быть достаточно средств.", "responses": { "200": { "description": "ok" } } }, "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" } ] }, "/?func=service.changepricelist": { "get": { "tags": [ "Действия с лицензиями ispmanager" ], "summary": "Смена тарифа лицензии ispmanager", "responses": { "200": { "description": "ok" } } }, "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "service.changepricelist" ] } }, { "$ref": "#/components/parameters/elid" }, { "name": "pricelist", "in": "query", "description": "**ID тарифа ispmanager**\n\n**Для api.ispmanager.ru:**\n- **55231** — ispmanager лайт\n- **55232** — ispmanager про\n- **55233** — ispmanager хост\n\n **Для api-eu.ispmanager.com:**\n- **55227** — ispmanager лайт\n- **55228** — ispmanager про\n- **55229** — ispmanager хост", "required": true, "schema": { "type": "string", "enum": [ 55231, 55232, 55233, 55227, 55228, 55229 ] } }, { "$ref": "#/components/parameters/out" }, { "$ref": "#/components/parameters/sok" } ] }, "/?func=soft.suspend": { "get": { "tags": [ "Действия с лицензиями ispmanager" ], "summary": "Выключение лицензии ispmanager", "responses": { "200": { "description": "ok" } } }, "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "soft.suspend" ] } }, { "$ref": "#/components/parameters/elid" }, { "$ref": "#/components/parameters/out" } ] }, "/?func=soft.resume": { "get": { "tags": [ "Действия с лицензиями ispmanager" ], "summary": "Включение лицензии ispmanager", "responses": { "200": { "description": "ok" } } }, "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "soft.resume" ] } }, { "$ref": "#/components/parameters/elid" }, { "$ref": "#/components/parameters/out" } ] }, "/?func=service.history": { "get": { "tags": [ "Действия с лицензиями ispmanager" ], "summary": "Просмотр истории лицензии ispmanager", "responses": { "200": { "description": "ok" } } }, "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" } ] }, "/?func=soft.delete": { "get": { "tags": [ "Действия с лицензиями ispmanager" ], "summary": "Удаление лицензии ispmanager", "responses": { "200": { "description": "ok" } } }, "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "soft.delete" ] } }, { "$ref": "#/components/parameters/elid" }, { "$ref": "#/components/parameters/out" } ] } }, "components": { "parameters": { "authinfoNotRequired": { "name": "authinfo", "description": "**Логин и пароль в формате ЛОГИН:ПАРОЛЬ**\n- Для api.ispmanager.ru параметр обязателен", "in": "query", "required": false, "schema": { "type": "string" } }, "authinfo": { "name": "authinfo", "description": "**Логин и пароль в формате ЛОГИН:ПАРОЛЬ**", "in": "query", "required": true, "schema": { "type": "string" } }, "out": { "name": "out", "description": "**Формат ответа**\n- **xml** — данные будут возвращены в формате XML (без пагинации и\nфильтра)\n- **devel** — XML, в котором дополнительно присутствуют данные,\nописывающие интерфейс пользователя (полезно для отладки своих плагинов)\n- **text** — данные в текстовом формате (без пагинации и фильтра)\n- **sjson** — данные в формате JSON\n- **json** — аналогично sjson, только Pretty Print (полезно для\nотладки)\n- **JSONdata** — аналогично json, но без описаний интерфейса, только\nданные (без пагинации и фильтра)\n- **xjson** — аналогично формату вывода по умолчанию (html) только в\nформате JSON (рекомендуется для создания собственных тем оформления)\n- **bjson** — данные в формате JSON, но более структурированном виде в\nотличие от sjson. Рекомендуется для работы с API по умолчанию\n- **print** — html, пригодный для печати. Работает только для списков\nданных", "in": "query", "schema": { "type": "string", "enum": [ "xml", "devel", "text", "sjson", "json", "JSONdata", "xjson", "bjson", "print" ], "example": "bjson" } }, "period": { "name": "period", "description": "**Период в месяцах**", "in": "query", "required": true, "schema": { "type": "integer", "enum": [ 1, 3, 6, 12 ] } }, "pricelist": { "name": "pricelist", "description": "**ID тарифа ispmanager**\n\n**Для api.ispmanager.ru:**\n- **55235** — ispmanager триал\n- **55231** — ispmanager лайт\n- **55232** — ispmanager про\n- **55233** — ispmanager хост\n\n **Для api-eu.ispmanager.com:**\n- **55239** — ispmanager триал\n- **55227** — ispmanager лайт\n- **55228** — ispmanager про\n- **55229** — ispmanager хост", "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 лицензии ispmanager**", "in": "query", "required": true, "schema": { "type": "integer" } }, "autoprolong": { "name": "autoprolong", "description": "**Период автопродления в месяцах**\n- Должно быть равно значению **period**\n- Если будет указано другое значение или **null**, или параметр вообще не передан, то автопродление не будет подключено для услуги", "in": "query", "schema": { "type": "integer" } }, "skipbasket": { "name": "skipbasket", "description": "**Списать средства и активировать услугу сразу, игнорируя корзину**", "in": "query", "schema": { "type": "string", "enum": [ "off", "on" ] } }, "licname": { "name": "licname", "description": "**Название лицензии ispmanager**", "in": "query", "required": false, "schema": { "type": "string" } }, "ip": { "name": "ip", "description": "**IP-адрес лицензии ispmanager**", "in": "query", "required": false, "schema": { "type": "string" } } } } }

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

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

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

Перепродажа лицензий ispmanager через API

Схема перепродажи лицензий ispmanager через API

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

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

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