Получение вариантов доставки (API версия 2): различия между версиями
Перейти к навигации
Перейти к поиску
(не показаны 3 промежуточные версии этого же участника) | |||
Строка 1: | Строка 1: | ||
<languages/> | <languages/> | ||
<translate> | <translate> | ||
Для отримання списку варіантів доставки потрібно відправити настпуний | Для отримання списку варіантів доставки потрібно відправити настпуний запит: | ||
<pre> | <pre> | ||
POST https://order24-api.utr.ua/api/deliveries/{date}/{pointId}/{transporterId} | POST https://order24-api.utr.ua/api/deliveries/{date}/{pointId}/{transporterId} | ||
</pre> | </pre> | ||
{date} - Дата відправки замовлення. Текстове поле в форматі | '''{date}''' - Дата відправки замовлення. Текстове поле в форматі РРРР-ММ-ДД. Наприклад: 2016-09-30<br> | ||
{pointId} – Код Точки доставки. Значення поля можна отримати із сервису [[Special:MyLanguage/Получение точек доставки (API версия 2)| | '''{pointId}''' – Код Точки доставки. Значення поля можна отримати із сервису [[Special:MyLanguage/Получение точек доставки (API версия 2)|Отримання точек доставки]]<br> | ||
{transporterId} – Код перевізника. Значення поля можна отримати з сервису [[Special:MyLanguage/Получение перевозчиков (API версия 2)| | '''{transporterId}''' – Код перевізника. Значення поля можна отримати з сервису [[Special:MyLanguage/Получение перевозчиков (API версия 2)|Отримання перевізників]]<br> | ||
додавши при цьому в headers<br> | |||
Authorization: Bearer eyJ0eXAiOiJKV1Q...<br> | <pre> | ||
Де в Authorization після ключевого слова Bearer потрібно передати отриманий при проходженні аутентифікації token | Authorization: Bearer eyJ0eXAiOiJKV1Q... | ||
</pre><br> | |||
Де в '''Authorization''' після ключевого слова Bearer потрібно передати отриманий при проходженні аутентифікації token | |||
<br><br> | <br><br> | ||
* Body: | * Body: | ||
Строка 18: | Строка 20: | ||
} | } | ||
</pre> | </pre> | ||
де масив storages складається із id складів, | де масив '''storages''' складається із '''id''' складів, з яких повинна відбутися доставка<br><br> | ||
В результаті ви отримаєте одну із наступних відповідей: | В результаті ви отримаєте одну із наступних відповідей: | ||
Строка 39: | Строка 41: | ||
{ | { | ||
"id": 0, | "id": 0, | ||
"name": " | "name": "З даного складу на обрану дату доставки не доступні.", | ||
"time": "00:00", | "time": "00:00", | ||
"timestamp": 1576533600 | "timestamp": 1576533600 | ||
Строка 49: | Строка 51: | ||
== Помилка аутентифікації == | == Помилка аутентифікації == | ||
Можливі відповіді API при помилці аутентифікації наведено в розділі [[Special:MyLanguage/Ошибка аутентификации (API версия 2)| | Можливі відповіді API при помилці аутентифікації наведено в розділі [[Special:MyLanguage/Ошибка аутентификации (API версия 2)|Помилка аутентификациії]] | ||
Текущая версия на 10:25, 21 февраля 2024
Для отримання списку варіантів доставки потрібно відправити настпуний запит:
POST https://order24-api.utr.ua/api/deliveries/{date}/{pointId}/{transporterId}
{date} - Дата відправки замовлення. Текстове поле в форматі РРРР-ММ-ДД. Наприклад: 2016-09-30
{pointId} – Код Точки доставки. Значення поля можна отримати із сервису Отримання точек доставки
{transporterId} – Код перевізника. Значення поля можна отримати з сервису Отримання перевізників
додавши при цьому в headers
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Де в Authorization після ключевого слова Bearer потрібно передати отриманий при проходженні аутентифікації token
- Body:
{ "storages": [1,2] }
де масив storages складається із id складів, з яких повинна відбутися доставка
В результаті ви отримаєте одну із наступних відповідей:
Вказані склади не знайдено
- Status Code: 400 Bad Request Error
- Body:
{ "err": "There is no storages to process" }
Варіанти доставки не знайдено
- Status Code: 200 OK
- Body:
[ { "id": 0, "name": "З даного складу на обрану дату доставки не доступні.", "time": "00:00", "timestamp": 1576533600 } ]
Помилка аутентифікації
Можливі відповіді API при помилці аутентифікації наведено в розділі Помилка аутентификациії
Варіанти доставки
- Status Code: 200 OK
- Body:
[ { "id": 850, "name": "Заказ до 10-15 (из Херсона)\\выезд в 10:30 Рынок (2019-11-29)", "time": "00:00", "timestamp": 1575038033 }, { "id": 1100, "name": "Заказ до 11-15 (из Херсона)\\выезд в 11:30 Рынок (2019-11-29)", "time": "00:00", "timestamp": 1575038033 }, { "id": 1104, "name": "Заказ до 15-15 (из Херсона)\\выезд в 15:30 Рынок (2019-11-29)", "time": "00:00", "timestamp": 1575038033 }, { "id": 1107, "name": "Заказ до 16-30 (из Херсона)\\выезд в 16:45 Рынок (2019-11-29)", "time": "00:00", "timestamp": 1575038033 } ]