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

Открытый API Стенд 173 эндпоинта · 25 разделов

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

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

Адрес https://api.mybounty.org/v1

Состояние

Работает
Версия
26.10.19
Контур
Стенд
Работает
9 мин 13 с
Путь
/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.

Аутентификация15 Регистрация, вход, подтверждение почты, восстановление пароля, обновление пары токенов и билет на сокет. Вход: POST /v1/auth/login → access (15 минут) и refresh (при обмене остаётся тем же, Р-467). На стенде входят только почты из списка стенда (Р-279). Капча — по требованию сервиса (captcha_required): ползунок-пазл модуля captcha, в теле — captcha_id и captcha_answer (Р-481). Без входа Нужен вход Профиль15 Свой профиль, аватар, сессии, сохранённые фильтры поиска, настройки писем и пушей, «Транзакции» (оплаты и возвраты) и счётчики непрочитанного для шапки и нижнего меню (/v1/me/badges). Нужен вход. Нужен вход Справочники9 Открытая конфигурация клиента (/v1/config: карта, языки, валюты, регион афиши, включён ли Bounty AI), курсы валют для примерной цены, места, категории, удобства, ближайший сервер (/v1/nodes). Вход не нужен. Без входа Локализация2 Строки клиентов на четырёх языках (en, ru, th, zh-Hans) — тот же набор, что у сайта и приложений (Р-454). Вход не нужен. Без входа Поиск5 Лента пяти категорий (жильё, впечатления, услуги, транспорт, еда), карта, счётчик «Показать N», подсказки строки, края ползунка цены. Курсорная пагинация. Вход не нужен; вошедшему в карточках приходит is_favorite. Без входа Вход по желанию Карта1 Запасной путь тайлов и стиля карты через сервер Bounty, когда OpenFreeMap недоступен (Р-337). Вход не нужен. Без входа События6 Афиша города (Р-280): лента по дням, ближайшие события по одному на событие (страницами), полоска календаря, карта, страница события, справочник категорий. Дни и часы — в поясе площадки (правило №16). Вход не нужен. Без входа Объекты5 Страница объекта любой из пяти категорий, календарь, выходы и места, расчёт цены, отзывы, похожие рядом, условия долгосрочной аренды. Вход не нужен. Без входа Вход по желанию Бизнес2 Страница бизнеса-партнёра: о компании, объекты, отзывы. Вход не нужен. Без входа Вход по желанию Бронирования8 Оформление, список, бронь целиком, отмена с расчётом возврата, лента заказа, билет заселения. Нужна подтверждённая почта. Создание принимает Idempotency-Key. Нужен вход Оплата2 Оплата брони и заказа через Т-Банк (на стенде — только демо-терминал, Р-350), состояние платежа. Нужна подтверждённая почта. Нужен вход Долгосрочная аренда5 Договоры аренды от месяца (Р-130): стадии, задаток, документ, подписи, чеки. Нужна подтверждённая почта. Нужен вход Чат10 Переписка с партнёрами и поддержкой: диалоги, сообщения, вложения, голосовые, прочтение. Realtime — WebSocket /v1/ws. Нужна подтверждённая почта. Нужен вход Уведомления7 Лента уведомлений, прочтение, пуш-устройства (Р-424), отписка по ссылке из письма (без входа). Без входа Нужен вход Отзывы6 Отзывы гостя: оставить по завершённой брони, оценки по критериям, свои отзывы. Нужна подтверждённая почта. Без входа Нужен вход Избранное7 Избранные объекты и подборки. Нужна подтверждённая почта. Нужен вход Жалобы2 Пожаловаться на объект, бизнес, отзыв или сообщение. Нужен вход. Без входа Нужен вход Заявки на подбор1 Заявка «Подберём жильё под ваш запрос» (Р-276): открытая форма с капчей, дальше человека ведёт модератор. Вход по желанию Приватные файлы2 Документы и вложения из приватного хранилища — потоком после проверки прав (правило №7). Нужен вход. Без входа Нужен вход Bounty AI23 Личный помощник туриста (Р-426…Р-429, docs/assistant.md): лента, сообщения текстом, голосом и с вложениями, озвучка и переводчик, блоки ответов, настройки и память. Ответ приходит событием сокета assistant.message. Нужна подтверждённая почта. Нужен вход Планы и уведомления12 Планы по дням, шаги, брони в днях, напоминания «за N минут» и на точное время (Р-428). Нужна подтверждённая почта. Нужен вход Заметки6 Заметки гостя (Р-442): текст, чек-листы, предложения помощника. Нужна подтверждённая почта. Нужен вход Связь и карта сайта2 Раздел «Связь» — тарифы SIM-карт в офисе Bounty HUB (Р-425) и готовая карта сайта для поисковиков (Р-423). Вход не нужен. Без входа Витрина в EGO6 Bounty как модуль ассистента EGO (Р-290): подписанные вызовы /ego/v1, не для клиентов Bounty. Без входа Витрина в EGO: аккаунт и брони14 Аккаунт и брони гостя внутри EGO (Р-369): подписанные вызовы, не для клиентов Bounty. Без входа

Другие API Bounty