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

Материал из UniqTrade API
Перейти к навигации Перейти к поиску
 
(не показана 1 промежуточная версия этого же участника)
Строка 5: Строка 5:
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": {
Строка 14: Строка 14:
</pre>
</pre>
додав при цьому в headers<br>
додав при цьому в headers<br>
Authorization: Bearer eyJ0eXAiOiJKV1Q...<br>
<pre>
Authorization: Bearer eyJ0eXAiOiJKV1Q...
</pre><br>
Де в Authorization після ключового слова Bearer потрібно передати отриманний при проходженні аутентифікації token  
Де в Authorization після ключового слова Bearer потрібно передати отриманний при проходженні аутентифікації token  
<br><br>
<br><br>
Строка 41: Строка 43:
     "details": [
     "details": [
         {
         {
             "id": 58024,
            "multiplicity": 1,
             "id": 45623,
             "brand": {
             "brand": {
                 "name": "MAHLE ORIGINAL",
                 "name": "WIX FILTERS",
                "displayName": "MAHLE ORIGINAL",
                 "externalCode": "00116"
                 "externalCode": "00169"
             },
             },
             "displayBrand": "MAHLE ORIGINAL",
             "displayBrand": "WIX FILTERS",
             "article": "OC90OF",
             "article": "WL7129-12",
             "title": "Фильтр масляный Mahle Lanos/Aveo (без упаковки)",
             "title": "Фільтр оливи (уп. 12шт) Aveo/Lanos (OP 570T)",
             "quantity": 1,
             "quantity": 1,
             "yourPrice": {
             "yourPrice": {
                 "amount": 82.41,
                 "amount": 88.03,
                 "currency": {
                 "currency": {
                     "code": "UAH"
                     "code": "UAH"
Строка 58: Строка 60:
             },
             },
             "yourPriceUAH": {
             "yourPriceUAH": {
                 "amount": 82.41,
                 "amount": 88.03,
                 "currency": {
                 "currency": {
                     "code": "UAH"
                     "code": "UAH"
Строка 64: Строка 66:
             },
             },
             "yourPriceEUR": {
             "yourPriceEUR": {
                 "amount": 2.77,
                 "amount": 2.17,
                 "currency": {
                 "currency": {
                     "code": "EUR"
                     "code": "EUR"
Строка 73: Строка 75:
                     "storage": {
                     "storage": {
                         "id": 6,
                         "id": 6,
                         "name": "НК"
                         "name": "Миколаїв",
                        "originalName": "Николаев"
                     },
                     },
                     "remain": "> 10"
                     "remain": "4"
                 },
                 },
                 {
                 {
                     "storage": {
                     "storage": {
                         "id": 5,
                         "id": 15,
                         "name": "ОД"
                         "name": "Kиїв Правий",
                        "originalName": "Kиев Правый"
                     },
                     },
                     "remain": "> 5"
                     "remain": "> 10"
                }
            ],
            "detailScanCodes": [
                {
                    "scanCode": "258362823682"
                 }
                 }
             ],
             ],
             "category": {
             "category": {
                 "name": "Фильтр масляный"
                 "name": "Фильтр масляный"
             }
             },
            "modifier": 0,
            "isDisabled": false,
            "hasPartnerRemain": false
         }
         }
     ]
     ]

Текущая версия на 10:12, 21 февраля 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": [
        {
            "multiplicity": 1,
            "id": 45623,
            "brand": {
                "name": "WIX FILTERS",
                "externalCode": "00116"
            },
            "displayBrand": "WIX FILTERS",
            "article": "WL7129-12",
            "title": "Фільтр оливи (уп. 12шт) Aveo/Lanos (OP 570T)",
            "quantity": 1,
            "yourPrice": {
                "amount": 88.03,
                "currency": {
                    "code": "UAH"
                }
            },
            "yourPriceUAH": {
                "amount": 88.03,
                "currency": {
                    "code": "UAH"
                }
            },
            "yourPriceEUR": {
                "amount": 2.17,
                "currency": {
                    "code": "EUR"
                }
            },
            "remains": [
                {
                    "storage": {
                        "id": 6,
                        "name": "Миколаїв",
                        "originalName": "Николаев"
                    },
                    "remain": "4"
                },
                {
                    "storage": {
                        "id": 15,
                        "name": "Kиїв Правий",
                        "originalName": "Kиев Правый"
                    },
                    "remain": "> 10"
                }
            ],
            "detailScanCodes": [
                {
                    "scanCode": "258362823682"
                }
            ],
            "category": {
                "name": "Фильтр масляный"
            },
            "modifier": 0,
            "isDisabled": false,
            "hasPartnerRemain": false
        }
    ]
}

(ожидает обновления)
Для отримання додаткової інформації про зображення та характеристики деталей в результатах пошуку, необхідно передати в параметри запиту "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"
		}
	],
   ...
   }
  ],
}