Получение информации о Реселлере
Метод Get downstream Reseller information by ID используется для получения информации о текущем Реселлере или о его нижестоящем Реселлере по уникальному идентификационному номеру.
Доступ к текущему Реселлеру, относительно которого формируется список нижестоящих Реселлеров, определяется по токену Сотрудника, указанному в заголовке запроса.
Для получения информации о Реселлере или о его нижестоящем Реселлере также может использоваться метод Get Reseller by ID (Customer Store) (см. Получение информации о Реселлере (Customer Store)).
GET {base_url}/api/v3/resellers/{reseller_id}
Аргументы
Название | Тип параметров | Тип данных | Обязательный/Опциональный | Описание |
---|---|---|---|---|
X-Api-Token | header | string | Обязательный | API токен Сотрудника, выполняющего операцию (см. Просмотр и обновление информации о сотруднике) |
Content-Type | header | string | Обязательный | Предназначен для идентификации формата и способа представления сущности |
Accept | header | string | Обязательный | Предназначен для информирования сервера о типах данных, которые поддерживаются клиентом (браузером) |
reseller_id | path | integer | Обязательный | ID Реселлера. Возможно указать ID текущего Реселлера или ID любого из его нижестоящих Реселлеров (см. Просмотр информации о реселлере) |
Модель ответа
Название | Тип данных | Описание | |||
---|---|---|---|---|---|
id | string | Уникальный идентификатор Реселлера | |||
type | string | Тип данных | |||
attributes | object | Информация о Реселлере | |||
created_at | date | Дата создания Реселлера | |||
updated_at | date | Дата обновления информации о Реселлере | |||
parent_id | string | Уникальный идентификатор вышестоящего (родительского) Реселлера | |||
general | object | Общая информация о Реселлере | |||
created_at | date | Дата создания Реселлера | |||
updated_at | date | Дата обновления информации о Реселлере | |||
name | string | Название Реселлера | |||
domain | string | Домен Реселлера | |||
manager | string | Имя Сотрудника вышестоящего Реселлера (Оператора), ответственного за данного Реселлера | |||
currency | string | Код валюты Реселлера ISO 4217 alfa-3 | |||
company | object | Модель информации о компании, которая является данным Реселлером | |||
created_at | date | Дата создания компании | |||
updated_at | date | Дата обновления информации о компании | |||
city | string | Город, в котором расположена компания | |||
zip | string | Почтовый индекс компании | |||
country | string | Код страны ISO 3166-1 alpha-2, в которой расположена компания | |||
fax | string | Номер факса компании | |||
name | string | Название компании | |||
address_line_1 | string | Первая строка адреса компании | |||
address_line_2 | string | Вторая строка адреса компании | |||
state | string | Штат/Область, в которой расположена компания | |||
phone | string | Номер телефона компании в международном формате:
| |||
string | Адрес электронной почты компании | ||||
contacts | object | Модель информации о контактном лице компании, которая является Реселлером | |||
created_at | date | Дата создания контактного лица | |||
updated_at | date | Дата обновления информации о контактном лице | |||
first_name | string | Имя контактного лица компании | |||
last_ame | string | Фамилия контактного лица компании | |||
middle_name | string | Отчество контактного лица компании | |||
position | string | Должность контактного лица компании | |||
phone | string | Телефонный номер контактного лица компании в международном формате:
| |||
string | Адрес электронной почты контактного лица компании | ||||
manager | object | Информация о Сотруднике вышестоящего Реселлера (Оператора), ответственного за данного Реселлера | |||
created_at | date | Дата создания Сотрудника | |||
updated_at | date | Дата последнего обновления информации о Сотруднике | |||
reseller_id | integer | ID вышестоящего Реселлера (Оператора), к которому относится Сотрудник | |||
id | integer | ID Сотрудника | |||
name | string | Имя Сотрудника | |||
status | string | Статус Сотрудника:
| |||
string | Адрес электронной почты, который используется в качестве логина Сотрудника в Панель управления Оператора | ||||
role | string | Роль Сотрудника (см. Роли сотрудников) | |||
phone | string | Номер телефона Сотрудника в международном формате:
| |||
photo | string | Ссылка на файл фотографии Сотрудника | |||
manager_key | string | Уникальный ключ Менеджера | |||
custom_attributes | object | Дополнительные параметры Сотрудника | |||
['custom_attribute_key'] | string | Значение Дополнительного параметра Сотрудника с указанным ключом | |||
custom_attributes | object | Дополнительные параметры Реселлера | |||
['custom_attribute_key'] | string | Значение Дополнительного параметра Реселлера с указанным ключом |
Пример запроса
GET /api/v3/resellers/1
Host: test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetest3gJXZH5uHCw
Accept: application/vnd.api+json
Пример ответа
{
"data": {
"id": "1",
"type": "resellers",
"attributes": {
"created_at": "2016-08-25T09:26:12.491+03:00",
"updated_at": "2020-01-16T13:10:53.572+03:00",
"parent_id": 27,
"general": {
"created_at": "2016-08-25T09:26:12.491+03:00",
"updated_at": "2020-01-16T13:10:53.572+03:00",
"name": "Reseller Root",
"domain": "test.activeplatform.com",
"manager": "Alena R",
"currency": "BYN"
},
"company": {
"created_at": "2016-08-25T09:26:12.491+03:00",
"updated_at": "2020-01-16T13:10:53.572+03:00",
"city": "Minsk",
"zip": "220053",
"country": "BY",
"fax": "",
"name": "Reseller Root",
"address_line_1": "Main",
"address_line_2": "str",
"state": "Минская",
"phone": "+375250000000",
"email": "example3@gmail.com"
},
"contacts": {
"created_at": "2016-08-25T09:26:12.491+03:00",
"updated_at": "2020-01-16T13:10:53.572+03:00",
"first_name": "Ivan",
"last_name": "Ivanov",
"middle_name": "",
"position": "",
"phone": "+375260000000",
"email": "aaaa@example.ru"
},
"manager": {
"created_at": "2017-10-12T15:27:56.354+03:00",
"updated_at": "2020-11-13T15:49:13.667+03:00",
"reseller_id": 1,
"id": 188,
"name": "Alena R",
"status": "active",
"email": "alena@example.com",
"role": "sales",
"phone": "+375270000000",
"photo": "/images/manager/188/188.jpg",
"manager_key": "",
"custom_attributes": {}
},
"custom_attributes": {
"inn": "",
"email": "",
"l": ""
}
}
}
}