Bounty API Пользователи

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

Bounty API — пользователи

Открытый API гостя: поиск и карта, карточки объектов пяти категорий, афиша раздела «События», бронирование, долгосрочная аренда, чат, отзывы, профиль.

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

Состояние

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

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

Как устроен

Версия в пути

Все пути начинаются с /v1. Ломающие изменения выходят новой версией пути, а не правкой текущей.

Вход

Authorization: Bearer <access>: токен живёт 15 минут, обновляется POST /v1/auth/refresh. Токен другого API не принимается.

Ошибки

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

Списки страницами

Курсор: ответ отдаёт next_cursor, следующий запрос передаёт его в cursor. Нет курсора — список кончился.

Лимиты

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

Сокет

События в реальном времени — /v1/ws по одноразовому билету из POST /v1/auth/ws-ticket.

Аутентификация16 Регистрация, вход, подтверждение почты, восстановление пароля, обновление пары токенов и билет на сокет. Вход: POST /v1/auth/login → access (15 минут) и refresh (при обмене остаётся тем же). На стенде входят только почты из списка стенда. Капча — по требованию сервиса (captcha_required): ползунок-пазл модуля captcha, в теле — captcha_id и captcha_answer. Без входа Нужен вход Профиль15 Свой профиль, аватар, сессии, сохранённые фильтры поиска, настройки писем и пушей, «Транзакции» (оплаты и возвраты) и счётчики непрочитанного для шапки и нижнего меню (/v1/me/badges). Нужен вход. Нужен вход Токены API3 Свои токены bnt_user_… для скриптов и помощников: выпуск с паролем, список, отзыв. Токен показывается один раз. Права — read, bookings, chat, assistant; вход и сессии, свои токены, устройства и прочие записи токену закрыты (403 api_key_forbidden). Смена пароля отзывает все токены. Нужен вход Справочники9 Открытая конфигурация клиента (/v1/config: карта, языки, валюты, регион афиши, включён ли Bounty AI), курсы валют для примерной цены, места, категории, удобства, ближайший сервер (/v1/nodes). Вход не нужен. Без входа Локализация2 Строки клиентов на четырёх языках (en, ru, th, zh-Hans) — тот же набор, что у сайта и приложений. Вход не нужен. Без входа Поиск5 Лента пяти категорий (жильё, впечатления, услуги, транспорт, еда), карта, счётчик «Показать N», подсказки строки, края ползунка цены. Курсорная пагинация. Вход не нужен; вошедшему в карточках приходит is_favorite. Без входа Вход по желанию Карта1 Запасной путь тайлов и стиля карты через сервер Bounty, когда OpenFreeMap недоступен. Вход не нужен. Без входа События6 Афиша города: лента по дням, ближайшие события по одному на событие (страницами), полоска календаря, карта, страница события, справочник категорий. Дни и часы — в поясе площадки. Вход не нужен. Без входа Объекты5 Страница объекта любой из пяти категорий, календарь, выходы и места, расчёт цены, отзывы, похожие рядом, условия долгосрочной аренды. Вход не нужен. Без входа Вход по желанию Бизнес2 Страница бизнеса-партнёра: о компании, объекты, отзывы. Вход не нужен. Без входа Вход по желанию Бронирования8 Оформление, список, бронь целиком, отмена с расчётом возврата, лента заказа, билет заселения. Нужна подтверждённая почта. Создание принимает Idempotency-Key. Нужен вход Оплата2 Оплата брони и заказа через Т-Банк (на стенде — только демо-терминал), состояние платежа. Нужна подтверждённая почта. Нужен вход Долгосрочная аренда5 Договоры аренды от месяца: стадии, задаток, документ, подписи, чеки. Нужна подтверждённая почта. Нужен вход Чат10 Переписка с партнёрами и поддержкой: диалоги, сообщения, вложения, голосовые, прочтение. Realtime — WebSocket /v1/ws. Нужна подтверждённая почта. Нужен вход Уведомления8 Лента уведомлений, прочтение, пуш-устройства, отписка по ссылке из письма (без входа). Без входа Нужен вход Отзывы6 Отзывы гостя: оставить по завершённой брони, оценки по критериям, свои отзывы. Нужна подтверждённая почта. Без входа Нужен вход Избранное7 Избранные объекты и подборки. Нужна подтверждённая почта. Нужен вход Жалобы2 Пожаловаться на объект, бизнес, отзыв или сообщение. Нужен вход. Без входа Нужен вход Заявки на подбор1 Заявка «Подберём жильё под ваш запрос»: открытая форма с капчей, дальше человека ведёт модератор. Вход по желанию Приватные файлы2 Документы и вложения из приватного хранилища — потоком после проверки прав. Нужен вход. Без входа Нужен вход Bounty AI23 Личный помощник туриста: лента, сообщения текстом, голосом и с вложениями, озвучка и переводчик, блоки ответов, настройки и память. Ответ приходит событием сокета assistant.message. Нужна подтверждённая почта. Нужен вход Планы и уведомления12 Планы по дням, шаги, брони в днях, напоминания «за N минут» и на точное время. Нужна подтверждённая почта. Нужен вход Заметки6 Заметки гостя: текст, чек-листы, предложения помощника. Нужна подтверждённая почта. Нужен вход Связь и карта сайта2 Раздел «Связь» — тарифы SIM-карт в офисе Bounty HUB и готовая карта сайта для поисковиков. Вход не нужен. Без входа Витрина в EGO6 Bounty как модуль ассистента EGO: подписанные вызовы /ego/v1, не для клиентов Bounty. Без входа Витрина в EGO: аккаунт и брони14 Аккаунт и брони гостя внутри EGO: подписанные вызовы, не для клиентов Bounty. Без входа

Другие API Bounty