Поиск детали по артикулу и бренду (API версия 2): различия между версиями
(Подготовленная к переводу страница) |
|||
Строка 1: | Строка 1: | ||
<languages/> | <languages/> | ||
<translate> | <translate> | ||
Для | Для пошуку деталі по артикулу потрібно відправляти настпуний запрос: | ||
<pre> | <pre> | ||
GET https://order24-api.utr.ua/api/search/{oem}?brand={brand} | GET https://order24-api.utr.ua/api/search/{oem}?brand={brand} | ||
</pre> | </pre> | ||
де: {oem} - артикул деталі, {brand} - одно із найменувань бренда або його код<br> | |||
<pre> | <pre> | ||
"brand": { | "brand": { | ||
Строка 13: | Строка 13: | ||
} | } | ||
</pre> | </pre> | ||
додав при цьому в headers<br> | |||
Authorization: Bearer eyJ0eXAiOiJKV1Q...<br> | Authorization: Bearer eyJ0eXAiOiJKV1Q...<br> | ||
Де в Authorization після ключового слова Bearer потрібно передати отриманний при проходженні аутентифікації token | |||
<br><br> | <br><br> | ||
В | В результаті ви отримаєте одну із настпуних відповідей: | ||
== Товар не | == Товар не знайдено == | ||
* Status Code: 200 OK | * Status Code: 200 OK | ||
Строка 29: | Строка 29: | ||
</pre> | </pre> | ||
== | == Поимлка аутентифікації == | ||
Можливі відповіді API при помилці аутентифиікації приведено в розділі [[Special:MyLanguage/Помилка аутентифікації (API версія 2)|Помилка аутентифікації]] | |||
== Товар | == Товар знайдено == | ||
* Status Code: 200 OK | * Status Code: 200 OK | ||
Строка 93: | Строка 93: | ||
</pre> | </pre> | ||
<span style="color:red;">(ожидает обновления)</span><br> | <span style="color:red;">(ожидает обновления)</span><br> | ||
Для | Для отримання додаткової інформації про зображення та характеристики деталей в результатах пошуку, необхідно передати в параметри запросу "info=1": | ||
<pre> | <pre> | ||
GET https://order24-api.utr.ua/api/search/{oem}?info=1 | GET https://order24-api.utr.ua/api/search/{oem}?info=1 | ||
</pre> | </pre> | ||
В | В результаті в элемент масиву "details" додатково будуть передано властивості "detailInfo" и "images" | ||
<pre> | <pre> | ||
{ | { |
Версия 10:33, 11 июня 2021
Для пошуку деталі по артикулу потрібно відправляти настпуний запрос:
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" } ], ... } ], }