Поиск детали по артикулу и бренду (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": {
Строка 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" додатково буде передана властивість "images"
<pre>
<pre>
{
{
Строка 103: Строка 103:
   {
   {
     ...  
     ...  
    "detailInfo": [
        {
            "attribute": {
                "name": "Высота [мм]",
                "title": "Высота [мм]",
                "priority": 0
            },
            "value": "80,0"
        },
        ...
    ],
     "images": [
     "images": [
{
{

Версия 07:14, 7 февраля 2024

Для пошуку деталі по артикулу потрібно відправляти настпуний запит:

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" додатково буде передана властивість "images"

{
  "details": [
   {
    ... 
    "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"
		}
	],
   ...
   }
  ],
}