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

Материал из UniqTrade API
Перейти к навигации Перейти к поиску
(Подготовленная к переводу страница)
Строка 1: Строка 1:
<languages/>
<languages/>
<translate>
<translate>
Пакетный поиск деталей позволяет выполнять поиск несколько деталей одним запросом<br>
Пакетний пошук деталей дозволяє виконати пошук декількох деталей одним запросом<br>
Для пакетного поиска деталей нужно отправлять следующий запрос:
Для пакетного пшуку деталей потрібно відправляти нступний запрос:
<pre>
<pre>
POST https://order24-api.utr.ua/api/search
POST https://order24-api.utr.ua/api/search
</pre>
</pre>
добавив при этом в headers<br>
додав при цьому в headers<br>
Authorization: Bearer eyJ0eXAiOiJKV1Q...<br>
Authorization: Bearer eyJ0eXAiOiJKV1Q...<br>
Где в Authorization после ключевого слова Bearer нужно передать полученный при прохождении аутентификации token  
Де в Authorization після ключевого слова Bearer потрібно передати отриманий при проходженні аутентифікації token  
<br><br>
<br><br>
* Body:
* Body:
Строка 23: Строка 23:
</pre>
</pre>


у элемента массива details должен присутствовать ключ(и) <br>
у елемента масиву details повинен бути ключ(и) <br>
"id" - в этом случае ищется деталь по коду детали (внутреннему идентификатору) :<br>
"id" - в цьому випадку шукається деталь по коду деталі (внутреннему идентификатору) :<br>
или<br>
или<br>
"oem" и "brand" - в этом случае происходит поиск детали по паре значений актикул + бренд :<br><br>
"oem" і "brand" - в цьому випадку відбувається пошук деталі по парі значеннь актикул + бренд :<br><br>


В результате вы получите один из следующих ответов:  
В результаті ви отримуєте один із настпуних відповідей:  


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


Возможные ответы API при ошибке аутентификации приведены в разделе [[Special:MyLanguage/Ошибка аутентификации (API версия 2)|Ошибка аутентификации]]
Можливі відповіді API при опомилці аутентифікації приведено в розділі [[Special:MyLanguage/Ошибка аутентификации (API версия 2)|Ошибка аутентификации]]


== Результат поиска ==
== Результат пошуку ==


Результат представляет собой массив, каждый элемент которого - результат поиска соответствующего элемента массива тела запроса. В примере: первый элемент - не правильно заданы поля для поиска, второй - детали не найдены, третий - детали найдены (результат поиска по "oem"+"brand"), четвертый - детали найдены (результат поиска по "id")
Результат представляє собою масив, кажний элемент якого - результат пошуку відповідного елемента масиву тіла запросу. В прикладі: перший елемент - не вірно задані поля для пошуку, другий - деталі не знайдено, третій - детали знайдено (результат пошуку по "oem"+"brand"), четвертий - деталі знайдено (результат пошуку по "id")
* Status Code: 200 OK
* Status Code: 200 OK
* Body:
* Body:

Версия 10:46, 11 июня 2021

Пакетний пошук деталей дозволяє виконати пошук декількох деталей одним запросом
Для пакетного пшуку деталей потрібно відправляти нступний запрос:

POST https://order24-api.utr.ua/api/search

додав при цьому в headers
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Де в Authorization після ключевого слова Bearer потрібно передати отриманий при проходженні аутентифікації token

  • Body:
{
    "details": [
        {"someKey": "some value"},
        {"oem": "OC90", "brand": "KYB"},
        {"oem": "OC90", "brand": "MAHLE ORIGINAL"},
        {"id": 123},
        ...
    ]
}

у елемента масиву details повинен бути ключ(и)
"id" - в цьому випадку шукається деталь по коду деталі (внутреннему идентификатору) :
или
"oem" і "brand" - в цьому випадку відбувається пошук деталі по парі значеннь актикул + бренд :

В результаті ви отримуєте один із настпуних відповідей:

Помилка аутентифікації

Можливі відповіді API при опомилці аутентифікації приведено в розділі Ошибка аутентификации

Результат пошуку

Результат представляє собою масив, кажний элемент якого - результат пошуку відповідного елемента масиву тіла запросу. В прикладі: перший елемент - не вірно задані поля для пошуку, другий - деталі не знайдено, третій - детали знайдено (результат пошуку по "oem"+"brand"), четвертий - деталі знайдено (результат пошуку по "id")

  • Status Code: 200 OK
  • Body:
[
    {
        "error": "No search fields found"
    },
    {
        "details": []
    },
    {
        "details": [
            {
                "detailCard": {
                    "description": "",
                    "images": [
                    ],
                    "title": "Фильтр масляный Mahle Lanos/Aveo (в карт. коробке)"
                },
                "detailAkeneoInfo": [],
                "id": 58023,
                "brand": {
                    "id": 64,
                    "name": "MAHLE ORIGINAL",
                    "displayName": "MAHLE ORIGINAL",
                    "externalCode": "00169"
                },
		...
            }
	]
    },
    {
        "details": [
            {
                "detailCard": {
                    "description": "",
                    "images": [],
                    "title": "Тросик тормоза прав Adriauto Lanos"
                },
                "detailAkeneoInfo": [],
                "id": 123,
                "brand": {
                    "id": 1,
                    "name": "ADRIAUTO",
                    "displayName": "ADRIAUTO",
                    "externalCode": "00001"
                },
                "displayBrand": "ADRIAUTO",
                "article": "06.0202",
                "title": "Тросик тормоза прав Adriauto Lanos",
		...
           }
        ]
    }
]