Поиск детали по артикулу и бренду (API версия 2)
Версия от 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" } ], ... } ], }