external:доставка:api:extv2

Различия

Показаны различия между двумя версиями страницы.

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия
Предыдущая версия
external:доставка:api:extv2 [2022/01/26 11:12] – [Общие положения] Александр Ильинexternal:доставка:api:extv2 [2022/10/20 14:40] (текущий) – Добавил описание данных в callback_url Данила Матюшев
Строка 21: Строка 21:
  
 Базовый URL для запросов: **http://IP:PORT/api/v2/ext/** Базовый URL для запросов: **http://IP:PORT/api/v2/ext/**
- 
 Этот URL можно использовать для проверки работоспособности. Этот URL можно использовать для проверки работоспособности.
- 
  
 Если набрать в любом браузере:  http://192.168.1.10:11011/api/v2/ext/  -  при работоспособном настроенном API мы должны получить ответ  Если набрать в любом браузере:  http://192.168.1.10:11011/api/v2/ext/  -  при работоспособном настроенном API мы должны получить ответ 
Строка 32: Строка 30:
 В данном примере 11011 - порт DeliveryHatch, 192.168.1.10 - IP компьютера с установленным сервером мини-доставки. Аналогично стоит проверять доступность сервиса извне после проброса порта. В данном примере 11011 - порт DeliveryHatch, 192.168.1.10 - IP компьютера с установленным сервером мини-доставки. Аналогично стоит проверять доступность сервиса извне после проброса порта.
  
-**Важно**\\+**Важно**
 Не передавайте "нейтральные" значения для необязательных полей в запросах, если нет вещественных данных для этих полей. Не передавайте "нейтральные" значения для необязательных полей в запросах, если нет вещественных данных для этих полей.
 Необязательные поля могут быть безболезненно исключены из запроса. Необязательные поля могут быть безболезненно исключены из запроса.
 +===== Список доступных функций ===== 
 +[[external:доставка:api:extv2#проверка_соединения|/ping]] - проверка соединения  
 +[[external:доставка:api:extv2#получение_меню|/getmenu]] - получение меню 
 +[[external:доставка:api:extv2#валидация_корзины|/validate]] - проверка возможности создания заказа 
 +[[external:доставка:api:extv2#создание_заказа|/postorder]] - создание заказ 
 +[[external:доставка:api:extv2#получение_статуса_заказа|/orderstate]] - Получение статуса заказа 
 +[[external:доставка:api:extv2#получение_списка_активных_заказов|/expressorders]] - Получение списка заказов 
  
 ===== Проверка соединения ===== ===== Проверка соединения =====
Строка 304: Строка 308:
 Запас по времени должен обсуждаться с конкретным заведением.\\ Запас по времени должен обсуждаться с конкретным заведением.\\
  
-**(order.status_callback)** - (url string) URL адрес, на который будут отправлены уведомления об изменении статуса заказа. **ВНИМАНИЕ. Внутри доставки адрес приводится к нижнему регистру (HttP://Ya.Ru/Status -> http://ya.ru/status)**\\+**(order.status_callback)** - (url string) URL адрес, на который будут отправлены уведомления об изменении статуса заказа.\\ **ВНИМАНИЕ. Внутри доставки адрес приводится к нижнему регистру (HttP://Ya.Ru/Status -> http://ya.ru/status)**\\ 
 +При изменении статуса заказа на указанный URL будет отправлен POST запрос со следующим JSON содержимым: 
 +<code> 
 +
 +  "order_id": Integer, // Идентификатор заказа 
 +  "guestmeta": Object, // Метаданные гостя 
 +  "phone_number": String, // Номер телефона гостя 
 +  "status": Integer //Новый статус заказа 
 +
 +</code>
 **введено с версии 3.0.5.1053**\\ **введено с версии 3.0.5.1053**\\
 **order.content** - (array) Список блюд, заказанных гостем. **order.content** - (array) Список блюд, заказанных гостем.
Строка 373: Строка 386:
  
 Расшифровка статусов заказов:\\ Расшифровка статусов заказов:\\
-  * 0 - "Ожидает" - Такой статус имеют заказы только что созданные через API \\ Они еще не обработаны оператором в ресторане. \\ Заказы в статусе 0 не возвращают содержимое (массив items) +  * 0 - "Ожидает" - Такой статус имеют заказы только что созданные через API \\ Они еще не обработаны оператором в ресторане (в кипере заказа еще нет). \\ Заказы в статусе 0 не возвращают содержимое (массив items) 
-  * 1Х - "В работе" - Заказ обработан в заведении и передан на кухню. +  * 1Х - "В работе" - Заказ обработан в заведении и передан на кухню (заказ принят, в кипере создан стол, прошла сервис печать)
-  * 2Х - "В пути" - Заказ отправлен с курьером +  * 2Х - "В пути" - Заказ отправлен с курьером (в кипере выбит пречек или чек) 
-  * 3Х - "В архиве" - Курьер вернулся в ресторан, заказ полностью завершен +  * 3Х - "В архиве" - Курьер вернулся в ресторан, заказ полностью завершен (ручной статус, никак не связан с кипером) 
-  * 4Х - "Отменен" - Работники ресторана отменили заказ по той или иной причине+  * 4Х - "Отменен" - Работники ресторана отменили заказ по той или иной причине. Переход в этот статус возможен как из статуса 0 (т.е. заказ в кипере не создавался даже), так и из любого другого статуса (т.е. в кипере стол с блюдами был создан, потом все блюда удалены и пустой стол закрыт)
  
 ===== Получение списка активных заказов ===== ===== Получение списка активных заказов =====
Строка 428: Строка 441:
 **phone** - Телефон гостя\\ **phone** - Телефон гостя\\
 **fullname** - ФИО гостя\\ **fullname** - ФИО гостя\\
- 
- 
- 
- 
- 
- 
- 
- 
- 
- 
- 
- 
- 
- 
- 
  • external/доставка/api/extv2.1643184766.txt.gz
  • Последнее изменение: 2022/01/26 11:12
  • Александр Ильин