Получение списка нижестоящих Реселлеров
Для получения cписка нижестоящих Реселлеров также может использоваться метод Get Resellers List (Customer Store) (см. Получение списка Реселлеров (Customer Store)).
Метод Get the downstream Resellers list используется для получения списка нижестоящих Реселлеров по отношению к текущему Реселлеру, или по отношению к его выбранному нижестоящему Реселлеру.
Доступ к текущему Реселлеру, относительно которого формируется список нижестоящих Реселлеров, определяется по токену Сотрудника, указанному в заголовке запроса.
GET {base_url}/api/v3/resellers/{reseller_id}/child_resellersАргументы
Название | Тип параметра | Тип данных | Обязательный/ | Описание |
|---|---|---|---|---|
| X-Api-Token | header | string | Обязательный | API токен Сотрудника, выполняющего операцию (см. Просмотр и обновление информации о сотруднике) |
| Content-Type | header | string | Обязательный | Предназначен для идентификации формата и способа представления сущности |
| Accept | header | string | Обязательный | Предназначен для информирования сервера о типах данных, которые поддерживаются клиентом (браузером) |
| reseller_id | path | integer | Обязательный | ID Реселлера. Возможно указать ID текущего Реселлера или ID любого из его нижестоящих Реселлеров (см. Просмотр информации о реселлере) |
page[number] | query | integer | Опциональный | Возвращается список Реселлеров по указанному номеру страницы |
page[size] | query | integer | Опциональный | Установка числа элементов на странице |
Модель ответа
| Название | Тип данных | Описание | ||
|---|---|---|---|---|
| id | string | Уникальный идентификатор Реселлера | ||
| type | string | Тип данных | ||
| attributes | object | Информация о Реселлере | ||
| parent-id | string | Уникальный идентификатор вышестоящего (родительского) Реселлера | ||
| created-at | date | Дата создания Реселлера | ||
| updated-at | date | Дата обновления информации о Реселлере | ||
| general | object | Модель основной информации о Реселлере | ||
| name | string | Название Реселлера | ||
| domain | string | Домен Реселлера | ||
| currency | string | Код валюты Реселлера ISO 4217 alfa-3 | ||
| manager | string | Менеджер, прикрепленный к Реселлеру | ||
| company | object | Информация о компании, которая является данным Реселлером | ||
| name | string | Название компании | ||
| address-line-1 | string | Первая строка адреса компании | ||
| address-line-2 | string | Вторая строка адреса компании | ||
| city | string | Город, в котором расположена компания | ||
| state | string | Штат/Область, в которой расположена компания | ||
| zip | string | Почтовый индекс компании | ||
| country | string | Код страны ISO 3166-1 alpha-2, в которой расположена компания | ||
| phone | string | Номер телефона компании в международном формате:
| ||
| fax | string | Номер факса компании | ||
| string | Адрес электронной почты компании | |||
| contacts | object | Модель информации о контактном лице компании, которая является Реселлером | ||
| first-name | string | Имя контактного лица компании | ||
| last-name | string | Фамилия контактного лица компании | ||
| middle-name | string | Отчество контактного лица компании | ||
| position | string | Должность контактного лица компании | ||
| phone | string | Телефонный номер контактного лица компании в международном формате:
| ||
| string | Адрес электронной почты контактного лица компании | |||
| attributes.custom-attributes | object | Дополнительные параметры Реселлера | ||
| attributes.custom-attributes['custom-attribute-key'] | string | Значение Дополнительного параметра | ||
Пример запроса
GET /api/v3/resellers/1/child_resellers?page[size]=2&page[number]=60
Host: test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetest3gJXZH5uHCw
Accept: application/vnd.api+jsonПример ответа
{
"data": [
{
"id": "298",
"type": "resellers",
"attributes": {
"created_at": "2020-02-13T02:43:51.617+03:00",
"updated_at": "2020-02-16T07:36:55.100+03:00",
"parent_id": 1,
"general": {
"created_at": "2020-02-13T02:43:51.617+03:00",
"updated_at": "2020-02-16T07:36:55.100+03:00",
"name": "ResellerRoman",
"domain": "romankumenkotest.com",
"manager": "Roman Kumenko",
"currency": "USD"
},
"company": {
"created_at": "2020-02-13T02:43:51.617+03:00",
"updated_at": "2020-02-16T07:36:55.100+03:00",
"city": "Minsk",
"zip": "",
"country": "BY",
"fax": "",
"name": "RomanCompany",
"address_line_1": "Tanka",
"address_line_2": "",
"state": "Minsk",
"phone": "+375175555555",
"email": ""
},
"contacts": {
"created_at": "2020-02-13T02:43:51.617+03:00",
"updated_at": "2020-02-16T07:36:55.100+03:00",
"first_name": "Roman",
"last_name": "Kumenko",
"middle_name": "",
"position": "",
"phone": "+375175555555",
"email": "roman@lop.com"
},
"custom_attributes": {
"softline1c_plugin_api_password": "",
"softline1c_plugin_api_name": "",
"kpp": "",
"inn": "1321",
"reseller_mpn_id_ttttt": "",
"loc_1": "555",
"l_ocation": "",
"l_ocationv": "",
"ererere": "5445",
"inn_inn": ""
}
}
},
{
"id": "299",
"type": "resellers",
"attributes": {
"created_at": "2019-08-31T07:22:39.751+03:00",
"updated_at": "2019-08-31T07:22:39.778+03:00",
"parent_id": 1,
"general": {
"created_at": "2019-08-31T07:22:39.751+03:00",
"updated_at": "2019-08-31T07:22:39.778+03:00",
"name": "ResellerRoman2",
"domain": "",
"manager": "Roman Kumenko",
"currency": "USD"
},
"company": {
"created_at": "2019-08-31T07:22:39.751+03:00",
"updated_at": "2019-08-31T07:22:39.778+03:00",
"city": "Minsk",
"zip": "220017",
"country": "BY",
"fax": "",
"name": "OlegInterprise",
"address_line_1": "Tanka",
"address_line_2": "",
"state": "Minsk",
"phone": "+375179999999",
"email": "oleg@rasava.com"
},
"contacts": {
"created_at": "2019-08-31T07:22:39.751+03:00",
"updated_at": "2019-08-31T07:22:39.778+03:00",
"first_name": "Oleg",
"last_name": "Oleg",
"middle_name": "",
"position": "OlegInterprise",
"phone": "+375179999999",
"email": "oleg@rasava.com"
},
"custom_attributes": {
"softline1c_plugin_api_password": "",
"softline1c_plugin_api_name": "",
"kpp": "",
"inn": "1321",
"reseller_mpn_id_ttttt": "",
"loc_1": "555",
"l_ocation": "",
"l_ocationv": "",
"ererere": "6354",
"inn_inn": ""
}
}
}
],
"links": {
"self": "http://test.activeplatform.com/api/v3/resellers/1/child_resellers?page%5Bnumber%5D=78&page%5Bsize%5D=2",
"first": "http://test.activeplatform.com/api/v3/resellers/1/child_resellers?page%5Bnumber%5D=1&page%5Bsize%5D=2",
"prev": "http://test.activeplatform.com/api/v3/resellers/1/child_resellers?page%5Bnumber%5D=77&page%5Bsize%5D=2",
"next": "http://test.activeplatform.com/api/v3/resellers/1/child_resellers?page%5Bnumber%5D=79&page%5Bsize%5D=2",
"last": "http://test.activeplatform.com/api/v3/resellers/1/child_resellers?page%5Bnumber%5D=80&page%5Bsize%5D=2"
}
}