Поиск детали по артикулу и бренду (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}?brand={brand}

де: {oem} - артикул деталі, {brand} - одно із найменувань бренда або його код

 "brand": {
     "name": "PAGID",
     "displayName": "HELLA PAGID",
     "externalCode": "00037"
 }

додав при цьому в 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",
                "externalCode": "00169"
            },
            "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": 5,
                        "name": "ОД"
                    },
                    "remain": "> 5"
                }
            ],
            "category": {
                "name": "Фильтр масляный"
            }
        }
    ]
}

(ожидает обновления)
Для отримання додаткової інформації про зображення та характеристики деталей в результатах пошуку, необхідно передати в параметри запросу "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"
		}
	],
   ...
   }
  ],
}