Получение списка Реселлеров (Customer Store)

Метод Get Resellers List (Customer Store) доступен только при наличии установленного модуля Customer Store (см. Модуль "Настройки Customer Store").

Для получения cписка нижестоящих Реселлеров также может использоваться метод Get the downstream Resellers list (см. Получение списка нижестоящих Реселлеров).

Метод Get Resellers List (Customer Store) используется для получения списка нижестоящих Реселлеров по отношению к текущему Реселлеру.

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

GET {base_url}/api/v3/customer_store/resellers/

Аргументы

Название

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

Тип данных

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

Описание

X-Api-TokenheaderstringОбязательныйAPI токен Сотрудника, выполняющего операцию (см. Просмотр и обновление информации о сотруднике)
Content-TypeheaderstringОбязательныйПредназначен для идентификации формата и способа представления сущности
AcceptheaderstringОбязательныйПредназначен для информирования сервера о типах данных, которые поддерживаются клиентом (браузером)

page[number]

query

integer

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

Возвращается список Реселлеров по указанному номеру страницы

page[size]

query

integer

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

Установка числа элементов на странице

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

НазваниеТип данныхОписание
idstringУникальный идентификатор Реселлера
typestringТип данных
attributesobjectИнформация о Реселлере

parent_idstringУникальный идентификатор вышестоящего (родительского) Реселлера

created_atdateДата создания Реселлера

updated_atdateДата обновления информации о Реселлере

generalobjectМодель основной информации о Реселлере


namestringНазвание Реселлера


domainstringДомен Реселлера


currencystringКод валюты Реселлера ISO 4217 alfa-3


managerstringМенеджер, прикрепленный к Реселлеру

companyobjectИнформация о компании, которая является данным Реселлером


namestringНазвание компании


address_line_1stringПервая строка адреса компании


address_line_2stringВторая строка адреса компании


citystringГород, в котором расположена компания


statestringШтат/Область, в которой расположена компания


zipstringПочтовый индекс компании


countrystringКод страны ISO 3166-1 alpha-2, в которой расположена компания


phonestring

Номер телефона компании в международном формате:

  • + < код страны > < код города или сети > < номер телефона >
  • 00 < код страны > < код города или сети > < номер телефона >


faxstringНомер факса компании


emailstringАдрес электронной почты компании

contactsobjectМодель информации о контактном лице компании, которая является Реселлером


first_namestringИмя контактного лица компании


last_namestringФамилия контактного лица компании


middle_namestringОтчество контактного лица компании


positionstringДолжность контактного лица компании


phonestringТелефонный номер контактного лица компании в международном формате:
  • + < код страны > < код города или сети > < номер телефона >
  • 00 < код страны > < код города или сети > < номер телефона >


emailstringАдрес электронной почты контактного лица компании

attributes.custom_attributesobjectДополнительные параметры Реселлера


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

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

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

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

{
    "data": [
        {
            "id": "297",
            "type": "resellers",
            "attributes": {
                "created_at": "2020-02-06T11:04:58.024+03:00",
                "updated_at": "2020-02-06T11:04:58.031+03:00",
                "parent_id": 294,
                "general": {
                    "created_at": "2020-02-06T11:04:58.024+03:00",
                    "updated_at": "2020-02-06T11:04:58.031+03:00",
                    "name": "3 2 child",
                    "domain": "",
                    "manager": "admin",
                    "currency": "USD"
                },
                "company": {
                    "created_at": "2020-02-06T11:04:58.024+03:00",
                    "updated_at": "2020-02-06T11:04:58.031+03:00",
                    "city": "Минск",
                    "zip": "220005",
                    "country": "BY",
                    "fax": "",
                    "name": "yuy",
                    "address_line_1": "Колоса",
                    "address_line_2": "",
                    "state": "Минская",
                    "phone": "+375298794561",
                    "email": "hko@tttu.by"
                },
                "contacts": {
                    "created_at": "2020-02-06T11:04:58.024+03:00",
                    "updated_at": "2020-02-06T11:04:58.031+03:00",
                    "first_name": "Юлий",
                    "last_name": "Юлий",
                    "middle_name": "",
                    "position": "",
                    "phone": "+375298794599",
                    "email": "ko@tttu.by"
                },
                "custom_attributes": {}
            }
        },
        {
            "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": "romankuzenkotest.com",
                    "manager": "Roman Kuzenko",
                    "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": "Kuzmenko",
                    "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": ""
                }
            }
        }
    ],
    "links": {
        "self": "http://test.activeplatform.com/api/v3/customer_store/resellers/?page%5Bnumber%5D=78&page%5Bsize%5D=2",
        "first": "http://test.activeplatform.com/api/v3/customer_store/resellers/?page%5Bnumber%5D=1&page%5Bsize%5D=2",
        "prev": "http://test.activeplatform.com/api/v3/customer_store/resellers/?page%5Bnumber%5D=77&page%5Bsize%5D=2",
        "next": "http://test.activeplatform.com/api/v3/customer_store/resellers/?page%5Bnumber%5D=79&page%5Bsize%5D=2",
        "last": "http://test.activeplatform.com/api/v3/customer_store/resellers/?page%5Bnumber%5D=80&page%5Bsize%5D=2"
    }
}