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

Сторонние лицензии — это лицензии на ПО, оформляемые в личном кабинете в разделе Лицензии → Сторонние лицензии. Эти лицензии можно использовать на сервере без ispmanager. Установка происходит через консоль сервера.

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

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

Выбор и заказ лицензии. Конечный клиент заказывает стороннюю лицензию в личном кабинете биллинга партнера.
Заказ лицензии в личном кабинете ispmanager. Далее партнер обрабатывает заказ конечного клиента и покупает стороннюю лицензию в личном кабинете ispmanager. Для этого настраивается автоматизация через API, либо совершается покупка вручную.
Активация и управление лицензиями. Конечный клиент управляет сторонней лицензией через свой личный кабинет в биллинге партнера.

Действия с лицензиями

Далее представлены функции автоматического заказа и управления модулями в системе 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": "Действия со сторонними лицензиями" } ], "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- **softexternal** — сторонние лицензии", "schema": { "type": "string", "enum": [ "softexternal" ] } }, { "$ref": "#/components/parameters/out" } ], "get": { "tags": [ "Действия со сторонними лицензиями" ], "summary": "Список всех тарифов", "responses": { "200": { "description": "ok" } } } }, "/?func=softexternal": { "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "softexternal" ] } }, { "$ref": "#/components/parameters/out" } ], "get": { "tags": [ "Действия со сторонними лицензиями" ], "summary": "Список всех лицензий на аккаунте, в т. ч. лежащих в корзине, которые не оплачены", "responses": { "200": { "description": "ok" } } } }, "/mancgi/bitninja_check_email.py": { "get": { "tags": [ "Действия со сторонними лицензиями" ], "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=softexternal.order.param": { "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "softexternal.order.param" ] } }, { "$ref": "#/components/parameters/periodSoftExternalOrder" }, { "$ref": "#/components/parameters/pricelistSoftExternal" }, { "$ref": "#/components/parameters/autoprolong" }, { "$ref": "#/components/parameters/skipbasket" }, { "name": "licname", "description": "**Название лицензии**", "in": "query", "schema": { "type": "string" } }, { "name": "ip", "description": "**IP-адрес сервера**", "in": "query", "schema": { "type": "string" } }, { "name": "bitninja_email", "description": "**Электронная почта**", "in": "query", "required": false, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/out" }, { "$ref": "#/components/parameters/sok" } ], "get": { "tags": [ "Действия со сторонними лицензиями" ], "summary": "Заказ лицензии", "responses": { "200": { "description": "ok" } } } }, "/?func=softexternal.edit": { "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "softexternal.edit" ] } }, { "$ref": "#/components/parameters/elidForSoftexternal" }, { "$ref": "#/components/parameters/autoprolong" }, { "$ref": "#/components/parameters/out" }, { "name": "sok", "description": "Подтверждение операции", "in": "query", "schema": { "type": "string", "enum": [ "ok" ] } } ], "get": { "tags": [ "Действия со сторонними лицензиями" ], "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": [ "Действия со сторонними лицензиями" ], "summary": "Продление лицензии", "description": "Услуга будет продлена сразу после выполнения запроса, поэтому на балансе личного кабинета должно быть достаточно средств", "responses": { "200": { "description": "ok" } } } }, "/?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": [ "Действия со сторонними лицензиями" ], "summary": "Просмотр истории лицензии", "responses": { "200": { "description": "ok" } } } }, "/?func=softexternal.suspend": { "get": { "tags": [ "Действия со сторонними лицензиями" ], "summary": "Выключение лицензии", "responses": { "200": { "description": "ok" } } }, "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "softexternal.suspend" ] } }, { "$ref": "#/components/parameters/elid" }, { "$ref": "#/components/parameters/out" } ] }, "/?func=softexternal.resume": { "get": { "tags": [ "Действия со сторонними лицензиями" ], "summary": "Включение лицензии", "responses": { "200": { "description": "ok" } } }, "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "softexternal.resume" ] } }, { "$ref": "#/components/parameters/elid" }, { "$ref": "#/components/parameters/out" } ] }, "/?func=softexternal.delete": { "parameters": [ { "$ref": "#/components/parameters/authinfo" }, { "name": "func", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "softexternal.delete" ] } }, { "$ref": "#/components/parameters/elidForSoftexternal" }, { "$ref": "#/components/parameters/out" } ], "get": { "tags": [ "Действия со сторонними лицензиями" ], "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": "**Период оплаты в месяцах**", "in": "query", "required": true, "schema": { "type": "integer", "enum": [ 1, 3, 6, 12 ] } }, "pricelistSoftExternal": { "name": "pricelist", "description": "**ID тарифа сторонней лицензии**\n\n**Для api.ispmanager.ru:**\n- **55391** — BitNinja \n\n**Для api-eu.ispmanager.com:**\n- **55369** — BitNinja", "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" } }, "elidForSoftexternal": { "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- **-100** означает триальный период", "in": "query", "required": true, "schema": { "type": "integer", "enum": [ 1, 3, 6, 12, -100 ] } }, "periodSoftExternalOrder": { "name": "period", "description": "**Период оплаты в месяцах**\n- Значение **-100** означает триальный период", "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" } } } } }

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

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

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

Действия с лицензиями