Получение Списка продуктов Реселлера
Метод Get Products используется для получения списка всех Продуктов, существующих у выбранного или нижестоящего Реселлера.
Доступ к текущему Реселлеру, относительно которого формируется список нижестоящих Реселлеров, определяется по токену Сотрудника, указанному в заголовке запроса.
GET {base_url}/api/v3/customer_store/resellers/{reseller_id}/productsАргументы
Название | Тип параметра | Тип данных | Обязательный/ | Описание |
|---|---|---|---|---|
| X-Api-Token | header | string | Обязательный | API токен Сотрудника, выполняющего операцию (см. Просмотр и обновление информации о сотруднике) |
| Content-Type | header | string | Обязательный | Предназначен для идентификации формата и способа представления сущности |
| Accept | header | string | Обязательный | Предназначен для информирования сервера о типах данных, которые поддерживаются клиентом (браузером) |
reseller_id | path | number | Обязательный | ID Реселлера. Возможно указать ID текущего Реселлера или ID любого из его нижестоящих Реселлеров (см. Просмотр информации о реселлере) |
per_page | query | number | Опциональный | Параметр постраничной навигации |
page | query | number | Опциональный | Параметр постраничной навигации. Номер страницы ответа |
sorting[field] | query | string | Опциональный | Сортировка списка по указанному полю |
sorting[reversed] | query | bool | Опциональный | Установка режима обратной сортировки по указанному полю:
|
filters[type] | query | string | Опциональный | Фильтрация списка по типу Продукта |
filters[category] | query | string | Опциональный | Фильтрация списка по названию Категории продуктов |
filters[public] | query | bool | Опциональный | Фильтрация списка по признаку public |
| plan_currency | query | bool | Опциональный | Используется для отображения цен в Продуктах в валюте Тарифного плана (см. также Управление валютой Customer Store):
|
Модель ответа
| Название | Тип данных | Описание | |||||
|---|---|---|---|---|---|---|---|
| data | array of objects | Данные ответа | |||||
id | integer | ID Продукта | |||||
| type | string | Тип данных | |||||
| attributes | object | Информация о Продукте | |||||
created_at | date | Дата и время создания Продукта | |||||
updated_at | date | Дата и время последнего обновления Продукта | |||||
| name | string | Название Продукта | |||||
| type | string | Тип Продукта | |||||
| category | object | Категория продуктов | |||||
| data | object | Данные Категории продуктов (см. Создание категории продуктов) | |||||
| id | integer | ID Категории продуктов | |||||
| type | string | Тип данных | |||||
| attributes | object | Информация о Категории продуктов | |||||
created_at | date | Дата и время создания Категории продуктов | |||||
updated_at | date | Дата и время последнего обновления Категории продуктов | |||||
| key | string | Ключ Категории продуктов | |||||
| name | string | Название Категории продуктов | |||||
| description | string | Описание Категории продуктов | |||||
| priority | integer | Приоритет Категории продуктов | |||||
| logo | string | Ссылка на файл логотипа Категории продуктов | |||||
| description | string | Описание Продукта | |||||
| license-agreement | string | Ссылка на лицензионное соглашение Продукта | |||||
| privacy-policy | string | Ссылка на политику конфиденциальности при использовании Продукта | |||||
| public | bool | Признак доступности Продукта через Витрину:
| |||||
| vendor | object | Информация о Вендоре | |||||
| name | string | Название Вендора | |||||
| logo | string | Ссылка на файл логотипа Вендора | |||||
| plans | array of objects | Информация о Тарифных планах в рамках Продукта | |||||
created_at | date | Дата и время создания Тарифного плана | |||||
updated_at | date | Дата и время последнего обновления Тарифного плана | |||||
| id | integer | ID Тарифного плана | |||||
| status | string | Статус Тарифного плана (список статусов см. в Просмотр списка тарифных планов) | |||||
| name | string | Название Тарифного плана | |||||
| description | string | Дополнительная информация о Тарифном плане, которая отображается клиентам в Панели управления Клиента | |||||
| sku | string | SKU Тарифного плана | |||||
| public | bool | Признак доступности Тарифного плана:
| |||||
| plan_class | string | Название Правила предоставления (см. Управление правилами предоставления тарифных планов) | |||||
| plan_class_id | integer | ID Правила предоставления | |||||
| billing_type | string | Тип биллинга Тарифного плана | |||||
| singleton | bool | Признак Единичный Тарифного плана:
| |||||
| fixed_price | bool | Признак Фиксированная цена Тарифного плана:
| |||||
| auto_renewal | bool | Состояние опции Автопродление по умолчанию для Подписок на этот Тарифный план:
| |||||
| currency | object | Информация о валюте, в которой указаны цены данного Тарифного плана. Валюта определяется значением параметра plan_currency в запросе | |||||
| precision | integer | Количество десятичных знаков (доля базовой денежной единицы для разменной денежной единицы валюты. Например, для копеек и центов: 2) | |||||
| unit | string | Обозначение валюты | |||||
| separator | string | Десятичный разделитель | |||||
| delimiter | string | Разделитель разрядов целой части | |||||
| format | string | Порядок отображения суммы в валюте и ее единиц, где:
| |||||
| iso_code | string | Код валюты ISO 4217 alpha-3 | |||||
| resources | array of objects | Информация о Ресурсах Тарифного плана | |||||
created_at | date | Дата и время создания Ресурса | |||||
updated_at | date | Дата и время последнего обновления Ресурса | |||||
| id | integer | ID Ресурса | |||||
| name | string | Название Ресурса | |||||
| key | string | Ключ Ресурса | |||||
| unit_of_measure | string | Единицы измерения Ресурса:
| |||||
| status | string | Статус Ресурса:
| |||||
| included | integer | Количество Ресурса, которое включено в Тарифный план по умолчанию (включенные Ресурсы входят в стоимость Подписки) | |||||
| minimum | integer | Минимальное количество Ресурса (с учетом величины included), которое доступно для заказа (см. Ресурсы тарифного плана) | |||||
| limit | integer | Максимальное количество Ресурса, доступное для заказа. Если Ресурс безлимитный (признак unlimited_units=true), то limit принимает значение 0. Limit может быть также равен 0 когда Ресурс не является безлимитным, если minimum и limit одновременно равны 0 | |||||
| public | bool | Возможные значения:
| |||||
| unlimited | bool | Признак отключения лимитов использования Ресурса:
| |||||
| fees | object | Информация о стоимостях Ресурса | |||||
| setup | float | Величина платежа за установку Ресурса | |||||
| overuse | float | Стоимость перерасхода Ресурсов | |||||
| recurring | float | Величина ежемесячной абонентской платы за Ресурс | |||||
| renewal | float | Стоимость продления использования Ресурса | |||||
| periods | array of objects | Информация о периодах Тарифного плана | |||||
created_at | date | Дата и время создания периода Тарифного плана | |||||
updated_at | date | Дата и время последнего обновления периода Тарифного плана | |||||
| id | integer | ID периода Тарифного плана | |||||
| endless | bool | Признак того, является ли период Тарифного плана бессрочным:
| |||||
| trial | bool | Признак того, является ли период Тарифного плана пробным:
| |||||
| public | bool | Признак доступности периода для заказа в рамках данного Тарифного плана:
| |||||
| status | string | Статус периода Тарифного плана:
| |||||
| description | string | Описание периода Тарифного плана | |||||
| durations | object | Информация о длительности периода Тарифного плана | |||||
| value | integer | Длительность периода Тарифного плана. Если период бессрочный, то value = null | |||||
| type | string | Единица измерения периода Тарифного плана. Если период бессрочный, то type = null | |||||
| fees | object | Информация о стоимостях Периода | |||||
| setup | float | Величина платежа за установку Тарифного плана для данного периода | |||||
| recurring | float | Величина ежемесячной абонентской платы за Период | |||||
| transfer | float | Стоимость переноса Домена, если Услугa включает в себя возможность использования Доменов | |||||
| renewal | float | Стоимость продления Тарифного плана для данного периода | |||||
| support | object | Информация о технической поддержке Продукта | |||||
| phone | string | Номер телефона технической поддержки Продукта | |||||
| string | Email технической поддержки Продукта | ||||||
| url | string | Ссылка на страницу для создания запроса в техническую поддержку Продукта | |||||
| details | string | Дополнительная информация о технической поддержке Продукта | |||||
| market | object | Маркетинговая информация о Продукте для Витрины (вкладка Маркетинг в статье Создание продукта) | |||||
created_at | date | Дата и время создания маркетинговой информации о Продукте | |||||
updated_at | date | Дата и время последнего обновления маркетинговой информации о Продукте | |||||
| name | string | Маркетинговое название Продукта | |||||
| description | string | Маркетинговое описание Продукта | |||||
| screenshots | array of objects | Информация о снимках экрана Продукта | |||||
| title | string | Название снимка экрана | |||||
| url | string | Ссылка на снимок экрана | |||||
| video_url | array of objects | Информация о видео Продукта | |||||
| title | string | Название видео | |||||
| url | string | Ссылка на видео | |||||
| documentation_url | array of objects | Информация о документации Продукта | |||||
| title | string | Название документа | |||||
| url | string | Ссылка на документ | |||||
| benefits | array of objects | Информация о преимуществах Продукта | |||||
| title | string | Название преимущества | |||||
| description | string | Описание преимущества | |||||
| image | string | Ссылка на файл логотипа Продукта | |||||
| links | object | Ссылки на страницы для навигации по элементам ответа с учетом заданных параметров постраничной навигации | |||||
| self | string | Ссылка на текущую страницу | |||||
| first | string | Ссылка на первую страницу | |||||
| prev | string | Ссылка на предыдущую страницу | |||||
| next | string | Ссылка на следующую страницу | |||||
| last | string | Ссылка на последнюю страницу | |||||
| meta | object | Дополнительные данные ответа | |||||
| currency | string | Код валюты Реселлера ISO 4217 alpha-3 | |||||
| pages | object | Информация о страницах ответа | |||||
| current | integer | Номер текущей страницы | |||||
| prev | integer | Номер предыдущей страницы | |||||
| has_prev | bool | Наличие предыдущей страницы:
| |||||
| next | integer | Номер следующей страницы | |||||
| has_next | bool | Наличие следующей страницы:
| |||||
| total | integer | Общее число страниц | |||||
Пример запроса
GET /api/v3/customer_store/resellers/1/products?per_page=2&filters[public]=false&sorting[field]=updated_at&sorting[reversed]=true
Host: https://test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetestK3gJXZH5uHCw
Accept: application/vnd.api+jsonПример ответа
{
"data": [
{
"id": "878",
"type": "products",
"attributes": {
"created_at": "2020-06-17T13:59:15.810+03:00",
"updated_at": "2020-09-23T15:07:17.734+03:00",
"name": "G Suite for migration",
"type": "saas",
"category": {
"data": {
"id": "190",
"type": "product_categories",
"attributes": {
"created_at": "2017-09-14T16:27:16.566+03:00",
"updated_at": "2020-03-11T10:46:45.422+03:00",
"key": "default",
"name": "default",
"description": "",
"priority": 0,
"logo": null
}
}
},
"description": "",
"license_agreement": null,
"privacy_policy": null,
"public": false,
"vendor": {
"name": "G Suite magration",
"logo": null
},
"plans": [
{
"created_at": "2020-06-17T13:59:16.031+03:00",
"updated_at": "2020-06-17T13:59:16.409+03:00",
"id": 1863,
"status": "active",
"name": "G Suite Basic годовой план с помесячной оплатой",
"description": "G Suite Basic – это пакет приложений для совместной работы, который включает корпоративную почту, общие календари, сервисы для редактирования и хранения документов в Интернете, инструменты для видеоконференций и многое другое.",
"sku": null,
"public": false,
"plan_class": "gsuitemigration",
"plan_class_id": 13078,
"billing_type": "csp_monthly",
"singleton": false,
"fixed_price": false,
"auto_renewal": false,
"currency": {
"precision": 2,
"unit": "руб.",
"separator": ".",
"delimiter": " ",
"format": "%n %u",
"iso_code": "RUB"
},
"resources": [
{
"created_at": "2020-06-17T13:59:16.108+03:00",
"updated_at": "2020-06-17T13:59:16.108+03:00",
"id": 4742,
"name": "Пользователь",
"key": null,
"unit_of_measure": "unit",
"status": "active",
"included": 0,
"minimum": 1,
"limit": 750,
"public": true,
"unlimited": false,
"fees": {
"setup": "0.0",
"overuse": "0.0",
"recurring": "2.65",
"renewal": "0.0"
}
},
{
"created_at": "2020-06-17T13:59:16.154+03:00",
"updated_at": "2020-06-17T13:59:16.154+03:00",
"id": 4744,
"name": "Предоставление доступа к сервисам Google Drive storage Upgrade 8TB на 1 учетную запись, на 1 месяц",
"key": null,
"unit_of_measure": "unit",
"status": "active",
"included": 0,
"minimum": 0,
"limit": 750,
"public": true,
"unlimited": false,
"fees": {
"setup": "0.0",
"overuse": "0.0",
"recurring": "9.6",
"renewal": "0.0"
}
},
{
"created_at": "2020-06-17T13:59:16.326+03:00",
"updated_at": "2020-06-17T13:59:16.326+03:00",
"id": 4752,
"name": "Предоставление доступа к сервисам Google Vault на 1 учетную запись, на 1 месяц",
"key": null,
"unit_of_measure": "unit",
"status": "active",
"included": 0,
"minimum": 0,
"limit": 750,
"public": true,
"unlimited": false,
"fees": {
"setup": "0.0",
"overuse": "0.0",
"recurring": "6.2",
"renewal": "0.0"
}
}
],
"periods": [
{
"created_at": "2020-06-17T13:59:16.360+03:00",
"updated_at": "2020-06-17T13:59:16.360+03:00",
"id": 3278,
"endless": false,
"trial": false,
"public": true,
"status": "active",
"description": null,
"durations": {
"value": 1,
"type": "year"
},
"fees": {
"setup": "0.0",
"recurring": "0.0",
"transfer": "0.0",
"renewal": "0.0"
}
}
]
},
{
"created_at": "2020-06-17T13:59:16.418+03:00",
"updated_at": "2020-06-17T13:59:16.880+03:00",
"id": 1864,
"status": "active",
"name": "G Suite Basic гибкий план",
"description": "G Suite Basic – это пакет приложений для совместной работы, который включает корпоративную почту, общие календари, сервисы для редактирования и хранения документов в Интернете, инструменты для видеоконференций и многое другое.",
"sku": null,
"public": false,
"plan_class": "gsuitemigration",
"plan_class_id": 13078,
"billing_type": "csp_monthly",
"singleton": false,
"fixed_price": false,
"auto_renewal": false,
"currency": {
"precision": 2,
"unit": "руб.",
"separator": ".",
"delimiter": " ",
"format": "%n %u",
"iso_code": "RUB"
},
"resources": [
{
"created_at": "2020-06-17T13:59:16.820+03:00",
"updated_at": "2020-06-17T13:59:16.820+03:00",
"id": 4763,
"name": "Пользователь",
"key": null,
"unit_of_measure": "unit",
"status": "active",
"included": 0,
"minimum": 1,
"limit": 750,
"public": true,
"unlimited": false,
"fees": {
"setup": "0.0",
"overuse": "0.0",
"recurring": "6.2",
"renewal": "0.0"
}
},
{
"created_at": "2020-06-17T13:59:16.472+03:00",
"updated_at": "2020-06-17T13:59:16.472+03:00",
"id": 4754,
"name": "Предоставление доступа к сервисам Google Drive storage Upgrade 8TB на 1 учетную запись, на 1 месяц",
"key": null,
"unit_of_measure": "unit",
"status": "active",
"included": 0,
"minimum": 0,
"limit": 750,
"public": true,
"unlimited": false,
"fees": {
"setup": "0.0",
"overuse": "0.0",
"recurring": "9.6",
"renewal": "0.0"
}
},
{
"created_at": "2020-06-17T13:59:16.800+03:00",
"updated_at": "2020-06-17T13:59:16.800+03:00",
"id": 4762,
"name": "Предоставление доступа к сервисам Google Vault на 1 учетную запись, на 1 месяц",
"key": null,
"unit_of_measure": "unit",
"status": "active",
"included": 0,
"minimum": 0,
"limit": 750,
"public": true,
"unlimited": false,
"fees": {
"setup": "0.0",
"overuse": "0.0",
"recurring": "6.2",
"renewal": "0.0"
}
}
],
"periods": [
{
"created_at": "2020-06-17T13:59:16.857+03:00",
"updated_at": "2020-06-17T13:59:16.857+03:00",
"id": 3280,
"endless": false,
"trial": false,
"public": true,
"status": "active",
"description": null,
"durations": {
"value": 1,
"type": "month"
},
"fees": {
"setup": "0.0",
"recurring": "0.0",
"transfer": "0.0",
"renewal": "0.0"
}
},
{
"created_at": "2020-06-17T13:59:16.838+03:00",
"updated_at": "2020-06-17T13:59:16.838+03:00",
"id": 3279,
"endless": true,
"trial": false,
"public": true,
"status": "active",
"description": null,
"durations": {
"value": null,
"type": null
},
"fees": {
"setup": "0.0",
"recurring": "0.0",
"transfer": "0.0",
"renewal": "0.0"
}
}
]
}
],
"support": {
"phone": "",
"email": "",
"url": "",
"details": ""
},
"market": {
"created_at": "2020-06-17T13:59:16.939+03:00",
"updated_at": "2021-04-08T10:43:58.165+03:00",
"name": "G Suite migration",
"description": "Пакет облачных служб и приложений для совместной работы по подписке. В пакет входят популярные веб-приложения Google в том числе Gmail, Google Диск, Google Hangouts, Google Календарь и Google Документы. Помимо этого, они предоставляют дополнительные возможности для корпоративных клиентов, такие как адреса Электронной почты в домене компании, 30 ГБ и более для хранения писем и документов, а также круглосуточная поддержка по телефону и электронной почте. Поскольку Google Suite является облачным решением, то все пользовательские данные хранятся в защищенных дата-центрах Google, а не на локальных серверах клиента, как при использовании стандартного специализированного ПО.",
"screenshots": [],
"video_url": [],
"documentation_url": [
{
"title": "",
"url": "https://docs.activeplatform.com/"
}
],
"benefits": [],
"image": null
}
}
},
{
"id": "843",
"type": "products",
"attributes": {
"created_at": "2020-03-12T16:27:35.321+03:00",
"updated_at": "2020-03-12T16:27:35.321+03:00",
"name": "Облако VMware",
"type": "iaas",
"category": {
"data": {
"id": "190",
"type": "product_categories",
"attributes": {
"created_at": "2017-09-14T16:27:16.566+03:00",
"updated_at": "2020-03-11T10:46:45.422+03:00",
"key": "default",
"name": "default",
"description": "",
"priority": 0,
"logo": null
}
}
},
"description": null,
"license_agreement": null,
"privacy_policy": null,
"public": false,
"vendor": {
"name": "Dev Company",
"logo": null
},
"plans": [
{
"created_at": "2020-03-12T16:27:35.572+03:00",
"updated_at": "2020-03-12T16:27:35.975+03:00",
"id": 1785,
"status": "active",
"name": "VCD22222",
"description": "",
"sku": null,
"public": false,
"plan_class": "11111",
"plan_class_id": 12785,
"billing_type": "reservation",
"singleton": false,
"fixed_price": true,
"auto_renewal": false,
"currency": {
"precision": 2,
"unit": "руб.",
"separator": ".",
"delimiter": " ",
"format": "%n %u",
"iso_code": "RUB"
},
"resources": [
{
"created_at": "2020-03-12T16:27:35.799+03:00",
"updated_at": "2020-03-12T16:27:35.799+03:00",
"id": 4555,
"name": "vCPU",
"key": null,
"unit_of_measure": "unit",
"status": "active",
"included": 2,
"minimum": 2,
"limit": 128,
"public": true,
"unlimited": false,
"fees": {
"setup": "0.0",
"overuse": "0.0",
"recurring": "9.0",
"renewal": "0.0"
}
},
{
"created_at": "2020-03-12T16:27:35.831+03:00",
"updated_at": "2020-03-12T16:27:35.831+03:00",
"id": 4556,
"name": "vRAM",
"key": null,
"unit_of_measure": "unit",
"status": "active",
"included": 4,
"minimum": 4,
"limit": 2048,
"public": true,
"unlimited": false,
"fees": {
"setup": "0.0",
"overuse": "0.0",
"recurring": "5.0",
"renewal": "0.0"
}
}
],
"periods": [
{
"created_at": "2020-03-12T16:27:35.921+03:00",
"updated_at": "2020-03-12T16:27:35.921+03:00",
"id": 3114,
"endless": false,
"trial": false,
"public": true,
"status": "active",
"description": null,
"durations": {
"value": 1,
"type": "month"
},
"fees": {
"setup": "0.0",
"recurring": "0.0",
"transfer": "0.0",
"renewal": "0.0"
}
},
{
"created_at": "2020-03-12T16:27:35.960+03:00",
"updated_at": "2020-03-12T16:27:35.960+03:00",
"id": 3115,
"endless": false,
"trial": true,
"public": true,
"status": "active",
"description": null,
"durations": {
"value": 1,
"type": "month"
},
"fees": {
"setup": "0.0",
"recurring": "0.0",
"transfer": "0.0",
"renewal": "0.0"
}
}
]
}
],
"support": {
"phone": "+1(555) 555-5555",
"email": "info@example.com",
"url": "",
"details": ""
},
"market": {
"created_at": "2020-03-12T16:27:36.044+03:00",
"updated_at": "2020-03-12T16:27:36.044+03:00",
"name": "Облако VMware",
"description": "",
"screenshots": [],
"video_url": [],
"documentation_url": [],
"benefits": [],
"image": null
}
}
}
],
"links": {
"self": "https://test.activeplatform.com/api/v3/customer_store/resellers/1/products?filters%5Bpublic%5D=false&page%5Bnumber%5D=1&page%5Bsize%5D=2&per_page=2&sorting%5Bfield%5D=updated_at&sorting%5Breversed%5D=true",
"first": "https://test.activeplatform.com/api/v3/customer_store/resellers/1/products?filters%5Bpublic%5D=false&page%5Bnumber%5D=1&page%5Bsize%5D=2&per_page=2&sorting%5Bfield%5D=updated_at&sorting%5Breversed%5D=true",
"prev": null,
"next": "https://test.activeplatform.com/api/v3/customer_store/resellers/1/products?filters%5Bpublic%5D=false&page%5Bnumber%5D=2&page%5Bsize%5D=2&per_page=2&sorting%5Bfield%5D=updated_at&sorting%5Breversed%5D=true",
"last": "https://test.activeplatform.com/api/v3/customer_store/resellers/1/products?filters%5Bpublic%5D=false&page%5Bnumber%5D=26&page%5Bsize%5D=2&per_page=2&sorting%5Bfield%5D=updated_at&sorting%5Breversed%5D=true"
},
"meta": {
"currency": "RUB",
"pages": {
"current": 1,
"prev": 0,
"has_prev": false,
"next": 2,
"has_next": true,
"total": 26
}
}
}