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

Материал из UniqTrade API
Версия от 08:18, 4 июня 2021; Administrator (обсуждение | вклад) (Новая страница: «Для поиска детали по артикулу нужно отправлять следующий запрос: <pre> GET https://order24-api.utr.ua/api/s...»)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к навигации Перейти к поиску

Для поиска детали по артикулу нужно отправлять следующий запрос:

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"
		}
	],
   ...
   }
  ],
}