Bounty API Партнёры

Открытый API Релиз 202 эндпоинта · 26 разделов

Bounty API — партнёры

Открытый API бизнеса: объекты пяти категорий, номерной фонд, календарь доступности, цены и правила, брони и заселения, долгосрочная аренда, переписка с гостями, отзывы и финансы. Своё ПО и модули связи с PMS входят ключом API из кабинета партнёра (Компания → Разработчикам).

Адрес https://partner-api.bounty.travel/v1

Состояние

Работает
Версия
26.11.2
Контур
Релиз
Работает
6 ч 59 мин
Путь
/v1
  • База данных в порядке
  • Redis в порядке
  • Хранилище файлов в порядке

Для мониторинга — /health: тот же ответ в JSON

Как устроен

Вход по ключу

Authorization: Bearer bnt_live_… — ключ из кабинета: Компания → Разработчикам. Без входа, сессии и капчи; права — те, что выдал владелец.

Или сотрудник

Кабинет входит человеком: POST /v1/auth/login, токен живёт 15 минут. Своему ПО это не нужно — берите ключ.

Повтор без дубля

Записывающий запрос — с Idempotency-Key: повтор с тем же значением вернёт тот же ответ, а не вторую запись.

Даты в поясе объекта

date_from и date_to — календарные даты без пояса, интервал полуоткрытый: день выезда свободен.

Лимиты

600 запросов в минуту на ключ. Сверх — 429 rate_limited и Retry-After: через сколько секунд повторить.

Ошибки

Всегда один конверт: code, message, details, request_id. Ветвиться — по code.

Сокет

События в реальном времени — /v1/ws: ключ с chat:read или одноразовый билет из POST /v1/auth/ws-ticket.

Аутентификация18 Вход сотрудника паролем, выбор бизнеса, сессии, восстановление пароля. Своему ПО это не нужно: оно входит ключом API (Authorization: Bearer bnt_live_…) — без входа, сессии и капчи. Ключу весь раздел закрыт. Без входа Нужен вход Ключи API4 Ключи бизнеса для своего ПО и интеграций: справочник формы, список, выпуск, отзыв. Только полный доступ и только сессией кабинета — ключом другой ключ не выпустить. Ключ показывается один раз. Нужен вход Вебхуки7 Мы сами сообщаем вашей системе о новой брони, подтверждении, отмене, сообщении гостя и блокировке объекта: адреса, события, секрет подписи, журнал доставок, проверка. Владелец сессией кабинета или ключ с правом webhooks:manage. Нужен вход Анкета бизнеса5 Анкета до проверки модератором. Ключу закрыта. Нужен вход Кабинет8 Профиль бизнеса, числа у меню, свои настройки писем и пушей. Ключу доступны профиль и числа; свои настройки — только человеку. Нужен вход Сотрудники11 Сотрудники, права по разделам и журнал действий — только владельцу. Нужен вход Документы компании4 Документы бизнеса для проверки — только владельцу. Нужен вход Справочники5 Места, удобства, категории, валюты, пояса. Нужен вход Политики отмены4 Условия отмены и сезонные правила. Нужен вход Объекты14 Объекты пяти категорий: создание, правка, публикация, пауза, архив. Нужен вход Фотографии7 Фотографии объекта: загрузка, порядок, подписи. Нужен вход Языки объявления6 Переводы описания и их этапы. Нужен вход Календарь и цены26 Свободные и закрытые даты, цена по дням, правила цен, тарифы, доплаты, выходы. Даты — календарные, в поясе объекта; правка диапазонами — с Idempotency-Key. Нужен вход iCal6 Синхронизация занятости с Airbnb, Booking.com, Agoda и PMS по стандарту iCalendar (RFC 5545) — по номерам: у каждого номера своя ссылка экспорта .ics (работает без входа) и свои календари других площадок, раз в 15 минут. Наши брони календарь не снимает; пересечение — предупреждением и письмом. Без входа Нужен вход Массовые операции4 Календарь и цены по многим объектам одной задачей: ответ 202 с задачей (id, status: queued) сразу, ход и итог — GET /v1/jobs/{id}. Ошибка в одной строке не откатывает пачку. Нужен вход Сопоставления3 Пары «наш объект ↔ ваш объект» на нашей стороне: объект, номер, бронь, тариф. У бизнеса и у каждого приложения — свои; переживают переустановку вашего модуля. Нужен вход Приложения4 Приложения интеграторов, подключённые к бизнесу: список, страница подключения, права, отключение. Только полный доступ и только сессией кабинета. Само приложение шлёт Authorization: Bearer bnt_app_… и X-Bounty-Partner: <id>. Нужен вход Номерной фонд и контракты13 Единицы фонда, их закрытия и долгосрочные контракты. Нужен вход Работа дня10 Обзор, доска дня, шахматка, подготовка (15б). Нужен вход Бронирования13 Брони гостей: подтверждение, отказ, отмена, заселение, выезд, неявка. Нужен вход Долгосрочная аренда6 Заявки и договоры аренды. Нужен вход Финансы4 Начисления, удержания, выплаты, выгрузка. Нужен вход Чат9 Переписка с гостями и поддержкой; сокет /v1/ws принимает и ключ API. Нужен вход Уведомления6 Лента уведомлений бизнеса; устройства для пушей — только человеку. Нужен вход Отзывы3 Отзывы об объектах и ответы на них. Нужен вход Жалобы2 Жалобы партнёра на гостя и объявления. Без входа Нужен вход

Другие API Bounty