Запросы позволяют получать актуальные данные о продуктах из интернет-магазина. Пожалуйста, обратитесь к этой документации для правильной обработки запросов от нас.

HTTP POST-запрос

Заголовок запроса:

Authorization: Bearer {ваш уникальный токен},
Content-Type: application/json,
 

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

{
   "method": "getProducts",
   "details": 0, 
   "offset": 0,
   "count": 10
}

ИмяТипЗначениеПримечания
methodStringgetProducts 
detailsBoolean0: запрос базовых данных
1: запрос подробной информации о продукте		Подробная информация запрашивается для нового импорта продуктов или при изменении данных о продукте (определяется полем updated в ответном сообщении). Для существующих продуктов запрашивается только базовая информация, такая как цена и наличие.
offsetIntegerLastId из ответного сообщенияИспользуется для продолжения перечисления с последней известной позиции.
countInteger Количество предоставляемых продуктов

 

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

{
   "method": "getProductsBySku",
   "details": 1,
   "sku": [
        "12312321",
        "21312312",
        "12321321"
   ]
}

ИмяТипЗначениеПримечания
methodStringgetProductsBySku 
detailsBoolean0: запрос базовых данных
1: запрос подробной информации о продукте		Подробная информация запрашивается для нового импорта продуктов или при изменении данных о продукте (определяется полем updated в ответном сообщении). Для существующих продуктов запрашивается только базовая информация, такая как цена и наличие.
skuArrayСписок SKUМассив строк с SKU

 

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

{
   "prods": [
       {
           "sku": 12345678,
           "url": "https://example.com",
           "manufacturer": "Производитель Пример",
           "model": "Пример Модели",
           "ean": "1234567890123",
           "price": 9.99,
           "availability": "В наличии",
           "itemsAvailable": 42,
           "updated": "2020-02-20 15:44:49"
       }
   ],
   "lastId": 1234
}

Пример ответа с флагом details установленным:
{
   "prods": [
       {
           "sku": "12345678",
           "url": "https://example.com",
           "manufacturer": "Производитель Пример",
           "model": "Пример Модели",
           "ean": "1234567890123",
           "price": 9.99,
           "availability": "В наличии",
           "itemsAvailable": 42,
           "itemCondition": "Новый",
           "category": "Пример категории",
           "name": "Пример продукта",
           "description": "Описание Примерного продукта",
           "updated": "2020-02-20 15:44:49",
           "delivery": [
               {
                   "country": [
                       "BE",
                       "DE"
                   ],
                   "carriers": [
                       {
                           "name": "UPS",
                           "shippingRate": 9.99,
                           "deliveryDays": 3
                       },
                       {
                           "name": "Забрать из магазина",
                           "shippingRate": 0,
                           "deliveryDays": 0,
                           "inStore": 1
                   ]
               },
               {
                   "country": "PL",
                   "carriers": [
                       {
                           "shippingRate": 5,
                           "name": "UPS",
                           "deliveryDays": 3
                       },
                       {
                           "shippingRate": 9.99,
                           "name": "UPS",
                           "deliveryDays": 2
                   ]
               }
           ],
           "images": [
                   "https://example.com/image1.jpg",
                   "https://example.com/image2.jpg",
                   "https://example.com/image3.jpg"
           ]
       }
   ],
   "lastId": 1234
}

Описание полей ответа:

НазваниеТипТребуетсяОписание
skuStringОбязательноУникальный номер идентификации товара в магазине
urlStringОбязательноURL-адрес страницы товара
manufacturerStringУсловноПроизводитель товара
modelStringУсловноМодель товара (код производителя или артикул)
eanNumericУсловноШтрих-код EAN-13 товара
priceFloatОбязательноЦена товара, включая НДС
availabilityStringОбязательноНаличие товара в соответствии с schema.org
itemsAvailableIntegerОпциональноКоличество товаров в наличии для покупки
itemConditionStringОбязательноСостояние товара в соответствии с schema.org
nameStringОбязательноНазвание товара
categoryStringОбязательноКатегория товара
descriptionStringОпциональноКраткое описание товара
updatedStringОбязательноДата изменения информации о товаре в формате "ГГГГ-ММ-ДД чч:мм:сс"
deliveryArrayОбязательноПараметры доставки товара (см. описание массива ниже)
imagesArrayОпциональноСписок изображений товара
lastIdIntegerОбязательноУникальный номер идентификации последнего продукта. Это значение используется в запросе getProducts в качестве смещения для продолжения списка товаров
Описание массива delivery
НазваниеТипТребуетсяОписание
countryString/ArrayОбязательноКод страны в формате ISO 3166, в которой магазин может доставить товар. Для стран с одинаковыми тарифами и сроками доставки можно предоставить массив кодов стран
carriersArrayОбязательноМассив перевозчиков (см. описание массива ниже)
Описание массива carriers
НазваниеТипТребуетсяОписание
nameStringОбязательноНазвание перевозчика
shippingRateFloatОбязательноСтоимость доставки товара
deliveryDaysIntegerОбязательноОжидаемое время доставки в днях
inStoreBooleanОпциональноЕсли установлено значение 1, значит, товар доступен для самовывоза из магазина

Примечание:
Все даты представлены в формате "ГГГГ-ММ-ДД чч:мм:сс".