Hostme | Запросы на бронь

Запросы на бронь

Обновлено: 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 *pathinteger
requestId *pathstring

POST /requests/{requestId}/approve — подтвердить

Подтверждает заявку, превращая её в полноценную бронь. Ответ — BookingContract (созданная бронь).

ПараметрГдеТип
restaurantId *pathinteger
requestId *pathstring
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 *pathinteger
requestId *pathstring
curl -X DELETE https://api.hostmeapp.com/api/rsv/admin/restaurants/123/requests/REQ_ID \
  -H "Authorization: Bearer $TOKEN"

Когда использовать заявки vs прямые брони

СценарийЧто использовать
Бронь нужно подтвердить вручную (хостом)Заявки (/requests) → approve
Бронь создаётся сразу подтверждённойПрямое создание брони
Нужно увидеть заявки своего приложенияПартнёрские брони (pendingOnly, approvalRequired)