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

Материал из UniqTrade API
Перейти к навигации Перейти к поиску
(Подготовленная к переводу страница)
Строка 1: Строка 1:
<languages/>
<languages/>
<translate>
<translate>
Для просмотра списка заказов нужно отправлять следующий запрос:  
Для перегляду списка замовлень потрібно відправити наступний запрос:  
<pre>
<pre>
GET https://order24-api.utr.ua/api/order-list/{date}
GET https://order24-api.utr.ua/api/order-list/{date}
</pre>
</pre>
{date} - дата начала периода для выборки заказов (конец периода - текущая дата)<br>
{date} - дата початку періоду для выборки замовлень (кінець періоду - поточна дата)<br>
добавив при этом в headers<br>
додав при цьому в headers<br>
Authorization: Bearer eyJ0eXAiOiJKV1Q...<br>
Authorization: Bearer eyJ0eXAiOiJKV1Q...<br>
Где в Authorization после ключевого слова Bearer нужно передать полученный при прохождении аутентификации token  
Де в Authorization після ключового слова Bearer потрібно передати отриманий при проходженні аутентифікації token  
<br><br>
<br><br>
Также запрос может быть уточнен путем указания текущей страницы и количества элементов на странице:
Також запрос може бути уточнено шляхов вказання поточної  сторінки та кількості елеметів на сторінці:  
<pre>
<pre>
GET https://order24-api.utr.ua/api/order-list/{date}?page=1&limit=20&mode=period
GET https://order24-api.utr.ua/api/order-list/{date}?page=1&limit=20&mode=period
</pre>
</pre>
Возможно также выполнить поиск заказов, которые содержат определенный товар
Можливо також виконати пошук замовленнь, які містять певний товар
<pre>
<pre>
GET https://order24-api.utr.ua/api/order-list/{date}/{detail_id}
GET https://order24-api.utr.ua/api/order-list/{date}/{detail_id}
</pre>
</pre>
где: {detail_id} – код товара
де: {detail_id} – код товара
<br><br>
<br><br>
В результате вы получите один из следующих ответов:  
В результаті ви отримаєте одну із наступних відповідей:  






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


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




== Заказы не найдены ==
== Замовлення не знайдено ==


* Status Code: 200 OK
* Status Code: 200 OK
Строка 38: Строка 38:




== Список заказов ==
== Список замовлень ==


* Status Code: 200 OK
* Status Code: 200 OK

Версия 13:27, 1 июля 2021

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

GET https://order24-api.utr.ua/api/order-list/{date}

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

Також запрос може бути уточнено шляхов вказання поточної сторінки та кількості елеметів на сторінці:

GET https://order24-api.utr.ua/api/order-list/{date}?page=1&limit=20&mode=period

Можливо також виконати пошук замовленнь, які містять певний товар

GET https://order24-api.utr.ua/api/order-list/{date}/{detail_id}

де: {detail_id} – код товара

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


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

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


Замовлення не знайдено

  • Status Code: 200 OK
  • Body:
[]


Список замовлень

  • Status Code: 200 OK
  • Body:
[
    {
        "id": 4303,
        "externalCode": "УЮТ706690",
        "date": "2019-12-18T15:59:51+02:00",
        "orderItems": [
            {
                "detail": {
                    "id": 58023,
                    "brand": {
                        "name": "MAHLE FILTERS"
                    },
                    "article": "OC90",
                    "title": "Фильтр масляный Mahle Lanos/Aveo",
                    "quantity": 1,
                    "remains": [
                        {
                            "storage": {
                                "id": 5,
                                "name": "ОД"
                            },
                            "remain": "6"
                        },
                        ...
                    ],
                    "category": {
                        "name": "Фильтр масляный"
                    }
                },
                "storage": {
                    "id": 5,
                    "name": "ОД"
                },
                "quantity": 1,
                "price": {
                    "amount": 81.54
                }
            }
        ],
        "status": "processing",
        "delivery": {
            "name": "До 10-30 заказ \\ Выезд 11-00 ЛЕНИНГРАДКА - КИЕВ2 (Доставка с 11:00 до 13:30)"
        },
        "paymentType": "beznal",
        "amount": {
            "amount": 81.54,
            "currency": {
                "code": "UAH"
            }
        }
    },
   {
        "id": 4297,
        "externalCode": "УЮТ706564",
        "date": "2019-11-27T14:12:19+02:00",
        "orderItems": [
            {
                "detail": {
                    "id": 4106,
                    "brand": {
                        "name": "BOSCH"
                    },
                    "article": "0451103079",
                    "title": "Фильтр масляный Lanos/Lacetti",
                    "quantity": 1,
                    "remains": [
                        {
                            "storage": {
                                "id": 5,
                                "name": "ОД"
                            },
                            "remain": "8"
                        },
                        ...
                    ],
                    "category": {
                        "name": "Фильтр масляный"
                    }
                },
                "storage": {
                    "id": 5,
                    "name": "ОД"
                },
                "quantity": 4,
                "price": {
                    "amount": 58.1
                }
            },
            {
                "detail": {
                    "id": 56712,
                    "brand": {
                        "name": "MAHLE FILTERS"
                    },
                    "article": "KL749",
                    "title": "Фильтр топливный Mahle",
                    "quantity": 1,
                    "remains": [
                        {
                            "storage": {
                                "id": 6,
                                "name": "НК"
                            },
                            "remain": "1"
                        }
                    ],
                    "category": {
                        "name": "Фильтр топливный"
                    }
                },
                "storage": {
                    "id": 5,
                    "name": "ОД"
                },
                "quantity": 1,
                "price": {
                    "amount": 426.02
                }
            },
            ...
        ],
        "status": "processing",
        "delivery": {
            "name": "5 До 14:30 заказ [СЛОБОДКА Одесса] доставка с 15:00"
        },
        "paymentType": "nal",
        "amount": {
            "amount": 1561.38,
            "currency": {
                "code": "UAH"
            }
        }
    },
    ...
]