Hostme | Партнёрские брони

Партнёрские брони

Обновлено: 2026-06-24 17:30 MSK

Если вы — партнёрское приложение, у вас есть идентификатор appId. По нему можно получить все брони, созданные через ваше приложение, по всем ресторанам, к которым оно подключено.

GET /api/rsv/partner/{appId}/reservations

Возвращает список бронирований, созданных через указанное партнёрское приложение. appId определяет область видимости: возвращаются брони только из ресторанов этого партнёра.

Параметры

ПараметрГдеТипПо умолчаниюОписание
appId *pathstring—Идентификатор партнёрского приложения. Определяет scope — только брони ресторанов этого партнёра
approvalRequiredquerybooleantruetrue — только брони, требующие подтверждения; false — все брони независимо от необходимости подтверждения
pendingOnlyquerybooleantruetrue — только ожидающие (pending) брони; false — брони в любом статусе
fromquerydate-time—Начало периода. Если не указано — без нижней границы
toquerydate-time—Конец периода. Если не указано — без верхней границы

Внимание на умолчания. По умолчанию approvalRequired=true и pendingOnly=true — то есть без параметров вернутся только ожидающие подтверждения брони. Чтобы получить все брони приложения, передайте approvalRequired=false&pendingOnly=false.

Примеры

Только ожидающие подтверждения (поведение по умолчанию):

curl "https://api.hostmeapp.com/api/rsv/partner/APP_ID/reservations" \
  -H "Authorization: Bearer $TOKEN"

Все брони приложения за период:

curl -G "https://api.hostmeapp.com/api/rsv/partner/APP_ID/reservations" \
  -H "Authorization: Bearer $TOKEN" \
  --data-urlencode "approvalRequired=false" \
  --data-urlencode "pendingOnly=false" \
  --data-urlencode "from=2026-07-01T00:00:00" \
  --data-urlencode "to=2026-07-31T23:59:59"

Маркировка источника

Чтобы отличать свои брони в общем списке ресторана (GET .../reservations), при создании проставляйте:

  • source — человекочитаемый источник (например, partner-widget);
  • VendorAppId — при работе под токеном Vendor проставляется автоматически и доступен как фильтр в списке броней ресторана.

См. Создание и управление и Аутентификация → типы токенов.

Связанные разделы