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

Материал из UniqTrade API
Перейти к навигации Перейти к поиску
(Подготовленная к переводу страница)
Строка 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>
де: {oem} - артикул деталі, {brand} - одно із найменувань бренда або його код<br>
<pre>
<pre>
  "brand": {
  "brand": {
Строка 13: Строка 13:
  }
  }
</pre>
</pre>
добавив при этом в headers<br>
додав при цьому в headers<br>
Authorization: Bearer eyJ0eXAiOiJKV1Q...<br>
Authorization: Bearer eyJ0eXAiOiJKV1Q...<br>
Где в Authorization после ключевого слова Bearer нужно передать полученный при прохождении аутентификации token  
Де в Authorization після ключового слова Bearer потрібно передати отриманний при проходженні аутентифікації token  
<br><br>
<br><br>
В результате вы получите один из следующих ответов:  
В результаті ви отримаєте одну із настпуних відповідей:  


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


* Status Code: 200 OK
* Status Code: 200 OK
Строка 29: Строка 29:
</pre>
</pre>


== Ошибка аутентификации ==
== Поимлка аутентифікації ==


Возможные ответы API при ошибке аутентификации приведены в разделе [[Special:MyLanguage/Ошибка аутентификации (API версия 2)|Ошибка аутентификации]]
Можливі відповіді 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":
Для отримання додаткової інформації про зображення та характеристики деталей в результатах пошуку, необхідно передати в параметри запросу "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"
В результаті в элемент масиву "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"
		}
	],
   ...
   }
  ],
}