Запросы на бронь
Обновлено: 2026-06-25 00:15 MSK
Заявка на бронь (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) |