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

Материал из UniqTrade API
Перейти к навигации Перейти к поиску
(Новая страница: «Для поиска детали по артикулу нужно отправлять следующий запрос: <pre> GET https://order24-api.utr.ua/api/s...»)
 
(Подготовленная к переводу страница)
Строка 1: Строка 1:
<languages/>
<translate>
Для поиска детали по артикулу нужно отправлять следующий запрос:
Для поиска детали по артикулу нужно отправлять следующий запрос:
<pre>
<pre>
Строка 16: Строка 18:
<br><br>
<br><br>
В результате вы получите один из следующих ответов:  
В результате вы получите один из следующих ответов:  
== Товар не найден ==
== Товар не найден ==
* Status Code: 200 OK
* Status Code: 200 OK
* Body:
* Body:
Строка 24: Строка 28:
}
}
</pre>
</pre>
== Ошибка аутентификации ==
== Ошибка аутентификации ==
Возможные ответы API при ошибке аутентификации приведены в разделе [[Ошибка аутентификации (API версия 2)|Ошибка аутентификации]]
 
Возможные ответы API при ошибке аутентификации приведены в разделе [[Special:MyLanguage/Ошибка аутентификации (API версия 2)|Ошибка аутентификации]]
 
== Товар найден ==
== Товар найден ==
* Status Code: 200 OK
* Status Code: 200 OK
* Body:
* Body:
Строка 118: Строка 126:
}
}
<pre>
<pre>
</translate>

Версия 10:04, 4 июня 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"
		}
	],
   ...
   }
  ],
}