Пакетный поиск деталей (API версия 2): различия между версиями
Строка 1: | Строка 1: | ||
<languages/> | <languages/> | ||
<translate> | <translate> | ||
Пакетний пошук деталей дозволяє виконати пошук декількох деталей одним | Пакетний пошук деталей дозволяє виконати пошук декількох деталей одним запитом<br> | ||
Для пакетного | Для пакетного пошуку деталей потрібно відправляти нступний запит: | ||
<pre> | <pre> | ||
POST https://order24-api.utr.ua/api/search | POST https://order24-api.utr.ua/api/search | ||
</pre> | </pre> | ||
додавши при цьому в headers<br> | |||
Authorization: Bearer eyJ0eXAiOiJKV1Q...<br> | Authorization: Bearer eyJ0eXAiOiJKV1Q...<br> | ||
Де в Authorization після | Де в Authorization після ключового слова Bearer потрібно передати отриманий при проходженні аутентифікації token | ||
<br><br> | <br><br> | ||
* Body: | * Body: | ||
Строка 25: | Строка 25: | ||
у елемента масиву details повинен бути ключ(і) <br> | у елемента масиву details повинен бути ключ(і) <br> | ||
"id" - в цьому випадку шукається деталь по коду деталі (внутреннему идентификатору) :<br> | "id" - в цьому випадку шукається деталь по коду деталі (внутреннему идентификатору) :<br> | ||
або<br> | |||
"oem" і "brand" - в цьому випадку відбувається пошук деталі по парі значеннь актикул + бренд :<br><br> | "oem" і "brand" - в цьому випадку відбувається пошук деталі по парі значеннь актикул + бренд :<br><br> | ||
В результаті ви отримуєте | В результаті ви отримуєте одну із настпуних відповідей: | ||
== Помилка аутентифікації == | == Помилка аутентифікації == | ||
Строка 36: | Строка 36: | ||
== Результат пошуку == | == Результат пошуку == | ||
Результат представляє собою масив, | Результат представляє собою масив, кожен элемент якого - результат пошуку відповідного елемента масиву тіла запиту. В прикладі: перший елемент - не вірно задані поля для пошуку, другий - деталі не знайдено, третій - детали знайдено (результат пошуку по "oem"+"brand"), четвертий - деталі не знайдено (результат пошуку по "id") | ||
* Status Code: 200 OK | * Status Code: 200 OK | ||
* Body: | * Body: |
Версия 10:21, 7 февраля 2024
Пакетний пошук деталей дозволяє виконати пошук декількох деталей одним запитом
Для пакетного пошуку деталей потрібно відправляти нступний запит:
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 (в карт. коробке)" }, "multiplicity": 1, "isDiscount": false, "productCode": "0095421", "totalRemains": 10, "id": 58023, "brand": { "id": 64, "name": "MAHLE ORIGINAL", "externalCode": "00169" }, "displayBrand": "MAHLE - KNECHT", "article": "OC90", "title": "Фільтр оливи", "quantity": 1, "yourPrice": { "amount": 127.89, "currency": { "numberCode": 980, "code": "UAH", "title": "Гривна" } }, "yourPriceUAH": { "amount": 127.89, "currency": { "numberCode": 980, "code": "UAH", "title": "Гривна" } }, "yourPriceEUR": { "amount": 3.15, "currency": { "numberCode": 978, "code": "EUR", "title": "Евро" } }, "remains": [ { "storage": { "id": 6, "name": "Миколаїв", "originalName": "Николаев", "type": "wholesale" }, "remain": "4" }, ... ], "remainsAll": [ { "storage": { "id": 6, "name": "Миколаїв", "originalName": "Николаев", "type": "wholesale" }, "remain": "4" }, ... ], "detailInfo": [], "detailScanCodes": [ { "id": 37160, "scanCode": "2043236217369" }, { "id": 27238, "scanCode": "4009026037935" } ], "images": [ { "imagePath": "/images/base/brand/mahle_original/OC90/OC90-pic01.jpg", "fullImagePath": "https://order24-file.utr.ua//images/base/brand/mahle_original/OC90/OC90-pic01.jpg", "thumbnail": "https://order24-file.utr.ua/thumbnail/base/brand/mahle_original/OC90/OC90-pic01.jpg", "fileSystemType": "akeneo", "baseUrl": "https://order24-file.utr.ua/", "fileserverHost": "http://10.1.4.30/" } ], "isSale": false, "hasImage": true, "hasApplicability": false, "hasRemain": true, "category": { "id": 197, "name": "Фильтр масляный", "parentId": 35, "promId": 12021001 }, "units": [ { "id": 21987, "unit": { "id": 8, "name": "шт", "externalCode": "2009" }, "weight": 0.298, "volume": 0.506 } ], "modifier": 0, "isDisabled": false, "forecast": [], "hasPartnerRemain": false, "tooltipPriceUAH": { "amount": 127.89, "currency": { "numberCode": 980, "code": "UAH", "title": "Гривна" } }, "tooltipPriceEUR": { "amount": 3.15, "currency": { "numberCode": 978, "code": "EUR", "title": "Евро" } }, "oem": "OC90", "isNotSupplied": false, "visibleBrand": { "id": 219, "title": "MAHLE ORIGINAL", "isOriginal": false, "synonyms": [ { "id": 79, "title": "MAHLE" }, ... ], "aliases": [], "isUtr": false, "parent": { "id": 45, "parent": { "id": 626, "title": "MAHLE - KNECHT", "isOriginal": false, "synonyms": [ { "id": 343, "title": "KNECHT/MAHLE" } ], "aliases": [ { "id": 46, "alias": { "id": 188, "title": "KNECHT", "isOriginal": false, "synonyms": [], "aliases": [], "isUtr": false } } ], "isUtr": false } } }, "pdf": [], "isBoschPromotion": false, "isIlliquid": false, "isTracked": false, "modifierWithRate": 0, "inGarage": { "isInGarage": false, "rootGroupQuantity": "0", "groups": [] }, "isInGarage": false } ] }, { "details": [] } ]