Получение списка тарифных планов всех нижестоящих реселлеров

Метод Get list of plans of downstream resellers используется для получения cписка тарифных планов всех реселлеров, являющихся нижестоящими по отношению к текущему реселлеру, или по отношению к его выбранному нижестоящему реселлеру. 

Для авторизации требуется API-токен сотрудника. API-токен можно получить через Панель управления Оператора (см. Просмотр и обновление информации о сотруднике).

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

GET {base_url}/api/v3/resellers/{reseller_id}/child_reseller_plans

Аргументы

Название

Тип параметра

Тип данных

Обязательный/ 
Опциональный

Описание

X-Api-TokenheaderstringОбязательныйAPI-токен сотрудника, выполняющего операцию (см. Просмотр и обновление информации о сотруднике)
Content-TypeheaderstringОбязательныйТип данных, передаваемых в запросе. Необходимо указать: application/vnd.api+json
AcceptheaderstringОбязательныйПоддерживаемые типы данных в ответе. Необходимо указать: application/vnd.api+json
base_urlpathstringОбязательныйURL ActivePlatform
reseller_idpathintegerОбязательный

ID реселлера. Возможно указать ID текущего реселлера или ID любого из его нижестоящих реселлеров (см. Просмотр информации о реселлере)

page[size]

query

integer

Опциональный

Параметр постраничной навигации. Количество элементов на странице ответа (50 по умолчанию)

page[number]

query

integer

Опциональный

Параметр постраничной навигации. Номер страницы ответа

Модель ответа

Название

Тип данных

Описание

dataarrayДанные ответа


id

integer

ID тарифного плана


typestringТип данных

attributesobjectИнформация о тарифном плане


created_at

string

Дата и время создания тарифного плана



updated_at

string

Дата и время последнего изменения тарифного плана



statusstringСтатус тарифного плана (список статусов см. в Просмотр списка тарифных планов)


name

string

Название тарифного плана



description

string

Дополнительная информация о тарифном плане, которая отображается клиентам в Панели управления Клиента



public

bool

Признак доступности тарифного плана:

  • true — тарифный план доступен для заказа.
  • false — тарифный план недоступен для заказа.


plan_class_id

integer

ID правила предоставления (см. Управление правилами предоставления тарифных планов)



product_id

integer

ID продукта, с которым связан тарифный план



billing_typestringТип биллинга тарифного плана


ancestrystringДля делегированных тарифных планов содержит список ID родительских тарифных планов, начиная от корневого (см. Просмотр списка делегированных тарифных планов). Для тарифных планов, созданных сотрудником выбранного реселлера равен null


reseller_idintegerID реселлера, которому принадлежит тарифный план


plan_class

string

Название правила предоставления



product_category_id

integer

ID категории продукта, с которой связан тарифный план



product_category

string

Название категории продукта, с которой связан тарифный план



product

string

Название продукта, с которым связан тарифный план



plan_resources

array of objects

Информация о ресурсах тарифного плана




dataarrayДанные объекта




idintegerID ресурса тарифного плана




typestringТип данных




attributesobjectИнформация о ресурсах тарифного плана





created_atstringДата и время создания ресурса





updated_atstringДата и время последнего обновления ресурса





namestring

Название ресурса






measurablebool

Признак использования модели расчета стоимости за фактическое использование ресурса (недоступен, если функция не поддерживается внешними службами):

  • true — используется расчет за фактическое использование ресурса.
  • false — не используется расчет за фактическое использование ресурса.





unit_of_measurestring

Единица измерения ресурса:

  • unit — измеряемый ресурс, для которого указывается определенное количество.
  • boolean — неизмеряемый ресурс (для ресурсов, у которых не надо указывать количество), возможные значения:
    • true — ресурс включен в тарифный план.
    • false — ресурс не включен в тарифный план.





application_template_namestringНазвание услуги, которая предоставляется в рамках данного тарифного плана





includedinteger

Количество ресурса, которое включено в тарифный план по умолчанию (включенные ресурсы входят в стоимость подписки)






minimuminteger

Минимальное количество ресурса (с учетом величины included), которое доступно для заказа (см. Ресурсы тарифного плана)






limitinteger

Максимальное количество ресурса, доступное для заказа. Если ресурс безлимитный (признак unlimited_units = true), то limit = 0






setup_feefloat

Величина платежа за установку ресурса






recurring_feefloat

Величина ежемесячной абонентской платы за ресурс






overuse_feefloat

Стоимость перерасхода ресурсов






renewal_feefloat

Стоимость продления использования ресурса






unlimited_unitsbool

Признак отключения лимитов использования ресурса:

  • true — лимиты отключены.
  • false — лимиты активны.





publicbool

Возможные значения:

  • true — ресурс доступен клиентам для заказа.
  • false — ресурс недоступен клиентам для заказа.





statusstring

Статус ресурса:

  • active — активный.
  • inactive — неактивный.
  • deleted — удален.





resource_idinteger

ID ресурса в шаблоне услуги






priorityintegerПриоритет ресурса. У основного ресурса priority максимальный





net_costsobject

Значения себестоимостей указанных типов для ресурса







setup_feefloat

Величина платежа за установку ресурса







recurring_feefloat

Величина ежемесячной абонентской платы за ресурс







overuse_feefloat

Стоимость перерасхода ресурсов







renewal_feefloat

Стоимость продления использования ресурса






custom_attributesobjectИнформация о дополнительных параметрах ресурса






plan_resources.custom_attributes.['custom-attribute-key']stringЗначение дополнительного параметра ресурса


plan_periodsarray of objectsИнформация о периодах тарифного плана



data
arrayДанные объекта




idintegerID периода тарифного плана




typestringТип данных




attributesobjectИнформация о периодах тарифного плана





created_atstring

Дата и время создания периода тарифного плана






updated_atstring

Дата и время последнего обновления периода тарифного плана






duration_valueintegerДлительность периода тарифного плана





duration_typestringЕдиница измерения периода тарифного плана





setup_feefloatСтоимость установки тарифного плана для данного периода





recurring_feefloatЕжемесячная стоимость тарифного плана для данного периода





transfer_feefloatСтоимость переноса домена, если услуги включает в себя возможность использования доменов





renewal_feefloatСтоимость продления тарифного плана для данного периода





trialbool

Признак того, является ли период тарифного плана пробным:

  • true — период является пробным.
  • false — период не является пробным.





publicbool

Признак доступности периода для заказа в рамках данного тарифного плана:

  • true — период доступен для заказа.
  • false — период недоступен для заказа.





statusstring

Статус периода тарифного плана:

  • active — активный.
  • deleted — удален.





descriptionstringОписание периода тарифного плана





endlessbool

Признак того, является ли период тарифного плана бессрочным:

  • true — период является бессрочным.
  • false — период не является бессрочным. Продолжительность периода указана в duration_value и duration_type.





net_costsobject

Значения себестоимостей указанных типов для периода







setup_feefloatСтоимость установки тарифного плана для данного периода






recurring_feefloatЕжемесячная стоимость тарифного плана для данного периода






transfer_feefloatСтоимость переноса домена, если услуга включает в себя возможность использования доменов






renewal_feefloatСтоимость продления тарифного плана для данного периода


available_account_types

array of objectsИнформация о типах клиентов, для которых доступен тарифный план



id

integer

ID типа клиента



namestringИмя типа клиента



created_at

string

Дата и время создания типа клиента



updated_at

string

Дата и время последнего обновления типа клиента



reseller_idintegerID реселлера, к которому относится тип клиента



name_patternstringШаблон отображения имени клиента в платформе



primary_namestringНазвание поля с основным именем клиента. Например, для типа клиента Юридическое лицо это может быть Название компании



keystringКлюч типа клиента



default_payment_method_idinteger

ID способа оплаты (см. Способы оплаты), который используется по умолчанию для данного типа клиентов




ancestryintegerID родительского типа клиентов



use_by_default

bool

Признак типа клиента по умолчанию:

  • true — типа клиента используется по умолчанию.
  • false — типа клиента не используется по умолчанию.


plan_currency

stringКод валюты тарифного плана


custom_attributesobjectИнформация о дополнительных параметрах тарифного плана



custom_attributes.['custom_attribute_key']stringЗначение дополнительного параметра тарифного плана

relationshipsobjectИнформация о связанных объектах


plan_categoryobjectИнформация о связанной категории тарифных планов



dataobjectИнформация о категории тарифных планов




idstringID категории тарифных планов




typestringТип данных
linksarrayСсылки на страницы для навигации по элементам ответа с учетом заданных параметров постраничной навигации

selfstringСсылка на текущую страницу

firststringСсылка на первую страницу

prevstringСсылка на предыдущую страницу

nextstringСсылка на следующую страницу

laststringСсылка на последнюю страницу

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

GET /api/v3/resellers/1/child_reseller_plans?page[size]=2&page[number]=78
Host: test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetestK3gJXZH5uHCw
Accept: application/vnd.api+json

Пример ответа

{
    "data": [
        {
            "id": "484",
            "type": "plans",
            "attributes": {
                "created_at": "2017-09-01T11:37:28.677+03:00",
                "updated_at": "2017-09-01T11:54:03.486+03:00",
                "status": "active",
                "name": "Dr web",
                "description": "",
                "public": true,
                "plan_class_id": 3010,
                "product_id": 68,
                "billing_type": "reservation",
                "ancestry": null,
                "reseller_id": 211,
                "plan_class": "Doctor web-Reservation",
                "product_category_id": 156,
                "product_category": "Security",
                "product": "Doctor web",
                "plan_resources": {
                    "data": [
                        {
                            "id": "2206",
                            "type": "plan_resources",
                            "attributes": {
                                "created_at": "2017-09-01T11:37:28.816+03:00",
                                "updated_at": "2017-09-01T11:37:28.816+03:00",
                                "name": "Station",
                                "measurable": null,
                                "unit_of_measure": "unit",
                                "application_template_name": "Doctor web",
                                "included": 2,
                                "minimum": 3,
                                "limit": 3,
                                "setup_fee": "0.0",
                                "recurring_fee": "10.0",
                                "overuse_fee": "0.0",
                                "renewal_fee": "0.0",
                                "unlimited_units": false,
                                "public": true,
                                "status": "active",
                                "resource_id": 1070,
                                "priority": 0,
                                "net_costs": {
                                    "setup_fee": "0.0",
                                    "recurring_fee": "0.0",
                                    "overuse_fee": "0.0",
                                    "renewal_fee": "0.0"
                                },
                                "custom_attributes": {}
                            }
                        }
                    ]
                },
                "plan_periods": {
                    "data": [
                        {
                            "id": "1084",
                            "type": "plan_periods",
                            "attributes": {
                                "created_at": "2017-09-01T11:37:28.840+03:00",
                                "updated_at": "2017-09-01T11:37:28.840+03:00",
                                "duration_value": 2,
                                "duration_type": "month",
                                "setup_fee": "0.0",
                                "recurring_fee": "0.0",
                                "transfer_fee": "0.0",
                                "renewal_fee": "0.0",
                                "trial": false,
                                "public": true,
                                "status": "active",
                                "description": null,
                                "endless": false,
                                "net_costs": {
                                    "setup_fee": "0.0",
                                    "recurring_fee": "0.0",
                                    "transfer_fee": "0.0",
                                    "renewal_fee": "0.0"
                                }
                            }
                        }
                    ]
                },
                "available_account_types": [
                    {
                        "id": 3329,
                        "name": "Personal BLR",
                        "created_at": "2017-09-01T11:33:03.191+03:00",
                        "updated_at": "2017-09-01T11:33:03.191+03:00",
                        "reseller_id": 211,
                        "name_pattern": "%first_name %middle_name %last_name",
                        "primary_name": "",
                        "key": "personalblr",
                        "default_payment_method_id": 2,
                        "ancestry": "1",
                        "use_by_default": false
                    },
                    {
                        "id": 3333,
                        "name": "Business BLR",
                        "created_at": "2017-09-01T11:33:03.254+03:00",
                        "updated_at": "2017-09-01T11:33:03.254+03:00",
                        "reseller_id": 211,
                        "name_pattern": "%primary_name",
                        "primary_name": "Company name",
                        "key": "businessblr",
                        "default_payment_method_id": 197,
                        "ancestry": "2",
                        "use_by_default": false
                    }
                ],
                "plan_currency": "USD",
                "custom_attributes": {
                    "111": "",
                    "plannum": "1",
                    "vat25": "0",
                    "item_1c_id": "",
                    "item_1c_for_resellers": ""
                }
            },
            "relationships": {
                "plan_category": {
                    "data": {
                        "id": "156",
                        "type": "plan_categories"
                    }
                }
            }
        },
        {
            "id": "485",
            "type": "plans",
            "attributes": {
                "created_at": "2017-09-01T11:37:58.582+03:00",
                "updated_at": "2017-09-01T11:53:52.544+03:00",
                "status": "active",
                "name": "Avast Premier",
                "description": "",
                "public": true,
                "plan_class_id": 3011,
                "product_id": 70,
                "billing_type": "reservation",
                "ancestry": null,
                "reseller_id": 211,
                "plan_class": "Avast-Reservation",
                "product_category_id": 154,
                "product_category": "Productivity",
                "product": "Avast",
                "plan_resources": {
                    "data": [
                        {
                            "id": "2207",
                            "type": "plan_resources",
                            "attributes": {
                                "created_at": "2017-09-01T11:37:58.654+03:00",
                                "updated_at": "2017-09-01T11:37:58.654+03:00",
                                "name": "Count",
                                "measurable": null,
                                "unit_of_measure": "unit",
                                "application_template_name": "Avast",
                                "included": 2,
                                "minimum": 2,
                                "limit": 3,
                                "setup_fee": "0.0",
                                "recurring_fee": "4.0",
                                "overuse_fee": "0.0",
                                "renewal_fee": "0.0",
                                "unlimited_units": false,
                                "public": true,
                                "status": "active",
                                "resource_id": 1071,
                                "priority": 0,
                                "net_costs": {
                                    "setup_fee": "0.0",
                                    "recurring_fee": "0.0",
                                    "overuse_fee": "0.0",
                                    "renewal_fee": "0.0"
                                },
                                "custom_attributes": {}
                            }
                        }
                    ]
                },
                "plan_periods": {
                    "data": [
                        {
                            "id": "1085",
                            "type": "plan_periods",
                            "attributes": {
                                "created_at": "2017-09-01T11:37:58.682+03:00",
                                "updated_at": "2017-09-01T11:37:58.682+03:00",
                                "duration_value": 2,
                                "duration_type": "month",
                                "setup_fee": "0.0",
                                "recurring_fee": "0.0",
                                "transfer_fee": "0.0",
                                "renewal_fee": "0.0",
                                "trial": false,
                                "public": true,
                                "status": "active",
                                "description": null,
                                "endless": false,
                                "net_costs": {
                                    "setup_fee": "0.0",
                                    "recurring_fee": "0.0",
                                    "transfer_fee": "0.0",
                                    "renewal_fee": "0.0"
                                }
                            }
                        }
                    ]
                },
                "available_account_types": [
                    {
                        "id": 3329,
                        "name": "Personal BLR",
                        "created_at": "2017-09-01T11:33:03.191+03:00",
                        "updated_at": "2017-09-01T11:33:03.191+03:00",
                        "reseller_id": 211,
                        "name_pattern": "%first_name %middle_name %last_name",
                        "primary_name": "",
                        "key": "personalblr",
                        "default_payment_method_id": 2,
                        "ancestry": "1",
                        "use_by_default": false
                    },
                    {
                        "id": 3333,
                        "name": "Business BLR",
                        "created_at": "2017-09-01T11:33:03.254+03:00",
                        "updated_at": "2017-09-01T11:33:03.254+03:00",
                        "reseller_id": 211,
                        "name_pattern": "%primary_name",
                        "primary_name": "Company name",
                        "key": "businessblr",
                        "default_payment_method_id": 197,
                        "ancestry": "2",
                        "use_by_default": false
                    }
                ],
                "plan_currency": "USD",
                "custom_attributes": {
                    "111": "",
                    "plannum": "1",
                    "vat25": "0",
                    "item_1c_id": "",
                    "item_1c_for_resellers": ""
                }
            },
            "relationships": {
                "plan_category": {
                    "data": {
                        "id": "154",
                        "type": "plan_categories"
                    }
                }
            }
        }
    ],
    "links": {
        "self": "http://test.activeplatform.com/api/v3/resellers/1/child_reseller_plans?page%5Bnumber%5D=78&page%5Bsize%5D=2",
        "first": "http://test.activeplatform.com/api/v3/resellers/1/child_reseller_plans?page%5Bnumber%5D=1&page%5Bsize%5D=2",
        "prev": "http://test.activeplatform.com/api/v3/resellers/1/child_reseller_plans?page%5Bnumber%5D=77&page%5Bsize%5D=2",
        "next": "http://test.activeplatform.com/api/v3/resellers/1/child_reseller_plans?page%5Bnumber%5D=79&page%5Bsize%5D=2",
        "last": "http://test.activeplatform.com/api/v3/resellers/1/child_reseller_plans?page%5Bnumber%5D=460&page%5Bsize%5D=2"
    }
}