API для партнёров

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

Заявки на бронь, требующие подтверждения хостом: создание запроса, его статусы и обработка на стороне ресторана.

Заявка на бронь (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 и т.д.

Terminal window
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).

Terminal window
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
Terminal window
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
Terminal window
curl -X DELETE https://api.hostmeapp.com/api/rsv/admin/restaurants/123/requests/REQ_ID \
-H "Authorization: Bearer $TOKEN"

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

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