Поиск деталей по артикулу (API версия 2)

From UniqTrade API
Jump to navigation Jump to search
This page contains changes which are not marked for translation.

Для пошуку деталі по артикулу потрібно відправляти наступний запрос:

GET https://order24-api.utr.ua/api/search/{oem}

де: {oem} - артикул деталі
додав при цьому в headers
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Де в Authorization після ключевого слова Bearer потрібно передати отриманий при проходженні аутентифікації token

В результаті ви отримаєте одну із наступних відповідей:

Товар не знайдено

  • Status Code: 200 OK
  • Body:
{
    "details": []
}

Помилка аутентифікації

Можливі відповіді API при помилці аутентифікації наведено в розділі Помилка аутентифікації

Товар знайдено

  • Status Code: 200 OK
  • Body:
{
   "details": [
        {
            "id": 58024,
            "brand": {
                "name": "MAHLE ORIGINAL",
                "displayName": "MAHLE ORIGINAL",
            },
            "displayBrand": "MAHLE ORIGINAL",
            "article": "OC90OF",
            "title": "Фильтр масляный Mahle Lanos/Aveo (без упаковки)",
            "quantity": 1,
            "yourPrice": {
                "amount": 82.41,
                "currency": {
                    "code": "UAH"
                }
            },
            "yourPriceUAH": {
                "amount": 82.41,
                "currency": {
                    "code": "UAH"
                }
            },
            "yourPriceEUR": {
                "amount": 2.77,
                "currency": {
                    "code": "EUR"
                }
            },
            "remains": [
                {
                    "storage": {
                        "id": 6,
                        "name": "НК"
                    },
                    "remain": "> 10"
                },
                {
                    "storage": {
                        "id": 10,
                        "name": "ЗПР"
                    },
                    "remain": "5"
                }
            ],
            "category": {
                "name": "Фильтр масляный"
            },
            "modifier": 0,
            "isDisabled": false,
            "hasPartnerRemain": false
        }
   ]
}

(ожидает обновления)
Для отримання додаткової інформациії про картинки та характеристики деталей в результатах пошуку, необхідно передати в параметри запросу "info=1":

GET https://order24-api.utr.ua/api/search/{oem}?info=1

В результаті в элемент масива "details" додатково будут передані властивості "detailInfo" та "images"

{
  "details": [
   {
    ... 
    "detailInfo": [
        {
            "attribute": {
                "name": "Высота [мм]",
                "title": "Высота [мм]",
                "priority": 0
            },
            "value": "80,0"
        },
        ...
    ],
    "images": [
		{
			"imagePath": "/images/base/brand/mahle_original/OC90/OC90-pic01.jpg",
			"fullImagePath": "https://order24-api.utr.ua/images/base/brand/mahle_original/OC90/OC90-pic01.jpg",
			"thumbnail": "https://order24-api.utr.ua/media/cache/thumbnail/images/base/brand/mahle_original/OC90/OC90-pic01.jpg"
		}
	],
   ...
   }
  ],
}