api.nnz-ipc.ru

Работа с товарами

В данном разделе мы рассмотрим основные методы работы с товарами, способы их получения и фильтрации при помощи API.

Стандартный объект товара:




 











{
    "name": String,             - наименование товара
    "id": Number,               - id товара
    "url": String,              - ссылка на карточку товара на nnz-ipc.ru
    "features": Array,          - список доступных характеристик для этого товара
    "photos": Object || Array,  - ссылки на фотографии товара
    "price": Object,            - розничная цена на товар
    "warehouse": Object,        - наличие на складе (в том числе и резерв)
    "inStock": Object,          - доступно под заказ
    "vendor": Object,           - производитель
    "stockNumber": Object,      - артикул товара на сайте nnz-ipc.ru
    "description": Object       - описание товара
    "shipping": Object          - товары в пути
}

Каждое свойство объекта, кроме name, id, url и features содержит объект следующего вида




 


{
    "name": String,             - наименование данного поля или характеристики на русском языке
    "value": String || Array,   - значение данного поля (строка, если значение одно и массив строк, если значений несколько, например тип поддерживаемой ОС или несколько ссылок на фотографии)
    "id": Number                - id данного поля
}

Получение товара по id

GET: /api/v1/get/item/:id

HEADERS
Authorization: Bearer :token

RESPONSE
Item

(указываете без двоеточия)
:id - идентификатор товара
:token - ваш токен авторизации

Объект ответа: data будет содержать объект товара соответствующего указанному id.

Получение списка товаров по id

GET: /api/v1/get/items?id_list=:id1,:id2,:id3,...

HEADERS
Authorization: Bearer :token

RESPONSE
Items

(указываете без двоеточия)
:id - идентификаторы товара через запятую
:token - ваш токен авторизации

Объект ответа: массив data будет содержать объекты товаров соответствующие указанным id товаров.

Получение списка товаров по id разела каталога

GET: /api/v1/get/items/from?id_list=:id1,:id2,:id3,...

HEADERS
Authorization: Bearer :token

RESPONSE
Items

Дополнительные опции запроса
vendors=:vendor1,:vendor2,:vendor3,...

Пример
/api/v1/get/items/from?id_list=128491&vendors=iei,getac

(указываете без двоеточия)
:id - идентификаторы раздела каталога, через запятую
[:vendors] - наименование вендора, через запятую
:token - ваш токен авторизации

Объект ответа: массив data будет содержать объекты товаров соответствующие указанным id раздела каталога и фильтру по вендору, если таковой имеется.

←