Лист ожидания

Лист ожидания (walk-in / waitlist) — это очередь гостей, пришедших без брони. Хостес ставит гостя в очередь, система оценивает время ожидания, а когда стол готов — гостя вызывают и рассаживают. Этот раздел покрывает две стороны процесса:

• Сторона ресторана (тег WaitingAdmin, путь /api/wm/admin/restaurant/{restaurantId}/waitings) — постановка в очередь, список, изменение статуса, вызов и рассадка гостя, переписка с ним.
• Гостевая сторона (тег WaitingGuest, путь /api/rsv/mb/guest/walkins) — самостоятельная постановка гостя в очередь, отслеживание позиции в линии и оценки времени.

Все эндпоинты — под Bearer-токеном (см. Аутентификация). Время — ISO 8601 в локальном часовом поясе ресторана. Ошибки — ProblemDetails (см. Ошибки).

Запись листа ожидания (ключевые поля)

Запись очереди описывается контрактом WaitingContract (в ответах) и UpdateWaitingItemContract (при создании/изменении). Ниже — поля, которые нужны в большинстве интеграций.

Вложенные объекты

Постановка гостя в очередь

Добавить запись (сторона ресторана)

POST /waitings

Создаёт запись в листе ожидания от имени персонала. Тело — UpdateWaitingItemContract.

Наиболее используемые поля тела: customerName, phone, groupSize, areas, expectedTimeMinutes (ожидание в минутах), estimatedTurnOverTime, specialRequests, internalNotes, email, tableNumber, waiterIds[], autoSeat, additionals, customerProfile.

curl -X POST https://api.hostmeapp.com/api/wm/admin/restaurant/123/waitings \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "customerName": "Иван Петров",
    "phone": "+79991234567",
    "groupSize": 2,
    "areas": "Терраса",
    "specialRequests": "Столик у окна"
  }'

Гость встаёт в очередь сам

POST /api/rsv/mb/guest/walkins

Гостевой эндпоинт: гость ставит себя в очередь (например, через виджет или киоск). Тело — CreateMobileWalkinContract.

curl -X POST https://api.hostmeapp.com/api/rsv/mb/guest/walkins \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "restaurantId": 123,
    "groupSize": 3,
    "customerName": "Мария Иванова",
    "phone": "+79990000000",
    "expectedTime": 30
  }'

Ответ. Возвращается созданная бронь-запись в виде BookingContract.

Список и чтение записей

Список записей за период

GET /waitings

Возвращает все записи листа ожидания ресторана за период.

Ответ — массив WaitingContract.

curl -G https://api.hostmeapp.com/api/wm/admin/restaurant/123/waitings \
  -H "Authorization: Bearer $TOKEN" \
  --data-urlencode "from=2026-07-01T00:00:00" \
  --data-urlencode "to=2026-07-01T23:59:59"

Компактный список

GET /waitings/compact

Облегчённый список записей (BookingCompactContract) — удобен для табло/дашборда: содержит id, customerName, phone, groupSize, areas, status, state, tableNumber, expectedTime, estimatedTurnOver, unreadMessageCount и др. без полного дерева заказа.

Получить запись по ID

GET /waitings/{waitingItemId}

Возвращает запись по идентификатору. Ответ — WaitingContract.

Изменение и удаление записи

Изменить запись

PUT /waitings/{waitingItemId}

Обновляет запись очереди (имя, телефон, размер компании, зону, ожидание и т.п.). Тело — те же поля, что и при создании (UpdateWaitingItemContract): присылайте изменяемые поля.

curl -X PUT https://api.hostmeapp.com/api/wm/admin/restaurant/123/waitings/ABC_ID \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "groupSize": 4, "areas": "Основной зал", "expectedTimeMinutes": 25 }'

Гость удаляет себя из очереди

DELETE /api/rsv/mb/guest/walkins/{walkinId}

Гостевой эндпоинт: гость снимает свою запись из очереди.

Изменение статуса записи

Жизненный цикл записи управляется отдельными PUT-эндпоинтами. Все они принимают restaurantId (path, integer) и waitingItemId (path, string).

Рассадить гостя

PUT /waitings/{waitingItemId}/sited

Когда гость получает стол, хостес отмечает запись как рассаженную. Тело — SeatBookingContract:

Ответ — обновлённая запись (BookingContract).

curl -X PUT https://api.hostmeapp.com/api/wm/admin/restaurant/123/waitings/ABC_ID/sited \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "tableNumber": "12", "waiterIds": [42] }'

Отменить запись

PUT /waitings/{waitingItemId}/cancel

Вызов гостя

Вызвать гостя

PUT /waitings/{waitingItemId}/call

Когда стол готов, хостес инициирует вызов. Гостю отправляется уведомление о том, что стол готов.

curl -X PUT "https://api.hostmeapp.com/api/wm/admin/restaurant/123/waitings/ABC_ID/call?tableNumber=12" \
  -H "Authorization: Bearer $TOKEN"

Переписка с гостем

Хостес и гость могут обмениваться сообщениями (например, об ожидании или готовности стола).

Сообщения по позиции

GET /waitings/{waitingItemId}/messages

Возвращает массив MessageContract: id, body, time, origin (host/client), phone, deliveryStatus, deliveryTime, isRead.

Отправить сообщение гостю

POST /waitings/{waitingItemId}/sendmessage

Тело — CreateMessageContract (body — текст сообщения).

curl -X POST "https://api.hostmeapp.com/api/wm/admin/restaurant/123/waitings/ABC_ID/sendmessage?origin=host" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "body": "Ваш стол будет готов через 5 минут" }'

Непрочитанные сообщения

GET /waitings/messages/unread/count

Ответ — CountContract: общий count и countItems[] (id записи + count непрочитанных по каждой записи).

Оценка времени ожидания (ETA) и статистика

Статистика очереди (сторона ресторана)

GET /waitings/stats

Возвращает сводку по очереди и оценку среднего времени ожидания. Ответ — WalkinStatistic:

Оценка для гостя

GET /api/rsv/mb/guest/restaurants/{restaurantId}/walkins/expected

Гостевой эндпоинт: оценка ожидаемого времени по размерам компаний. Ответ — ExpectedTimeContract (expectedMinutesForSizes — карта «размер компании → минуты»).

Настройки листа ожидания

GET / PUT /waitings/.../settings

Чтение и изменение настроек модуля очереди. Путь: /api/wm/admin/restaurant/{restaurantId}/settings. Тело/ответ — WaitingSettingsContract:

curl -G https://api.hostmeapp.com/api/wm/admin/restaurant/123/settings \
  -H "Authorization: Bearer $TOKEN"

Гостевая сторона: отслеживание очереди

Гостевые эндпоинты (/api/rsv/mb/guest/walkins) позволяют гостю отслеживать своё место в очереди и управлять своей записью.

Статус walk-in (гость)

GET /api/rsv/mb/guest/walkins/{walkinId}

Возвращает запись гостя (WalkinGuestContract) с полями customerName, phone, groupSize, areas, status, tableNumber, expectedTime, estimatedTurnOverTime, restaurantName, restaurantImage, timeZone, а также профилем гостя и признаками.

Позиция в линии

GET /api/rsv/mb/guest/restaurants/{restaurantId}/walkins/line

Возвращает текущую позицию записи в очереди (LineStateContract):

curl -G "https://api.hostmeapp.com/api/rsv/mb/guest/restaurants/123/walkins/line" \
  -H "Authorization: Bearer $TOKEN" \
  --data-urlencode "walkinId=ABC_ID" \
  --data-urlencode "groupSize=2"

Данные walk-in (гость)

GET /api/rsv/mb/guest/walkins/data

Справочные данные для гостевого интерфейса (GuestWalkinsDataContract): restaurantIds[], statuses[].

Связанные разделы. Для гостей с бронью используйте Бронирования. Общие правила запросов и формат ошибок — в разделах Соглашения и Ошибки.