Запросы на бронь
Заявки на бронь, требующие подтверждения хостом: создание запроса, его статусы и обработка на стороне ресторана.
Заявка на бронь (request reservation) — это бронь, которая требует подтверждения хостом, прежде чем стать полноценной. Удобно для модерации броней из внешних каналов: партнёр создаёт заявку, ресторан её подтверждает или отклоняет.
Базовый путь: /api/rsv/admin/restaurants/{restaurantId}/requests.
| Метод | Путь | Назначение |
|---|---|---|
POST | /requests | Создать заявку |
GET | /requests | Список заявок |
GET | /requests/{requestId} | Получить заявку |
PUT | /requests/{requestId} | Изменить заявку |
POST | /requests/{requestId}/approve | Подтвердить заявку (→ бронь) |
DELETE | /requests/{requestId} | Удалить/отклонить заявку |
Создать заявку
POST /requests
Тело — CreateRequestReservationContract. Набор полей совпадает с созданием брони
(см. Создание и управление): reservationTime, groupSize,
customerName, phone, email, customerProfile, additionals и т.д.
curl -X POST https://api.hostmeapp.com/api/rsv/admin/restaurants/123/requests \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "reservationTime": "2026-07-02T19:00:00", "groupSize": 2, "customerName": "Анна Смирнова", "phone": "+79991112233", "specialRequests": "Годовщина", "source": "partner-widget" }'Список заявок
GET /requests
Возвращает заявки ресторана. Параметр пути — restaurantId (integer).
curl https://api.hostmeapp.com/api/rsv/admin/restaurants/123/requests \ -H "Authorization: Bearer $TOKEN"Получить заявку
GET /requests/{requestId}
| Параметр | Где | Тип |
|---|---|---|
restaurantId * | path | integer |
requestId * | path | string |
Подтвердить
POST /requests/{requestId}/approve
Подтверждает заявку, превращая её в полноценную бронь. Ответ — BookingContract
(созданная бронь).
| Параметр | Где | Тип |
|---|---|---|
restaurantId * | path | integer |
requestId * | path | string |
curl -X POST https://api.hostmeapp.com/api/rsv/admin/restaurants/123/requests/REQ_ID/approve \ -H "Authorization: Bearer $TOKEN"Изменить заявку
PUT /requests/{requestId}
Обновляет данные заявки до подтверждения (то же тело, что при создании).
Удалить/отклонить
DELETE /requests/{requestId}
Удаляет заявку (отклонение).
| Параметр | Где | Тип |
|---|---|---|
restaurantId * | path | integer |
requestId * | path | string |
curl -X DELETE https://api.hostmeapp.com/api/rsv/admin/restaurants/123/requests/REQ_ID \ -H "Authorization: Bearer $TOKEN"Когда использовать заявки vs прямые брони
| Сценарий | Что использовать |
|---|---|
| Бронь нужно подтвердить вручную (хостом) | Заявки (/requests) → approve |
| Бронь создаётся сразу подтверждённой | Прямое создание брони |
| Нужно увидеть заявки своего приложения | Партнёрские брони (pendingOnly, approvalRequired) |