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

Метод Get a List of the Child Reseller's Subscriptions используется для получения списка Подписок, существующих у всех Реселлеров, являющихся нижестоящими по отношению к текущему Реселлеру, или по отношению к его выбранному нижестоящему Реселлеру.

Доступ к текущему Реселлеру, относительно которого формируется список нижестоящих Реселлеров, определяется по токену Сотрудника, указанному в заголовке запроса.

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

Аргументы

Название

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

Тип данных

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

Описание

X-Api-TokenheaderstringОбязательныйAPI токен Сотрудника, выполняющего операцию (см. Просмотр и обновление информации о сотруднике)
Content-TypeheaderstringОбязательныйПредназначен для идентификации формата и способа представления сущности
AcceptheaderstringОбязательныйПредназначен для информирования сервера о типах данных, которые поддерживаются клиентом (браузером)
reseller_idpathintegerОбязательныйID Реселлера. Возможно указать ID текущего Реселлера или ID любого из его нижестоящих Реселлеров (см. Просмотр информации о реселлере)
page[size]queryintegerОпциональныйПараметр постраничной навигации. Количество элементов на странице ответа (50 по умолчанию)
page[number]queryintegerОпциональныйПараметр постраничной навигации. Номер страницы ответа
metaqueryboolОпциональныйЗапрос дополнительных атрибутов Подписки. Применимо к Подпискам на основе модулей Vendor Service и Office365

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

Название

Тип данных

Описание

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


id

integerID Подписки

typestringТип данных

attributesobjectИнформация о Подписке


created_at

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


updated_at

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


plan_idintegerID Тарифного плана Подписки


account_idintegerID Клиента, которому принадлежит Подписка


namestringНазвание Подписки


trialbool

Является ли данная Подписка пробной:

  • trueПодписка является пробной;
  • falseПодписка является коммерческой.


statusstring

Статус Подписки (список статусов см. в Просмотр списка подписок)



start_datedateДата активации Подписки


expiration_datedateДата истечения срока действия Подписки


plan_period_idintegerID периода Тарифного плана


promo_codestringКод, который был использован для получения скидки


payment_modelstring

Модель оплаты Подписки. Возможные значения:

  • prepay – Предоплата
  • postpay – Постоплата


payment_model_parametersobjectПараметры модели оплаты Подписки



credit_limitfloatВеличина кредитного лимита, заданная на уровне Правила обслуживания или переопределенная на уровне Клиента или Подписки. Возвращается только для payment_model = postpay



current_debtfloatВеличина текущей задолженности по Подписке. Возвращается только для payment_model = postpay

metaobjectДополнительные атрибуты Подписки


applicationsarrayПеречень дополнительных атрибутов Подписки. Зависит от конкретной Подписки



'attribute.name'stringЗначение атрибута
linksobjectСсылки на страницы для навигации по элементам ответа с учетом заданных параметров постраничной навигации

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

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

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

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

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

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

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

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

{
    "data": [
        {
            "id": "850",
            "type": "subscriptions",
            "attributes": {
                "created_at": "2017-01-30T14:33:06.685+03:00",
                "updated_at": "2018-02-07T01:05:21.928+03:00",
                "plan_id": 75,
                "account_id": 77,
                "name": "Office 365 Enterprise E1",
                "trial": false,
                "status": "waiting_for_manual_approve",
                "start_date": "2017-01-30",
                "expiration_date": "2018-01-30",
                "plan_period_id": 407,
                "promo_code": null,
                "payment_model": "postpay",
                "payment_model_parameters": {
                    "credit_limit": 1000.0,
                    "current_debt": 24.0
                }
            },
            "meta": {
                "applications": [
                    {
                        "plugin_name": "Office365 Plugin",
                        "tenant_id": "5a13b59e-test-test-test-05364ae96da9",
                        "tenant_name": "example.onmicrosoft.com",
                        "order_id": "b73bf9b8-test-test-test-0ae7e73a4d6b",
                        "external_id": "82628CF7-test-test-test-A573E2378267"
                    }
                ]
            }
        },
        {
            "id": "851",
            "type": "subscriptions",
            "attributes": {
                "created_at": "2017-01-30T14:33:10.089+03:00",
                "updated_at": "2017-01-31T01:02:02.975+03:00",
                "plan_id": 75,
                "account_id": 77,
                "name": "Auto provisioning with resources",
                "trial": false,
                "status": "deleted",
                "start_date": null,
                "expiration_date": null,
                "plan_period_id": 407,
                "promo_code": null,
                "payment_model": "prepay",
                "payment_model_parameters": {}
            },
            "meta": {
                "applications": []
            }
        }
    ],
    "links": {
        "self": "https://test.activeplatform.com/api/v3/resellers/1/subscriptions?meta=true&page%5Bnumber%5D=2&page%5Bsize%5D=2",
        "first": "https://test.activeplatform.com/api/v3/resellers/1/subscriptions?meta=true&page%5Bnumber%5D=1&page%5Bsize%5D=2",
        "prev": "https://test.activeplatform.com/api/v3/resellers/1/subscriptions?meta=true&page%5Bnumber%5D=1&page%5Bsize%5D=2",
        "next": "https://test.activeplatform.com/api/v3/resellers/1/subscriptions?meta=true&page%5Bnumber%5D=3&page%5Bsize%5D=2",
        "last": "https://test.activeplatform.com/api/v3/resellers/1/subscriptions?meta=true&page%5Bnumber%5D=1801&page%5Bsize%5D=2"
    }
}