Для разработчиков

SmartDelivery API

Интегрируйте свою систему управления рестораном, сайт или приложение с платформой SmartDelivery. HTTP API поверх Express с транспортами REST и tRPC, события в реальном времени и вебхуки iiko.

Base URLhttps://24smartdelivery.ru

REST + tRPC

Два транспорта на одном сервере.

Контекст ресторана

Заголовок x-restaurant-id.

OpenAPI

Спека и Swagger для импорта.

Авторизация

Запросы авторизуются доверенными заголовками, которые клиент прокидывает из сессии. Контекст ресторана обязателен для большинства методов.

Заголовки

x-restaurant-id: 12            # ID ресторана (scope)
x-user-role:    OWNER          # роль пользователя
x-user-name:    Иван%20Петров  # имя (URL-encoded)

Важно

Сейчас сервер доверяет заголовкам (header-trust, MVP) и не проверяет JWT. Публичная авторизация по API-ключам с подписью запросов — в планах. Не выставляйте API в открытый интернет без шлюза авторизации.

Заказы

Список заказов, карточка и комментарии кухни.

Список заказов

Возвращает заказы ресторана с фильтрами по статусу и дате.

GET/api/ordersx-restaurant-id

Параметры

statusstring
Фильтр по статусу (Новый, Готовится, Доставляется…)
datestring
Дата в формате YYYY-MM-DD

curl "https://24smartdelivery.ru/api/orders?status=Готовится" \
  -H "x-restaurant-id: 12"

Ответ 200

[
  {
    "id": 12345,
    "posterixId": "A-981",
    "status": "Готовится",
    "totalAmount": 1250,
    "deliveryZone": "Центр",
    "clientName": "Иван И.",
    "clientPhone": "+7999…",
    "createdAt": "2026-06-05T12:30:00.000Z"
  }
]

Карточка заказа

Полная информация об одном заказе, включая позиции.

GET/api/orders/{id}x-restaurant-id

Параметры

idintegerrequired
Внутренний ID заказа

curl "https://24smartdelivery.ru/api/orders/12345" \
  -H "x-restaurant-id: 12"

Ответ 200

{
  "id": 12345,
  "status": "Готовится",
  "totalAmount": 1250,
  "items": [ { "name": "Пицца Маргарита", "qty": 1 } ],
  "address": "ул. Ленина, 1"
}

Комментарий кухни

Обновляет внутренний комментарий к заказу.

PUT/api/orders/{id}/commentx-restaurant-id

Параметры

idintegerrequired
ID заказа

curl -X PUT "https://24smartdelivery.ru/api/orders/12345/comment" \
  -H "x-restaurant-id: 12" \
  -H "Content-Type: application/json" \
  -d '{"comment":"Без лука"}'

Ответ 200

{ "ok": true }

Кухонный терминал

Очередь кухни, история и смена статусов (KDS).

Очередь кухни

Активные заказы для экрана кухни.

GET/api/kitchen/ordersx-restaurant-id

curl "https://24smartdelivery.ru/api/kitchen/orders" \
  -H "x-restaurant-id: 12"

Ответ 200

[ { "id": 12345, "status": "Готовится", "items": [ … ] } ]

Сменить статус

Переводит заказ в следующий статус приготовления.

POST/api/kitchen/orders/{id}/statusx-restaurant-id

Параметры

idintegerrequired
ID заказа
statusstringrequired
Новый статус

curl -X POST "https://24smartdelivery.ru/api/kitchen/orders/12345/status" \
  -H "x-restaurant-id: 12" \
  -H "Content-Type: application/json" \
  -d '{"status":"Готов"}'

Ответ 200

{ "ok": true, "status": "Готов" }

Дашборд и отчёты

Агрегированная статистика по зонам, статусам и времени доставки.

Статистика заказов

Количество и суммы заказов в разрезе зон и статусов.

GET/api/dashboard/statsx-restaurant-id

curl "https://24smartdelivery.ru/api/dashboard/stats" \
  -H "x-restaurant-id: 12"

Ответ 200

[
  { "deliveryZone": "Центр", "status": "Доставлен", "_count": { "_all": 42 } }
]

Время доставки

Среднее время доставки и ETA по зонам.

GET/api/dashboard/delivery-timesx-restaurant-id

curl "https://24smartdelivery.ru/api/dashboard/delivery-times" \
  -H "x-restaurant-id: 12"

Ответ 200

[ { "zone": "Центр", "avgTime": 38, "eta": "12:45" } ]

Настройки

Зоны доставки, мощности кухни и буферы сборки.

Зоны доставки

Текущие настройки зон: цвет, время доставки, активность.

GET/api/settings/zonesx-restaurant-id

curl "https://24smartdelivery.ru/api/settings/zones" \
  -H "x-restaurant-id: 12"

Ответ 200

[ { "zoneName": "Центр", "color": "#22C55E", "deliveryTime": 40, "isActive": true } ]

Мощности кухни

Лимиты заказов на интервалы и буфер сборки.

GET/api/settings/kitchenx-restaurant-id

curl "https://24smartdelivery.ru/api/settings/kitchen" \
  -H "x-restaurant-id: 12"

Ответ 200

{ "intervals": [ { "startTime": "12:00", "endTime": "13:00", "kitchenLimit": 30000 } ] }

Realtime (SSE)

Поток событий ресторана в реальном времени.

Поток событий

Подписка на события (новый заказ, смена статуса) через Server-Sent Events.

GET/api/eventsx-restaurant-id

Параметры

restaurantIdintegerrequired
ID ресторана

curl -N "https://24smartdelivery.ru/api/events?restaurantId=12"

Ответ 200

data: { "type": "order.created", "payload": { "id": 12345 } }

Вебхуки iiko

Приёмник событий iikoCloud (сервис iiko-service, порт 3010).

Приёмник вебхуков

Принимает массив событий iikoCloud: DeliveryOrderUpdate, StopListUpdate и др.

POST/webhooks/iikoПубличный

curl -X POST "https://iiko.24smartdelivery.ru/webhooks/iiko" \
  -H "Content-Type: application/json" \
  -d '[{"eventType":"DeliveryOrderUpdate","eventTime":"2026-06-05T12:30:00.000Z"}]'

Ответ 200

{ "received": 1 }

Для разработчиков

SmartDelivery API

Base URLhttps://24smartdelivery.ru

REST + tRPC

Два транспорта на одном сервере.

Контекст ресторана

Заголовок x-restaurant-id.

OpenAPI

Спека и Swagger для импорта.

Авторизация

Заголовки

x-restaurant-id: 12            # ID ресторана (scope)
x-user-role:    OWNER          # роль пользователя
x-user-name:    Иван%20Петров  # имя (URL-encoded)

Важно

Заказы

Список заказов, карточка и комментарии кухни.

Список заказов

Возвращает заказы ресторана с фильтрами по статусу и дате.

GET/api/ordersx-restaurant-id

Параметры

statusstring
Фильтр по статусу (Новый, Готовится, Доставляется…)
datestring
Дата в формате YYYY-MM-DD

curl "https://24smartdelivery.ru/api/orders?status=Готовится" \
  -H "x-restaurant-id: 12"

Ответ 200

[
  {
    "id": 12345,
    "posterixId": "A-981",
    "status": "Готовится",
    "totalAmount": 1250,
    "deliveryZone": "Центр",
    "clientName": "Иван И.",
    "clientPhone": "+7999…",
    "createdAt": "2026-06-05T12:30:00.000Z"
  }
]

Карточка заказа

Полная информация об одном заказе, включая позиции.

GET/api/orders/{id}x-restaurant-id

Параметры

idintegerrequired
Внутренний ID заказа

curl "https://24smartdelivery.ru/api/orders/12345" \
  -H "x-restaurant-id: 12"

Ответ 200

{
  "id": 12345,
  "status": "Готовится",
  "totalAmount": 1250,
  "items": [ { "name": "Пицца Маргарита", "qty": 1 } ],
  "address": "ул. Ленина, 1"
}

Комментарий кухни

Обновляет внутренний комментарий к заказу.

PUT/api/orders/{id}/commentx-restaurant-id

Параметры

idintegerrequired
ID заказа

curl -X PUT "https://24smartdelivery.ru/api/orders/12345/comment" \
  -H "x-restaurant-id: 12" \
  -H "Content-Type: application/json" \
  -d '{"comment":"Без лука"}'

Ответ 200

{ "ok": true }

Кухонный терминал

Очередь кухни, история и смена статусов (KDS).

Очередь кухни

Активные заказы для экрана кухни.

GET/api/kitchen/ordersx-restaurant-id

curl "https://24smartdelivery.ru/api/kitchen/orders" \
  -H "x-restaurant-id: 12"

Ответ 200

[ { "id": 12345, "status": "Готовится", "items": [ … ] } ]

Сменить статус

Переводит заказ в следующий статус приготовления.

POST/api/kitchen/orders/{id}/statusx-restaurant-id

Параметры

idintegerrequired
ID заказа
statusstringrequired
Новый статус

curl -X POST "https://24smartdelivery.ru/api/kitchen/orders/12345/status" \
  -H "x-restaurant-id: 12" \
  -H "Content-Type: application/json" \
  -d '{"status":"Готов"}'

Ответ 200

{ "ok": true, "status": "Готов" }

Дашборд и отчёты

Агрегированная статистика по зонам, статусам и времени доставки.

Статистика заказов

Количество и суммы заказов в разрезе зон и статусов.

GET/api/dashboard/statsx-restaurant-id

curl "https://24smartdelivery.ru/api/dashboard/stats" \
  -H "x-restaurant-id: 12"

Ответ 200

[
  { "deliveryZone": "Центр", "status": "Доставлен", "_count": { "_all": 42 } }
]

Время доставки

Среднее время доставки и ETA по зонам.

GET/api/dashboard/delivery-timesx-restaurant-id

curl "https://24smartdelivery.ru/api/dashboard/delivery-times" \
  -H "x-restaurant-id: 12"

Ответ 200

[ { "zone": "Центр", "avgTime": 38, "eta": "12:45" } ]

Настройки

Зоны доставки, мощности кухни и буферы сборки.

Зоны доставки

Текущие настройки зон: цвет, время доставки, активность.

GET/api/settings/zonesx-restaurant-id

curl "https://24smartdelivery.ru/api/settings/zones" \
  -H "x-restaurant-id: 12"

Ответ 200

[ { "zoneName": "Центр", "color": "#22C55E", "deliveryTime": 40, "isActive": true } ]

Мощности кухни

Лимиты заказов на интервалы и буфер сборки.

GET/api/settings/kitchenx-restaurant-id

curl "https://24smartdelivery.ru/api/settings/kitchen" \
  -H "x-restaurant-id: 12"

Ответ 200

{ "intervals": [ { "startTime": "12:00", "endTime": "13:00", "kitchenLimit": 30000 } ] }

Realtime (SSE)

Поток событий ресторана в реальном времени.

Поток событий

Подписка на события (новый заказ, смена статуса) через Server-Sent Events.

GET/api/eventsx-restaurant-id

Параметры

restaurantIdintegerrequired
ID ресторана

curl -N "https://24smartdelivery.ru/api/events?restaurantId=12"

Ответ 200

data: { "type": "order.created", "payload": { "id": 12345 } }

Вебхуки iiko

Приёмник событий iikoCloud (сервис iiko-service, порт 3010).

Приёмник вебхуков

Принимает массив событий iikoCloud: DeliveryOrderUpdate, StopListUpdate и др.

POST/webhooks/iikoПубличный

curl -X POST "https://iiko.24smartdelivery.ru/webhooks/iiko" \
  -H "Content-Type: application/json" \
  -d '[{"eventType":"DeliveryOrderUpdate","eventTime":"2026-06-05T12:30:00.000Z"}]'

Ответ 200

{ "received": 1 }