`,\n`description` и OG-превью, и это единственное место, откуда их взять."},"SessionPlace":{"properties":{"state":{"type":"string","enum":["pending","known","unknown"],"title":"State","description":"known — узнали (без города — только страна); unknown — сервис не знает, адрес частный или попытки кончились: «Место не определено»; pending — ещё узнаём: «Определяем место…»"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"ISO 3166-1, две буквы: по нему флаг и имя страны на языке интерфейса"},"country_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Name","description":"Имя страны по-английски — запасное, когда назвать по коду нечем"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region","description":"Регион — как отдал сервис, по-английски"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"Город — как отдал сервис, по-английски"}},"type":"object","required":["state"],"title":"SessionPlace","description":"Место входа по адресу (Р-483)."},"SessionResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"},"device_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Device Model"},"app_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"App Version"},"ip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"current":{"type":"boolean","title":"Current","description":"Та самая сессия, из которой пришёл запрос"},"place":{"$ref":"#/components/schemas/SessionPlace","description":"Место входа по адресу (Р-483)"}},"type":"object","required":["id","platform","device_model","app_version","ip","created_at","last_used_at","expires_at","current","place"],"title":"SessionResponse","description":"Устройство в списке сессий."},"SettingsRequest":{"properties":{"proactive":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Proactive","description":"all · trips · off"},"voice":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Voice","description":"female · male (Р-429)"},"voice_reply":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Voice Reply","description":"Отвечать голосом на голосовое (Р-429)"},"ask_location":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Ask Location","description":"Можно ли спрашивать точное местоположение (Р-432)"}},"type":"object","title":"SettingsRequest","description":"Меняется только присланное — остальные настройки остаются."},"SimTariff":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"internet":{"type":"string","title":"Internet"},"calls":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Calls"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"},"days":{"type":"integer","title":"Days","description":"Срок действия в днях"},"price":{"$ref":"#/components/schemas/Money"}},"type":"object","required":["id","title","internet","days","price"],"title":"SimTariff"},"SlotBody":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"starts_at":{"type":"string","format":"date-time","title":"Starts At"},"ends_at":{"type":"string","format":"date-time","title":"Ends At"},"timezone":{"type":"string","title":"Timezone"},"unit_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Unit Id"},"duration_min":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Min"},"capacity_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Capacity Total"},"capacity_left":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Capacity Left"},"price_minor":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Price Minor"},"status":{"type":"string","title":"Status"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"},"guide_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Guide Name"},"sales_close_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Sales Close At"}},"type":"object","required":["id","starts_at","ends_at","timezone","duration_min","capacity_total","capacity_left","price_minor","status","language","guide_name"],"title":"SlotBody"},"SlotsResponse":{"properties":{"listing_id":{"type":"string","format":"uuid","title":"Listing Id"},"timezone":{"type":"string","title":"Timezone"},"timezone_notice":{"$ref":"#/components/schemas/TimezoneNoticeBody"},"currency":{"type":"string","title":"Currency"},"slots":{"items":{"$ref":"#/components/schemas/SlotBody"},"type":"array","title":"Slots"},"rates":{"items":{"$ref":"#/components/schemas/RateBody"},"type":"array","title":"Rates","default":[]},"extras":{"items":{"$ref":"#/components/schemas/ExtraBody"},"type":"array","title":"Extras","default":[]}},"type":"object","required":["listing_id","timezone","timezone_notice","currency","slots"],"title":"SlotsResponse"},"SpeechRequest":{"properties":{"block":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Block","description":"Номер блока `phrases` или `driver`; пусто — весь ответ"},"item":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Item","description":"Номер фразы в блоке `phrases`"}},"type":"object","title":"SpeechRequest"},"StayFacts":{"properties":{"bedrooms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Bedrooms"},"guests":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Guests"},"area_sqm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Area Sqm"},"beach_m":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Beach M"}},"type":"object","title":"StayFacts","description":"Факты жилья на плитке (Р-459): неизвестное — `null`."},"StayGuestBody":{"properties":{"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"age":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Age"},"birth_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Birth Date"},"citizenship":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Citizenship"},"is_primary":{"type":"boolean","title":"Is Primary","default":false},"has_document":{"type":"boolean","title":"Has Document","default":false}},"type":"object","title":"StayGuestBody","description":"Участник заказа: кто едет.\n\n**Номер документа наружу не отдаётся никогда** — даже владельцу брони: он\nего и так знает, а лишний путь к расшифрованному полю это лишний способ\nего потерять (правило №7). Вместо номера возвращается `has_document` —\nзаполнено или нет.\n\nДату рождения и номер паспорта спрашиваем, только когда партнёр включил\nэто у объекта (Р-320): страховой они нужны, остальным — нет."},"StayGuestIn":{"properties":{"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"age":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Age"},"birth_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Birth Date"},"citizenship":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Citizenship"},"is_primary":{"type":"boolean","title":"Is Primary","default":false},"has_document":{"type":"boolean","title":"Has Document","default":false},"document_number":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Document Number"}},"type":"object","title":"StayGuestIn","description":"То же, но на запись: здесь есть номер документа.\n\nОтдельная модель, а не поле с `exclude`: исключённое поле пропадает и из\n`model_dump()`, то есть номер не доезжал бы до сервиса вовсе — мы на этом\nуже наступили."},"StayGuestsRequest":{"properties":{"guests":{"items":{"$ref":"#/components/schemas/StayGuestIn"},"type":"array","maxItems":50,"title":"Guests"},"contact_phone":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Contact Phone"}},"type":"object","title":"StayGuestsRequest","description":"Список участников целиком (Р-197) — и телефон для связи (Р-352).\n\nЦеликом, а не по одному: список читается как один ответ на вопрос «кто\nприедет», и правка третьей строки без остальных — операция, которой у\nчеловека в голове не существует. Пустые строки отбрасываются; обязательны\nли данные, решает объект (`guest_details`).\n\nТелефон едет в том же запросе: «кто едет и как с ним связаться» — один\nответ, и на карточке брони это одна форма с одной кнопкой. Не передан —\nне меняется."},"SuggestResponse":{"properties":{"places":{"items":{"$ref":"#/components/schemas/PlaceSuggestion"},"type":"array","title":"Places"},"listings":{"items":{"$ref":"#/components/schemas/ListingSuggestion"},"type":"array","title":"Listings"}},"type":"object","title":"SuggestResponse","description":"Подсказки строки поиска: сперва места, потом объекты."},"SupportOpen":{"properties":{"subject":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Subject"},"topic":{"anyOf":[{"type":"string","enum":["booking","payment","listing","account","other"]},{"type":"null"}],"title":"Topic","description":"Тема кодом (Р-476, нехватка №58): ставится и открытому обращению, пока темы нет"}},"additionalProperties":false,"type":"object","title":"SupportOpen","description":"Обращение в поддержку."},"TicketResponse":{"properties":{"ticket":{"type":"string","title":"Ticket"},"code":{"type":"string","title":"Code","description":"Номер брони: печатается рядом с кодом"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"}},"type":"object","required":["ticket","code","expires_at"],"title":"TicketResponse","description":"Билет заселения. Клиент рисует QR сам — картинка с сервера не нужна."},"TimezoneNotice":{"properties":{"timezone":{"type":"string","title":"Timezone","description":"Пояс площадки","examples":["Asia/Bangkok"]},"label":{"type":"string","title":"Label","description":"Готовая пометка пояса — показывать всегда рядом со временем","examples":["по времени Пхукета (UTC+7)"]},"hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hint","description":"Пояснение о разнице с поясом гостя (заголовок `X-Timezone`); только когда пояса различаются"},"differs":{"type":"boolean","title":"Differs","description":"Пояс гостя отличается от пояса площадки","default":false},"guest_timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Guest Timezone","description":"Пояс гостя, если клиент его прислал"}},"type":"object","required":["timezone","label"],"title":"TimezoneNotice","description":"Пояс площадки и разница с поясом гостя (правило №16).\n\n`label` показывается всегда, `hint` — только когда пояс гостя отличается:\nиначе человек прочитает чужое время как своё."},"TimezoneNoticeBody":{"properties":{"timezone":{"type":"string","title":"Timezone"},"offset_minutes":{"type":"integer","title":"Offset Minutes"},"offset":{"type":"string","title":"Offset"},"place_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Name"},"differs_from_viewer":{"type":"boolean","title":"Differs From Viewer"},"difference_minutes":{"type":"integer","title":"Difference Minutes"},"viewer_timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Viewer Timezone"},"label":{"type":"string","title":"Label"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hint"}},"type":"object","required":["timezone","offset_minutes","offset","differs_from_viewer","difference_minutes","label"],"title":"TimezoneNoticeBody","description":"Готовая пометка о поясе объекта — клиент показывает её как есть."},"TokenPairResponse":{"properties":{"access_token":{"type":"string","title":"Access Token"},"refresh_token":{"type":"string","title":"Refresh Token"},"token_type":{"type":"string","title":"Token Type","default":"Bearer"},"expires_in":{"type":"integer","title":"Expires In","description":"Сколько секунд живёт access-токен"},"session_id":{"type":"string","format":"uuid","title":"Session Id"}},"type":"object","required":["access_token","refresh_token","expires_in","session_id"],"title":"TokenPairResponse","description":"Пара токенов.\n\n`refresh_token` возвращается **один раз** и в базе не хранится: там лежит\nтолько его хеш. Потерял — вход заново."},"UnsubscribeResult":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email","description":"Адрес, который отписан"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role","description":"Чей это аккаунт: user, partner, moderator, admin — страница ведёт в его настройки"}},"type":"object","title":"UnsubscribeResult","description":"Итог отписки по подписанной ссылке — без входа в аккаунт."},"UpcomingResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/EventCard"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Курсор следующей страницы; `null` — страниц больше нет"},"has_more":{"type":"boolean","title":"Has More","description":"Есть ли ещё события после этой страницы","default":false},"total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total","description":"Сколько событий подходит всего — только при `with_total=true`"}},"type":"object","title":"UpcomingResponse","description":"Ближайшие события — по одному на событие, своим ближайшим днём.\n\nВитрине (ряд на главной, письмо) хватает первой страницы. Лента\n«Событий» без выбранного дня листает дальше по `next_cursor` (Р-465);\n`total` — сколько всего **событий** подходит, если попросили `with_total`."},"UploadResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"type":{"type":"string","title":"Type"},"file_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Name"},"file_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"File Size"},"duration_sec":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Sec","description":"Длительность голосового в секундах — измеряется при загрузке"},"waveform":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Waveform","description":"Волна громкости голосового: 48 уровней 0–100 (нехватка №40). Пусто у документа и фото и у голосовых до 15.10.2026"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"Только для фотографий: они лежат в публичном бакете. Голос и документы отдаются потоком через /v1/media"}},"type":"object","required":["id","type"],"title":"UploadResponse","description":"Загруженный файл, готовый к отправке в сообщении."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WsTicketResponse":{"properties":{"ticket":{"type":"string","title":"Ticket"},"expires_in":{"type":"integer","title":"Expires In","description":"Сколько секунд билет действителен"}},"type":"object","required":["ticket","expires_in"],"title":"WsTicketResponse","description":"Одноразовый билет на подключение к `/v1/ws`.\n\nТокеном не является и ничего, кроме сокета, не открывает: веб-клиенту\nтокен недоступен вовсе — он живёт в cookie `HttpOnly`."},"app__routers__assistant__ReadRequest":{"properties":{"up_to_id":{"type":"integer","minimum":1.0,"title":"Up To Id"}},"type":"object","required":["up_to_id"],"title":"ReadRequest"},"app__schemas__catalog__CategoryResponse":{"properties":{"id":{"type":"integer","title":"Id"},"parent_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Parent Id"},"code":{"type":"string","title":"Code"},"icon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon"},"name":{"type":"string","title":"Name"},"listings_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Listings Count","description":"Сколько опубликованных объектов в категории — только с `with_counts=true`"}},"type":"object","required":["id","code","name"],"title":"CategoryResponse","description":"Категория впечатления или услуги."},"app__schemas__chat__ListingCard":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"slug":{"type":"string","title":"Slug"},"kind":{"type":"string","title":"Kind","description":"Раздел: stay · experience · service · transport · food"},"title":{"type":"string","title":"Title","description":"Название на языке запроса"},"photo":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Photo","description":"Первый снимок размерами; `large` может отсутствовать"},"price_from":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Price From","description":"Цена «от»: `minor`, `currency`, `formatted`"}},"type":"object","required":["id","slug","kind","title"],"title":"ListingCard","description":"Карточка объекта над сообщением (Р-484)."},"app__schemas__chat__ReadRequest":{"properties":{"up_to_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Up To Id"}},"type":"object","title":"ReadRequest"},"app__schemas__events__CategoryResponse":{"properties":{"code":{"type":"string","title":"Code","description":"Код для фильтра `category`","examples":["party"]},"name":{"type":"string","title":"Name","description":"Название на языке запроса","examples":["Вечеринки и клубы"]},"icon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon","description":"Иконка Phosphor, если задана"}},"type":"object","required":["code","name"],"title":"CategoryResponse","description":"Категория события: код для фильтра, название для человека."},"app__schemas__events__FeedResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/EventCard"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"has_more":{"type":"boolean","title":"Has More","default":false},"total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total"}},"type":"object","required":["items"],"title":"FeedResponse","description":"Страница ленты (docs/api.md §3)."},"app__schemas__events__MapCluster":{"properties":{"lat":{"type":"number","title":"Lat","description":"Центр кружка"},"lon":{"type":"number","title":"Lon","description":"Центр кружка"},"count":{"type":"integer","title":"Count","description":"Сколько СОБЫТИЙ в ячейке (не их дней)"}},"type":"object","required":["lat","lon","count"],"title":"MapCluster","description":"Кружок с числом: сколько СОБЫТИЙ в ячейке, а не их дней.\n\nРазличие здесь не придирка. Двенадцать еженедельных вечеринок Патонга\nдают за полгода больше трёхсот дней, и кружок «318» над пляжем обещал бы\nгород, которого нет."},"app__schemas__events__MapResponse":{"properties":{"clusters":{"items":{"$ref":"#/components/schemas/app__schemas__events__MapCluster"},"type":"array","title":"Clusters"},"points":{"items":{"$ref":"#/components/schemas/EventCard"},"type":"array","title":"Points"},"truncated":{"type":"boolean","title":"Truncated","default":false},"total":{"type":"integer","title":"Total","default":0}},"type":"object","title":"MapResponse","description":"Карта афиши: либо кружки, либо метки — но не то и другое сразу.\n\nМетка — та же карточка, что в ленте (`EventCard`), и это сделано нарочно:\nна карте и в ленте человек выбирает одно и то же, и вторая форма карточки\nозначала бы второй набор полей, который однажды разойдётся с первым.\n\nСобытие приходит **один раз**, своим ближайшим подходящим днём: на карте\nточка у еженедельной вечеринки одна, сколько бы вторников у неё ни было."},"app__schemas__events__PhotoResponse":{"properties":{"urls":{"additionalProperties":{"type":"string"},"type":"object","title":"Urls","description":"Адреса размеров: `thumb` (480), `medium` (1600), `large` (2560, бывает не всегда — тогда `medium`)","examples":[{"medium":"https://fs.mybounty.org/bounty-public/photos/medium/….jpg","thumb":"https://fs.mybounty.org/bounty-public/photos/thumb/….jpg"}]},"avg_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avg Color","description":"Средний цвет кадра — фон места под снимок, пока он грузится","examples":["#899b7f"]},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width","description":"Ширина исходника, px: по ней и `height` занимается место заранее"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height","description":"Высота исходника, px. Выше ширины — постер: в клетке не режется"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caption","description":"Подпись редакции к снимку"}},"type":"object","required":["urls"],"title":"PhotoResponse","description":"Фотография события. `large` существует не всегда (Р-052)."},"app__schemas__events__PlaceBrief":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Название места на языке запроса","examples":["Пхукет"]},"path":{"items":{"type":"string"},"type":"array","title":"Path","description":"Цепочка от страны к месту","examples":[["Таиланд","Пхукет"]]}},"type":"object","required":["id"],"title":"PlaceBrief","description":"Место: последний уровень и вся цепочка от страны."},"app__schemas__events__TranslationMark":{"properties":{"source":{"type":"string","title":"Source","description":"`original` — текст редакции, `machine` — машинный перевод","examples":["machine"]},"stale":{"type":"boolean","title":"Stale","description":"Оригинал поправили после перевода — показать «перевод устарел»","default":false}},"type":"object","required":["source"],"title":"TranslationMark","description":"Пометка перевода: чьи это слова и не отстал ли он (Р-063, Р-286).\n\n`stale` означает, что редакция поправила оригинал после перевода.\nПоказывать такой текст можно, умалчивать об этом нельзя: человек по нему\nрешает, идти ему или нет."},"app__schemas__notifications__ReadRequest":{"properties":{"up_to_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Up To Id","description":"Без него прочитанным считается всё"}},"additionalProperties":false,"type":"object","title":"ReadRequest"},"app__schemas__search__FeedResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/app__schemas__search__ListingCard"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["items","has_more"],"title":"FeedResponse","description":"Страница ленты. Формат курсора — общий для всего проекта (api.md §3)."},"app__schemas__search__ListingCard":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"slug":{"type":"string","title":"Slug"},"kind":{"type":"string","title":"Kind"},"title":{"type":"string","title":"Title"},"lang":{"type":"string","title":"Lang"},"original_lang":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original Lang"},"translation":{"anyOf":[{"$ref":"#/components/schemas/app__schemas__search__TranslationMark"},{"type":"null"}]},"photo":{"anyOf":[{"$ref":"#/components/schemas/app__schemas__search__PhotoResponse"},{"type":"null"}]},"price_from_minor":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Price From Minor"},"currency":{"type":"string","title":"Currency"},"rating_avg":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rating Avg"},"rating_count":{"type":"integer","title":"Rating Count"},"reviews_count":{"type":"integer","title":"Reviews Count"},"place":{"anyOf":[{"$ref":"#/components/schemas/app__schemas__search__PlaceBrief"},{"type":"null"}]},"distance_m":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Distance M"},"instant_book":{"type":"boolean","title":"Instant Book"},"is_featured":{"type":"boolean","title":"Is Featured"},"is_favorite":{"type":"boolean","title":"Is Favorite"},"terms":{"anyOf":[{"$ref":"#/components/schemas/BookingTerms"},{"type":"null"}]},"availability":{"anyOf":[{"$ref":"#/components/schemas/AvailabilityMark"},{"type":"null"}]},"facts":{"anyOf":[{"$ref":"#/components/schemas/StayFacts"},{"type":"null"}]}},"type":"object","required":["id","slug","kind","title","lang","currency","rating_count","reviews_count","instant_book","is_featured","is_favorite"],"title":"ListingCard","description":"Одна карточка выдачи."},"app__schemas__search__MapCluster":{"properties":{"lat":{"type":"number","title":"Lat"},"lon":{"type":"number","title":"Lon"},"count":{"type":"integer","title":"Count"},"price_from_minor":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Price From Minor"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"}},"type":"object","required":["lat","lon","count"],"title":"MapCluster","description":"Кружок с числом объектов на мелком зуме."},"app__schemas__search__MapResponse":{"properties":{"clusters":{"items":{"$ref":"#/components/schemas/app__schemas__search__MapCluster"},"type":"array","title":"Clusters"},"points":{"items":{"$ref":"#/components/schemas/MapPoint"},"type":"array","title":"Points"},"truncated":{"type":"boolean","title":"Truncated","default":false},"total":{"type":"integer","title":"Total","default":0}},"type":"object","title":"MapResponse","description":"Ответ карты.\n\n`truncated` — объектов в области больше, чем меток в ответе; интерфейс\nобязан предложить приблизить карту, а не делать вид, что показал всё."},"app__schemas__search__PhotoResponse":{"properties":{"urls":{"additionalProperties":{"type":"string"},"type":"object","title":"Urls"},"avg_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avg Color"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"}},"type":"object","required":["urls"],"title":"PhotoResponse","description":"Обложка карточки.\n\n`urls` содержит только **существующие** размеры: `large` создаётся не\nвсегда (Р-052), и клиент, рассчитывающий на три ключа, покажет пустое\nместо."},"app__schemas__search__PlaceBrief":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"path":{"items":{"type":"string"},"type":"array","title":"Path"}},"type":"object","required":["id"],"title":"PlaceBrief","description":"Место объекта: последний уровень и вся цепочка от страны."},"app__schemas__search__TranslationMark":{"properties":{"source":{"type":"string","title":"Source"},"stale":{"type":"boolean","title":"Stale"}},"type":"object","required":["source","stale"],"title":"TranslationMark","description":"Пометка перевода: чем переведено и не устарел ли перевод."},"ErrorEnvelope":{"title":"ErrorEnvelope","description":"Ошибка — всегда один конверт (docs/api.md §2). Ветвиться — по `code`; `message` — для человека и может меняться; `request_id` — номер запроса для поддержки (он же в заголовке `X-Request-Id`).","type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Машинный код ошибки"},"message":{"type":"string","description":"Текст для человека"},"details":{"type":"object","description":"Подробности: поле с ошибкой (`field`), список полей (`fields`), пределы","additionalProperties":true},"request_id":{"type":"string","description":"Номер запроса в журнале"}}}}}},"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Access-токен из `POST /v1/auth/login` (живёт 15 минут, обновляется `POST /v1/auth/refresh`). Заголовок `Authorization: Bearer <access>`."}}},"tags":[{"name":"Аутентификация","description":"Регистрация, вход, подтверждение почты, восстановление пароля, обновление пары токенов и билет на сокет. Вход: `POST /v1/auth/login` → `access` (15 минут) и `refresh` (при обмене остаётся тем же, Р-467). На стенде входят только почты из списка стенда (Р-279). Капча — по требованию сервиса (`captcha_required`): ползунок-пазл модуля captcha, в теле — `captcha_id` и `captcha_answer` (Р-481)."},{"name":"Профиль","description":"Свой профиль, аватар, сессии, сохранённые фильтры поиска, настройки писем и пушей, «Транзакции» (оплаты и возвраты) и счётчики непрочитанного для шапки и нижнего меню (`/v1/me/badges`). Нужен вход."},{"name":"Справочники","description":"Открытая конфигурация клиента (`/v1/config`: карта, языки, валюты, регион афиши, включён ли Bounty AI), курсы валют для примерной цены, места, категории, удобства, ближайший сервер (`/v1/nodes`). Вход не нужен."},{"name":"Локализация","description":"Строки клиентов на четырёх языках (`en`, `ru`, `th`, `zh-Hans`) — тот же набор, что у сайта и приложений (Р-454). Вход не нужен."},{"name":"Поиск","description":"Лента пяти категорий (жильё, впечатления, услуги, транспорт, еда), карта, счётчик «Показать N», подсказки строки, края ползунка цены. Курсорная пагинация. Вход не нужен; вошедшему в карточках приходит `is_favorite`."},{"name":"Карта","description":"Запасной путь тайлов и стиля карты через сервер Bounty, когда OpenFreeMap недоступен (Р-337). Вход не нужен."},{"name":"События","description":"Афиша города (Р-280): лента по дням, ближайшие события по одному на событие (страницами), полоска календаря, карта, страница события, справочник категорий. Дни и часы — в поясе площадки (правило №16). Вход не нужен."},{"name":"Объекты","description":"Страница объекта любой из пяти категорий, календарь, выходы и места, расчёт цены, отзывы, похожие рядом, условия долгосрочной аренды. Вход не нужен."},{"name":"Бизнес","description":"Страница бизнеса-партнёра: о компании, объекты, отзывы. Вход не нужен."},{"name":"Бронирования","description":"Оформление, список, бронь целиком, отмена с расчётом возврата, лента заказа, билет заселения. Нужна подтверждённая почта. Создание принимает `Idempotency-Key`."},{"name":"Оплата","description":"Оплата брони и заказа через Т-Банк (на стенде — только демо-терминал, Р-350), состояние платежа. Нужна подтверждённая почта."},{"name":"Долгосрочная аренда","description":"Договоры аренды от месяца (Р-130): стадии, задаток, документ, подписи, чеки. Нужна подтверждённая почта."},{"name":"Чат","description":"Переписка с партнёрами и поддержкой: диалоги, сообщения, вложения, голосовые, прочтение. Realtime — WebSocket `/v1/ws`. Нужна подтверждённая почта."},{"name":"Уведомления","description":"Лента уведомлений, прочтение, пуш-устройства (Р-424), отписка по ссылке из письма (без входа)."},{"name":"Отзывы","description":"Отзывы гостя: оставить по завершённой брони, оценки по критериям, свои отзывы. Нужна подтверждённая почта."},{"name":"Избранное","description":"Избранные объекты и подборки. Нужна подтверждённая почта."},{"name":"Жалобы","description":"Пожаловаться на объект, бизнес, отзыв или сообщение. Нужен вход."},{"name":"Заявки на подбор","description":"Заявка «Подберём жильё под ваш запрос» (Р-276): открытая форма с капчей, дальше человека ведёт модератор."},{"name":"Приватные файлы","description":"Документы и вложения из приватного хранилища — потоком после проверки прав (правило №7). Нужен вход."},{"name":"Bounty AI","description":"Личный помощник туриста (Р-426…Р-429, `docs/assistant.md`): лента, сообщения текстом, голосом и с вложениями, озвучка и переводчик, блоки ответов, настройки и память. Ответ приходит событием сокета `assistant.message`. Нужна подтверждённая почта."},{"name":"Планы и уведомления","description":"Планы по дням, шаги, брони в днях, напоминания «за N минут» и на точное время (Р-428). Нужна подтверждённая почта."},{"name":"Заметки","description":"Заметки гостя (Р-442): текст, чек-листы, предложения помощника. Нужна подтверждённая почта."},{"name":"Связь и карта сайта","description":"Раздел «Связь» — тарифы SIM-карт в офисе Bounty HUB (Р-425) и готовая карта сайта для поисковиков (Р-423). Вход не нужен."},{"name":"Витрина в EGO","description":"Bounty как модуль ассистента EGO (Р-290): подписанные вызовы `/ego/v1`, не для клиентов Bounty."},{"name":"Витрина в EGO: аккаунт и брони","description":"Аккаунт и брони гостя внутри EGO (Р-369): подписанные вызовы, не для клиентов Bounty."},{"name":"service","description":"Служебное: состояние модуля (`/health`) и версия."}]}

{"openapi":"3.1.0","info":{"title":"Bounty API — пользователи","description":"Открытый API гостя: поиск и карта, карточки объектов пяти категорий, афиша\nраздела «События», бронирование, долгосрочная аренда, чат, отзывы, профиль.\n\nВход **не нужен** для каталога, карты, афиши и карточек: их обязан видеть\nлюбой посетитель. Регистрация требуется там, где появляется он сам —\nбронирование, переписка, избранное, документы.\n\nЭтим же API пользуются веб-клиент, Android, iOS и Telegram-бот: у них один\nконтракт и один набор строк локализации.\n\n\n## Общие правила\n\n**Версия — в пути.** Все эндпоинты начинаются с `/v1`. Ломающие изменения\nвыходят новой версией пути, а не правкой текущей.\n\n**Аутентификация — `Authorization: Bearer `.** Токен выдаёт\n`POST /v1/auth/login`; он живёт 15 минут, обновляется по `refresh`-токену\nчерез `POST /v1/auth/refresh`. Обмен отдаёт свежий `access` и **тот же**\n`refresh`, а срок сессии сдвигается: сессия держится, пока ей пользуются\n(Р-467). Выход и «выйти везде» закрывают сессию сразу.\n\n**Токен одного API никогда не принимается другим.** У каждой аудитории свой\nсекрет подписи, а не только claim `aud`: чужой токен не проходит проверку\nподписи, а не проверку прав.\n\n### Ответы и ошибки\n\nУспех — тело эндпоинта как есть. Ошибка — всегда один и тот же конверт:\n\n```json\n{\n \"error\": {\n \"code\": \"validation_error\",\n \"message\": \"Дата выезда должна быть позже даты заезда\",\n \"details\": {\"field\": \"date_to\"},\n \"request_id\": \"0f1c…\"\n }\n}\n```\n\n`code` — машинный, по нему и нужно ветвиться. `message` — для человека, он\nможет меняться. `request_id` есть в каждом ответе и в заголовке\n`X-Request-Id`: с ним обращение в поддержку находит запрос в журнале за\nсекунды.\n\nКоды: `400 validation_error`, `401 unauthorized`, `403 forbidden`,\n`404 not_found`, `409 conflict`, `422` (проверка схемы), `429 rate_limited`\n(с заголовком `Retry-After`), `500 internal_error`.\n\n### Списки\n\nПагинация **курсорная**, `OFFSET` не используется нигде:\n\n```json\n{\"items\": [...], \"next_cursor\": \"eyJ…\", \"has_more\": true}\n```\n\n`next_cursor` непрозрачен — собирать его руками нельзя, его форма не часть\nконтракта. Нет `next_cursor` — страница последняя.\n\n### Повторы и идемпотентность\n\nСоздающие запросы принимают заголовок `Idempotency-Key`. Повтор с тем же\nключом возвращает **тот же** результат, а не заводит вторую запись. Ключ\nживёт 24 часа.\n\n### Частота\n\nЛимиты считаются по адресу и по актёру. Превышение — `429` с `Retry-After` в\nсекундах. Клиент обязан ждать указанное время, а не повторять сразу.\n\n### Время, деньги и языки\n\n* **Время объекта — в его часовом поясе** и в UTC не переводится никогда.\n Календарные даты (заезд, выезд, день события) — это `date` в поясе объекта.\n Моменты — `timestamptz` в UTC.\n* **Деньги — в минорных единицах** (`price_minor`) вместе с кодом валюты.\n Суммы никогда не приходят от клиента: их считает сервер.\n* **Язык ответа** — заголовок `Accept-Language` или параметр `lang`. Языки:\n `en` (по умолчанию), `ru`, `th`, `zh-Hans`. Непереведённая строка отдаётся\n по-английски, а переведённый контент помечается пометкой о переводе.\n\n### Особенности этого API\n\n* **Поиск по месту — строкой, а не фильтром.** Параметра `place_id` нет:\n район и город приходят в `q` и сверяются с названием, описанием и местом\n объекта на всех языках сразу, по словам.\n* **Realtime** — WebSocket `/v1/ws` с тем же `access`-токеном: чат,\n уведомления, изменения брони.\n* **Фотографии — до трёх размеров** (`thumb` 480, `medium` 1600,\n `large` 2560). `large` существует не всегда; клиент обязан пережить его\n отсутствие и показать `medium`.","version":"26.10.19"},"paths":{"/v1/auth/email-availability":{"get":{"tags":["Аутентификация"],"summary":"Свободен ли адрес — подсказка прямо в форме регистрации","description":"Под жёстким лимитом: без него это готовая проверялка «есть ли у вас\nаккаунт на Bounty» для чужих списков адресов.","operationId":"email_availability_v1_auth_email_availability_get","parameters":[{"name":"email","in":"query","required":true,"schema":{"type":"string","minLength":3,"maxLength":320,"title":"Email"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailAvailabilityResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/auth/register":{"post":{"tags":["Аутентификация"],"summary":"Регистрация: имя, фамилия, почта, пароль (Р-016)","operationId":"register_v1_auth_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterRequest"}}},"required":true},"responses":{"201":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenPairResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/auth/confirm-email":{"post":{"tags":["Аутентификация"],"summary":"Подтверждение адреса по ссылке из письма","operationId":"confirm_email_v1_auth_confirm_email_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmEmailRequest"}}},"required":true},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/auth/resend-confirmation":{"post":{"tags":["Аутентификация"],"summary":"Выслать письмо с подтверждением заново","operationId":"resend_confirmation_v1_auth_resend_confirmation_post","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/auth/login":{"post":{"tags":["Аутентификация"],"summary":"Вход по почте и паролю","operationId":"login_v1_auth_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenPairResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/auth/refresh":{"post":{"tags":["Аутентификация"],"summary":"Обмен refresh-токена на новую пару","description":"Капчи здесь нет намеренно: обновление происходит в фоне, без участия\nчеловека, и показать ему картинку в этот момент невозможно.","operationId":"refresh_v1_auth_refresh_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefreshRequest"}}},"required":true},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenPairResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/auth/ws-ticket":{"post":{"tags":["Аутентификация"],"summary":"Одноразовый билет для подключения к /v1/ws (docs/api.md §7)","description":"Нужен веб-клиенту: у страницы токена нет вовсе — он в cookie `HttpOnly`, и\nзаголовок `Authorization` браузерному `WebSocket` не поставить. Билет\nживёт минуту, гасится при первом использовании и не открывает ничего,\nкроме сокета.\n\nПриложениям он не нужен: у них есть токен, и они шлют его параметром.\n\nБилет требует **подтверждённой** почты (Р-217): сокет ведёт в переписку и\nуведомления, а они закрыты до подтверждения. Сам сокет проверяет это ещё\nраз — приложение приходит туда с токеном, минуя билет.","operationId":"ws_ticket_v1_auth_ws_ticket_post","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WsTicketResponse"}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/auth/logout":{"post":{"tags":["Аутентификация"],"summary":"Выход: текущая сессия завершается","operationId":"logout_v1_auth_logout_post","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/auth/logout-all":{"post":{"tags":["Аутентификация"],"summary":"Выход на всех устройствах, кроме текущего","operationId":"logout_all_v1_auth_logout_all_post","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/auth/sessions":{"get":{"tags":["Аутентификация"],"summary":"Список устройств, с которых выполнен вход","operationId":"sessions_v1_auth_sessions_get","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SessionResponse"},"type":"array","title":"Response Sessions V1 Auth Sessions Get"}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/auth/password-reset/request":{"post":{"tags":["Аутентификация"],"summary":"Запрос ссылки на смену пароля","description":"Всегда `202`, независимо от того, есть такой аккаунт или нет: разные\nответы превратили бы форму в проверялку списков адресов.","operationId":"password_reset_request_v1_auth_password_reset_request_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordResetRequest"}}},"required":true},"responses":{"202":{"description":"Успешный ответ","content":{"application/json":{"schema":{}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/auth/password-reset/confirm":{"post":{"tags":["Аутентификация"],"summary":"Установка нового пароля по ссылке из письма","description":"Все сессии завершаются: пароль меняют, когда подозревают утечку.","operationId":"password_reset_confirm_v1_auth_password_reset_confirm_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordResetConfirm"}}},"required":true},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/auth/password/change":{"post":{"tags":["Аутентификация"],"summary":"Смена пароля изнутри аккаунта. Текущая сессия остаётся жить","operationId":"password_change_v1_auth_password_change_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordChangeRequest"}}},"required":true},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/auth/delete-request":{"post":{"tags":["Аутентификация"],"summary":"Запрос на удаление аккаунта — подтверждается письмом","description":"Код с картинки — по подозрению, как у входа и сброса пароля (Р-277,\nР-466): тело необязательное, пустая пара проходит, пока клиент не похож\nна робота. Похож — `captcha_required`, и форма показывает картинку.","operationId":"delete_request_v1_auth_delete_request_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/DeleteRequest"},{"type":"null"}],"title":"Payload"}}}},"responses":{"202":{"description":"Успешный ответ","content":{"application/json":{"schema":{}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/auth/delete-confirm":{"post":{"tags":["Аутентификация"],"summary":"Подтверждение удаления аккаунта по ссылке из письма","operationId":"delete_confirm_v1_auth_delete_confirm_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmEmailRequest"}}},"required":true},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/me":{"get":{"tags":["Профиль"],"summary":"Свой профиль целиком — вместе с действующими ограничениями (находка №279)","operationId":"read_profile_v1_me_get","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileResponse"}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]},"patch":{"tags":["Профиль"],"summary":"Правка профиля","description":"Меняются только переданные поля: `model_fields_set` отличает «не\nпередали» от «передали пусто», иначе форма с одним полем стирала бы\nостальные.","operationId":"update_profile_v1_me_patch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/me/badges":{"get":{"tags":["Профиль"],"summary":"Счётчики непрочитанного: уведомления, сообщения, Bounty AI","description":"Три числа для обвязки клиента одним запросом (Р-465).\n\n* `notifications` — непрочитанные уведомления (число у колокольчика,\n W44); гаснут после `POST /v1/notifications/read`;\n* `messages` — непрочитанные сообщения во всех переписках гостя (число\n у значка сообщений и точка у вкладки «Профиль»); гаснут после\n `POST /v1/chats/dialogs/{id}/read`;\n* `assistant` — сообщения Bounty AI, которых гость ещё не видел (точка\n у вкладки «Bounty»); гаснут после `POST /v1/assistant/read`.\n\nЗапрос лёгкий — три счёта по индексам, — но дёргать его на каждом\nэкране незачем: сайт помнит ответ минуту, приложения обновляют его по\nсобытиям сокета `/v1/ws` и при возврате на экран.","operationId":"read_badges_v1_me_badges_get","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadgesResponse"}}}},"401":{"description":"Нет входа или токен истёк — `unauthorized`"},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/me/avatar":{"put":{"tags":["Профиль"],"summary":"Загрузка аватара. Изображение перекодируется, метаданные вырезаются","operationId":"set_avatar_v1_me_avatar_put","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_set_avatar_v1_me_avatar_put"}}},"required":true},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvatarResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["Профиль"],"summary":"Убрать аватар","operationId":"clear_avatar_v1_me_avatar_delete","responses":{"204":{"description":"Успешный ответ"},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/me/sessions":{"get":{"tags":["Профиль"],"summary":"Список устройств","description":"Дублирует `/v1/auth/sessions`: в интерфейсе этот список живёт в настройках профиля, а не на экране входа.","operationId":"sessions_v1_me_sessions_get","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SessionResponse"},"type":"array","title":"Response Sessions V1 Me Sessions Get"}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/me/sessions/{session_id}":{"delete":{"tags":["Профиль"],"summary":"Завершить сессию на выбранном устройстве","operationId":"revoke_session_v1_me_sessions__session_id__delete","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Session Id"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/me/search-filters":{"get":{"tags":["Профиль"],"summary":"Сохранённые фильтры по разделам и последняя область карты (Р-017)","operationId":"read_filters_v1_me_search_filters_get","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchFiltersResponse"}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]},"put":{"tags":["Профиль"],"summary":"Сохранение фильтров. Разделы, которых нет в теле, не трогаются","operationId":"save_filters_v1_me_search_filters_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchFiltersRequest"}}},"required":true},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchFiltersResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/me/email-prefs":{"get":{"tags":["Профиль"],"summary":"Галочки писем по группам. Чего человек не трогал — по умолчанию из реестра","operationId":"read_email_prefs_v1_me_email_prefs_get","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailPrefsBody"}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]},"put":{"tags":["Профиль"],"summary":"Включить или выключить письма: {\"prefs\": {\"booking.reminder\": false}}","description":"Выключить можно всё, кроме ответов на действие самого человека\n(подтверждение почты, сброс пароля): их в настройках нет вовсе.\nНезнакомый код — `400 email_pref_unknown`.","operationId":"update_email_prefs_v1_me_email_prefs_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailPrefsUpdate"}}},"required":true},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailPrefsBody"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/me/push-prefs":{"get":{"tags":["Профиль"],"summary":"Общий выключатель пушей и галочки по группам","description":"Это настройки **аккаунта**. Разрешение пушей даёт каждое устройство само\n(`POST /v1/devices`): включённые здесь пуши приходят только на те\nустройства, где они разрешены и где человек сейчас вошёл.","operationId":"read_push_prefs_v1_me_push_prefs_get","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PushPrefsBody"}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]},"put":{"tags":["Профиль"],"summary":"Выключатель и/или галочки: {\"enabled\": true, \"prefs\": {\"message.new\": false}}","description":"Выключить можно любой пуш. Незнакомый код — `400 push_pref_unknown`.","operationId":"update_push_prefs_v1_me_push_prefs_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PushPrefsUpdate"}}},"required":true},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PushPrefsBody"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/me/transactions":{"get":{"tags":["Профиль"],"summary":"«Транзакции» (S71, W45; Р-447): оплаты и возвраты, новые сверху, как в выписке банка","description":"У операции — вид (`booking_payment`, `booking_refund`), состояние (`paid`,\n`failed`, `pending`), сумма платежа, сумма заказа и курс, способ, номер\nоперации банка, время с поясом места и «За что» (`target`). `summary` —\nитог нынешнего месяца: оплачено и возвращено.","operationId":"read_transactions_v1_me_transactions_get","parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string","description":"all · payments · refunds","default":"all","title":"Type"},"description":"all · payments · refunds"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":100,"minimum":1},{"type":"null"}],"title":"Limit"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/me/transactions/{tx_id}":{"get":{"tags":["Профиль"],"summary":"Одна операция (S72, W46) — по номеру из выписки (pay_…, ref_…)","operationId":"read_transaction_v1_me_transactions__tx_id__get","parameters":[{"name":"tx_id","in":"path","required":true,"schema":{"type":"string","title":"Tx Id"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/media/{media_id}":{"get":{"tags":["Приватные файлы"],"summary":"Отдаёт приватный файл потоком","description":"Определяем владельца одним из двух способов и только потом проверяем\nправо: без билета — по токену, с билетом — по сессии, которой он выдан.","operationId":"download_v1_media__media_id__get","parameters":[{"name":"media_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Media Id"}},{"name":"t","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"T"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/media/{media_id}/ticket":{"post":{"tags":["Приватные файлы"],"summary":"Одноразовая ссылка на 60 секунд для показа файла в ","description":"Право проверяется здесь, до выдачи билета: билет — способ доставки, а не\nразрешение.","operationId":"create_ticket_v1_media__media_id__ticket_post","parameters":[{"name":"media_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Media Id"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaTicketResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/map/{path}":{"get":{"tags":["Карта"],"summary":"Ресурс карты: стиль, TileJSON, тайл, шрифт, спрайт или рельеф","description":"Отдаётся ровно тем же телом и теми же заголовками кеширования, что пришли\nот OpenFreeMap: клиент обязан кешировать тайлы так же, как при прямом\nпути, иначе запасная дорога стоила бы вдесятеро дороже прямой.","operationId":"map_resource_v1_map__path__get","parameters":[{"name":"path","in":"path","required":true,"schema":{"type":"string","title":"Path"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/i18n":{"get":{"tags":["Локализация"],"summary":"Набор строк целиком, уже с подстановкой недостающего из английского","description":"Клиент получает **полный** словарь, а не набор дыр, которые ему нечем\nзакрыть: непереведённый ключ приходит по-английски, и это лучше пустой\nкнопки.\n\nЯзык берётся из параметра, иначе из `Accept-Language`; неизвестный —\nанглийский. Если `version` совпадает с текущей, отвечаем `304`: набор\nстрок весит килобайты, но телефон в тайском 3G считает и их.","operationId":"get_catalog_v1_i18n_get","parameters":[{"name":"lang","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Lang"}},{"name":"version","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Version"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/i18n/languages":{"get":{"tags":["Локализация"],"summary":"Языки интерфейса — для экрана выбора языка (S66)","description":"Каждый назван **на самом себе**: «Тайский» ничего не говорит тому, кто\nищет тайский. Флагов у языков нет: флаг — это страна, а не язык.","operationId":"get_languages_v1_i18n_languages_get","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Languages V1 I18N Languages Get"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/places":{"get":{"tags":["Справочники"],"summary":"Иерархия мест на языке запроса","operationId":"places_v1_places_get","parameters":[{"name":"parent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Только дети этого места","title":"Parent Id"},"description":"Только дети этого места"},{"name":"level","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"country / region / district / area","title":"Level"},"description":"country / region / district / area"},{"name":"with_totals","in":"query","required":false,"schema":{"type":"boolean","description":"Считать объекты вместе со вложенными местами","default":false,"title":"With Totals"},"description":"Считать объекты вместе со вложенными местами"}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PlaceResponse"},"title":"Response Places V1 Places Get"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/places/popular":{"get":{"tags":["Справочники"],"summary":"Популярные направления для главной — по числу опубликованных объектов","operationId":"popular_places_v1_places_popular_get","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/PlaceResponse"},"type":"array","title":"Response Popular Places V1 Places Popular Get"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/places/{slug}":{"get":{"tags":["Справочники"],"summary":"Страница направления: место, путь сверху, что внутри, сколько чего","description":"Объявлен **после** `/v1/places/popular`: маршрут с параметром, стоящий\nраньше, перехватил бы слово `popular` как адрес места и всегда отвечал бы\n«направление не найдено».","operationId":"place_card_v1_places__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaceCardResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/amenities":{"get":{"tags":["Справочники"],"summary":"Удобства группами. С kind — только применимые к этой категории","operationId":"amenities_v1_amenities_get","parameters":[{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"stay / experience / service","title":"Kind"},"description":"stay / experience / service"}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AmenityResponse"},"title":"Response Amenities V1 Amenities Get"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/categories":{"get":{"tags":["Справочники"],"summary":"Категории впечатлений, услуг, транспорта или еды","description":"С `with_counts=true` у каждой — число опубликованных объектов: чипы над\nлентой раздела пишут его рядом с названием (макет W01). Граница та же,\nчто у ленты; остальные фильтры на число не влияют.","operationId":"categories_v1_categories_get","parameters":[{"name":"kind","in":"query","required":true,"schema":{"type":"string","description":"experience, service, transport или food","title":"Kind"},"description":"experience, service, transport или food"},{"name":"with_counts","in":"query","required":false,"schema":{"type":"boolean","description":"Добавить `listings_count` — сколько опубликованных объектов в категории (чипы раздела W01)","default":false,"title":"With Counts"},"description":"Добавить `listings_count` — сколько опубликованных объектов в категории (чипы раздела W01)"}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/app__schemas__catalog__CategoryResponse"},"title":"Response Categories V1 Categories Get"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/currencies":{"get":{"tags":["Справочники"],"summary":"Валюты отображения","operationId":"currencies_v1_currencies_get","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CurrencyResponse"},"type":"array","title":"Response Currencies V1 Currencies Get"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/fx/rates":{"get":{"tags":["Справочники"],"summary":"Курсы валют ЦБ РФ для примерной цены (Р-214)","description":"Открыт без токена: пересчёт нужен и гостю, который ещё не завёл учётную\nзапись, — именно он чаще всего и смотрит цены впервые.\n\n**Это подсказка, а не цена.** Платит человек в валюте объявления, банк\nпересчитывает по своему курсу, и клиент обязан пометить пересчёт как\nпримерный.","operationId":"fx_rates_v1_fx_rates_get","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FxRatesResponse"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/config":{"get":{"tags":["Справочники"],"summary":"Публичная конфигурация: карта, языки, валюты, лимиты, регион афиши","operationId":"config_v1_config_get","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfigResponse"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/nodes":{"get":{"tags":["Справочники"],"summary":"Серверы для выбора по пингу (Р-024, docs/nodes/architecture.md §4)","description":"`origin` — главный сервер, есть всегда, даже когда узлов ноль: клиенту\nне нужно знать его адрес из своей сборки. В `nodes` — только узлы в\nсостоянии `active`. Узел — это API и кеш файлов на одном сервере: у\nкаждого — пара адресов, и выбираются они вместе.","operationId":"nodes_v1_nodes_get","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Nodes V1 Nodes Get"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/search/listings":{"get":{"tags":["Поиск"],"summary":"Лента раздела: карточки по фильтрам, курсорная пагинация","description":"Тексты приходят на языке запроса: у объекта, заведённого по-тайски, берётся\nперевод, и в ответе стоит пометка о нём (Р-063).","operationId":"feed_v1_search_listings_get","parameters":[{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"stay / experience / service / transport / food / all","title":"Kind"},"description":"stay / experience / service / transport / food / all"},{"name":"bbox","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"minLon,minLat,maxLon,maxLat","title":"Bbox"},"description":"minLon,minLat,maxLon,maxLat"},{"name":"near","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"lat,lon","title":"Near"},"description":"lat,lon"},{"name":"radius_m","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":200000,"minimum":100},{"type":"null"}],"title":"Radius M"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Текст запроса. Ищет по названию, описанию и **месту** объекта, на всех языках сразу и по словам: «вилла патонг» найдёт виллы Патонга. Отдельного фильтра места нет (Р-282)","title":"Q"},"description":"Текст запроса. Ищет по названию, описанию и **месту** объекта, на всех языках сразу и по словам: «вилла патонг» найдёт виллы Патонга. Отдельного фильтра места нет (Р-282)"},{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date From"}},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date To"}},{"name":"guests","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":50,"minimum":1},{"type":"null"}],"title":"Guests"}},{"name":"price_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Price Min"}},{"name":"price_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Price Max"}},{"name":"currency","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":3},{"type":"null"}],"title":"Currency"}},{"name":"property_type","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Property Type"}},{"name":"room_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Room Type"}},{"name":"bedrooms_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":50,"minimum":0},{"type":"null"}],"title":"Bedrooms Min"}},{"name":"beds_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":50,"minimum":0},{"type":"null"}],"title":"Beds Min"}},{"name":"bathrooms_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":50,"minimum":0},{"type":"null"}],"title":"Bathrooms Min"}},{"name":"beach_distance_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Beach Distance Max"}},{"name":"pets_allowed","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Pets Allowed"}},{"name":"smoking_allowed","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Smoking Allowed"}},{"name":"children_allowed","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Жильё: можно с детьми","title":"Children Allowed"},"description":"Жильё: можно с детьми"},{"name":"parties_allowed","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Жильё: можно вечеринки","title":"Parties Allowed"},"description":"Жильё: можно вечеринки"},{"name":"long_stay","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Long Stay"}},{"name":"category_id","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"integer"}},{"type":"null"}],"title":"Category Id"}},{"name":"duration_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Duration Max"}},{"name":"languages","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Languages"}},{"name":"group_size_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Group Size Max"}},{"name":"same_day","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Same Day"}},{"name":"price_unit","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Unit"}},{"name":"vehicle_kind","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Vehicle Kind"}},{"name":"transmission","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Transmission"}},{"name":"seats_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":60,"minimum":1},{"type":"null"}],"title":"Seats Min"}},{"name":"food_format","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Food Format"}},{"name":"diets","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Отметки меню; нужны все сразу","title":"Diets"},"description":"Отметки меню; нужны все сразу"},{"name":"alcohol","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Alcohol"}},{"name":"amenities","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Коды удобств; нужны все сразу","title":"Amenities"},"description":"Коды удобств; нужны все сразу"},{"name":"instant_book","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Instant Book"}},{"name":"rating_min","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":5,"minimum":0},{"type":"null"}],"title":"Rating Min"}},{"name":"sort","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"relevance / price_asc / price_desc / rating / distance / new","title":"Sort"},"description":"relevance / price_asc / price_desc / rating / distance / new"},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":50,"minimum":1},{"type":"null"}],"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__search__FeedResponse"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{},{"bearerAuth":[]}]}},"/v1/search/map":{"get":{"tags":["Поиск"],"summary":"Метки и кластеры карты по тем же фильтрам, что и лента","description":"Объекты в режиме `city_only` точки не имеют вовсе и на карту не попадают\n(Р-040) — их видно в ленте по своему городу.","operationId":"map_view_v1_search_map_get","parameters":[{"name":"zoom","in":"query","required":true,"schema":{"type":"integer","maximum":20,"minimum":0,"description":"Зум карты: до 12 — кластеры, дальше метки","title":"Zoom"},"description":"Зум карты: до 12 — кластеры, дальше метки"},{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"stay / experience / service / transport / food / all","title":"Kind"},"description":"stay / experience / service / transport / food / all"},{"name":"bbox","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"minLon,minLat,maxLon,maxLat","title":"Bbox"},"description":"minLon,minLat,maxLon,maxLat"},{"name":"near","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"lat,lon","title":"Near"},"description":"lat,lon"},{"name":"radius_m","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":200000,"minimum":100},{"type":"null"}],"title":"Radius M"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Текст запроса. Ищет по названию, описанию и **месту** объекта, на всех языках сразу и по словам: «вилла патонг» найдёт виллы Патонга. Отдельного фильтра места нет (Р-282)","title":"Q"},"description":"Текст запроса. Ищет по названию, описанию и **месту** объекта, на всех языках сразу и по словам: «вилла патонг» найдёт виллы Патонга. Отдельного фильтра места нет (Р-282)"},{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date From"}},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date To"}},{"name":"guests","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":50,"minimum":1},{"type":"null"}],"title":"Guests"}},{"name":"price_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Price Min"}},{"name":"price_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Price Max"}},{"name":"currency","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":3},{"type":"null"}],"title":"Currency"}},{"name":"property_type","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Property Type"}},{"name":"room_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Room Type"}},{"name":"bedrooms_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":50,"minimum":0},{"type":"null"}],"title":"Bedrooms Min"}},{"name":"beds_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":50,"minimum":0},{"type":"null"}],"title":"Beds Min"}},{"name":"bathrooms_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":50,"minimum":0},{"type":"null"}],"title":"Bathrooms Min"}},{"name":"beach_distance_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Beach Distance Max"}},{"name":"pets_allowed","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Pets Allowed"}},{"name":"smoking_allowed","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Smoking Allowed"}},{"name":"children_allowed","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Жильё: можно с детьми","title":"Children Allowed"},"description":"Жильё: можно с детьми"},{"name":"parties_allowed","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Жильё: можно вечеринки","title":"Parties Allowed"},"description":"Жильё: можно вечеринки"},{"name":"long_stay","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Long Stay"}},{"name":"category_id","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"integer"}},{"type":"null"}],"title":"Category Id"}},{"name":"duration_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Duration Max"}},{"name":"languages","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Languages"}},{"name":"group_size_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Group Size Max"}},{"name":"same_day","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Same Day"}},{"name":"price_unit","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Unit"}},{"name":"vehicle_kind","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Vehicle Kind"}},{"name":"transmission","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Transmission"}},{"name":"seats_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":60,"minimum":1},{"type":"null"}],"title":"Seats Min"}},{"name":"food_format","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Food Format"}},{"name":"diets","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Отметки меню; нужны все сразу","title":"Diets"},"description":"Отметки меню; нужны все сразу"},{"name":"alcohol","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Alcohol"}},{"name":"amenities","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Коды удобств; нужны все сразу","title":"Amenities"},"description":"Коды удобств; нужны все сразу"},{"name":"instant_book","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Instant Book"}},{"name":"rating_min","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":5,"minimum":0},{"type":"null"}],"title":"Rating Min"}},{"name":"sort","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"relevance / price_asc / price_desc / rating / distance / new","title":"Sort"},"description":"relevance / price_asc / price_desc / rating / distance / new"},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":50,"minimum":1},{"type":"null"}],"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__search__MapResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/search/count":{"get":{"tags":["Поиск"],"summary":"Сколько вариантов подходит — для кнопки «Показать N вариантов»","description":"Отдельным лёгким запросом, а не полем ленты: панель фильтров пересчитывает\nчисло на каждой галочке, и тянуть ради этого двадцать карточек с\nфотографиями незачем.","operationId":"count_v1_search_count_get","parameters":[{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"stay / experience / service / transport / food / all","title":"Kind"},"description":"stay / experience / service / transport / food / all"},{"name":"bbox","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"minLon,minLat,maxLon,maxLat","title":"Bbox"},"description":"minLon,minLat,maxLon,maxLat"},{"name":"near","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"lat,lon","title":"Near"},"description":"lat,lon"},{"name":"radius_m","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":200000,"minimum":100},{"type":"null"}],"title":"Radius M"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Текст запроса. Ищет по названию, описанию и **месту** объекта, на всех языках сразу и по словам: «вилла патонг» найдёт виллы Патонга. Отдельного фильтра места нет (Р-282)","title":"Q"},"description":"Текст запроса. Ищет по названию, описанию и **месту** объекта, на всех языках сразу и по словам: «вилла патонг» найдёт виллы Патонга. Отдельного фильтра места нет (Р-282)"},{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date From"}},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date To"}},{"name":"guests","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":50,"minimum":1},{"type":"null"}],"title":"Guests"}},{"name":"price_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Price Min"}},{"name":"price_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Price Max"}},{"name":"currency","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":3},{"type":"null"}],"title":"Currency"}},{"name":"property_type","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Property Type"}},{"name":"room_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Room Type"}},{"name":"bedrooms_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":50,"minimum":0},{"type":"null"}],"title":"Bedrooms Min"}},{"name":"beds_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":50,"minimum":0},{"type":"null"}],"title":"Beds Min"}},{"name":"bathrooms_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":50,"minimum":0},{"type":"null"}],"title":"Bathrooms Min"}},{"name":"beach_distance_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Beach Distance Max"}},{"name":"pets_allowed","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Pets Allowed"}},{"name":"smoking_allowed","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Smoking Allowed"}},{"name":"children_allowed","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Жильё: можно с детьми","title":"Children Allowed"},"description":"Жильё: можно с детьми"},{"name":"parties_allowed","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Жильё: можно вечеринки","title":"Parties Allowed"},"description":"Жильё: можно вечеринки"},{"name":"long_stay","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Long Stay"}},{"name":"category_id","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"integer"}},{"type":"null"}],"title":"Category Id"}},{"name":"duration_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Duration Max"}},{"name":"languages","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Languages"}},{"name":"group_size_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Group Size Max"}},{"name":"same_day","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Same Day"}},{"name":"price_unit","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Unit"}},{"name":"vehicle_kind","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Vehicle Kind"}},{"name":"transmission","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Transmission"}},{"name":"seats_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":60,"minimum":1},{"type":"null"}],"title":"Seats Min"}},{"name":"food_format","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Food Format"}},{"name":"diets","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Отметки меню; нужны все сразу","title":"Diets"},"description":"Отметки меню; нужны все сразу"},{"name":"alcohol","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Alcohol"}},{"name":"amenities","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Коды удобств; нужны все сразу","title":"Amenities"},"description":"Коды удобств; нужны все сразу"},{"name":"instant_book","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Instant Book"}},{"name":"rating_min","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":5,"minimum":0},{"type":"null"}],"title":"Rating Min"}},{"name":"sort","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"relevance / price_asc / price_desc / rating / distance / new","title":"Sort"},"description":"relevance / price_asc / price_desc / rating / distance / new"},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":50,"minimum":1},{"type":"null"}],"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountResponse"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/search/price-range":{"get":{"tags":["Поиск"],"summary":"Границы ползунка цены раздела — в валюте человека (Р-275)","description":"Остальные фильтры сюда не приходят намеренно: края ползунка, прыгающие от\nкаждой галочки, не дают его двигать. Пересчёт тот же, что у фильтра цены\n(Р-218), — край не обещает цену, которой фильтр не найдёт.","operationId":"price_range_v1_search_price_range_get","parameters":[{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Раздел; без него — все пять","title":"Kind"},"description":"Раздел; без него — все пять"},{"name":"currency","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":3},{"type":"null"}],"description":"Валюта человека","title":"Currency"},"description":"Валюта человека"}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceRangeResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/search/suggest":{"get":{"tags":["Поиск"],"summary":"Подсказки строки поиска: места и объекты","description":"Ищет по **переводам** названий мест, а не по кодам: человек пишет «Пхукет»\nили «Phuket», а не `phuket-province`.","operationId":"suggest_v1_search_suggest_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":120,"title":"Q"}},{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuggestResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/events/categories":{"get":{"tags":["События"],"summary":"Справочник категорий раздела на языке запроса","description":"Объявлен **до** `/{slug}`: маршрут с параметром, стоящий раньше, перехватил\nбы слово `categories` как адрес события.","operationId":"categories_v1_events_categories_get","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/app__schemas__events__CategoryResponse"},"type":"array","title":"Response Categories V1 Events Categories Get"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/events/calendar":{"get":{"tags":["События"],"summary":"Полоска календаря над лентой: сколько событий в каждом дне","description":"Считается **с теми же фильтрами**, что и лента: выбранная категория\nменяет числа в полоске, иначе день с цифрой «12» открывался бы пустым.\nДень самого запроса в расчёт не идёт — полоска показывает всё окно.\n\nВ сегодняшнем дне не считается **то, что уже закончилось** (находка\n№171) — ровно как в ленте. Остальных дней окна отсечка не касается:\nона привязана к сегодняшнему числу, а не к началу окна.","operationId":"calendar_v1_events_calendar_get","parameters":[{"name":"first","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Первый день окна; по умолчанию сегодня","title":"First"},"description":"Первый день окна; по умолчанию сегодня"},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"default":60,"title":"Days"}},{"name":"day","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"День афиши **в поясе площадки** (правило №16). Без него — весь промежуток","title":"Day"},"description":"День афиши **в поясе площадки** (правило №16). Без него — весь промежуток"},{"name":"day_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Начало промежутка дней","title":"Day From"},"description":"Начало промежутка дней"},{"name":"day_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Конец промежутка дней","title":"Day To"},"description":"Конец промежутка дней"},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Коды категорий; подходит любая из перечисленных","title":"Category"},"description":"Коды категорий; подходит любая из перечисленных"},{"name":"entry","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"free / paid / any","title":"Entry"},"description":"free / paid / any"},{"name":"time","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"morning / day / evening / any","title":"Time"},"description":"morning / day / evening / any"},{"name":"audience","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"family / adults / any","title":"Audience"},"description":"family / adults / any"},{"name":"crowd","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"intimate / small / medium / large; подходит любая","title":"Crowd"},"description":"intimate / small / medium / large; подходит любая"},{"name":"event_lang","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Язык события: ru / en / th / zh-Hans / multi (разноязычное) / any","title":"Event Lang"},"description":"Язык события: ru / en / th / zh-Hans / multi (разноязычное) / any"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Текст запроса. Ищет по названию, описанию, площадке и **месту** события, на всех языках и по словам","title":"Q"},"description":"Текст запроса. Ищет по названию, описанию, площадке и **месту** события, на всех языках и по словам"},{"name":"bbox","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"minLon,minLat,maxLon,maxLat","title":"Bbox"},"description":"minLon,minLat,maxLon,maxLat"},{"name":"near","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"lat,lon","title":"Near"},"description":"lat,lon"},{"name":"radius_m","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":200000,"minimum":100},{"type":"null"}],"title":"Radius M"}},{"name":"timezone","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Пояс, в котором считается «сегодня». По умолчанию — Asia/Bangkok","title":"Timezone"},"description":"Пояс, в котором считается «сегодня». По умолчанию — Asia/Bangkok"},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":50,"minimum":1},{"type":"null"}],"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/events/upcoming":{"get":{"tags":["События"],"summary":"Ближайшие события — по одному на событие, а не по дням","description":"Для витрин, которые показывают афишу не целиком: ряд на главной, блок в\nписьме, экран приложения. Лента им не годится — её единица день, и\nежедневный ночной рынок занял бы весь ряд своими датами: в ближайших\nпятидесяти днях его двадцать два.\n\nКарточка та же, что в ленте, и несёт свой ближайший подходящий день.\nВитрине хватает первой страницы; лента «Событий» без выбранного дня\n(Р-465) листает дальше по `next_cursor` — порядок тот же, что у ленты\nпо дням: день, время начала, событие.\n\nСмотрит на **окно в ближайшие 30 дней** (`days`). «Ближайшие события» —\nэто то, что происходит на днях; событие через полгода в такой ряд не\nпросится, даже если оно единственное. Окно заодно режет цену запроса: без\nнего отбор читал бы все дни всех событий до горизонта раскрытия\nрасписаний, а это сто восемьдесят дней на каждое.\n\nОбъявлен **до** `/{slug}`: маршрут с параметром, стоящий раньше, принял бы\nслово `upcoming` за адрес события.","operationId":"upcoming_v1_events_upcoming_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":50,"minimum":1},{"type":"null"}],"title":"Limit"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"description":"Окно поиска в днях от сегодня. Не действует, если задан день или конец промежутка","default":30,"title":"Days"},"description":"Окно поиска в днях от сегодня. Не действует, если задан день или конец промежутка"},{"name":"with_total","in":"query","required":false,"schema":{"type":"boolean","description":"Добавить `total` — сколько всего **событий** подходит в окне","default":false,"title":"With Total"},"description":"Добавить `total` — сколько всего **событий** подходит в окне"},{"name":"day","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"День афиши **в поясе площадки** (правило №16). Без него — весь промежуток","title":"Day"},"description":"День афиши **в поясе площадки** (правило №16). Без него — весь промежуток"},{"name":"day_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Начало промежутка дней","title":"Day From"},"description":"Начало промежутка дней"},{"name":"day_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Конец промежутка дней","title":"Day To"},"description":"Конец промежутка дней"},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Коды категорий; подходит любая из перечисленных","title":"Category"},"description":"Коды категорий; подходит любая из перечисленных"},{"name":"entry","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"free / paid / any","title":"Entry"},"description":"free / paid / any"},{"name":"time","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"morning / day / evening / any","title":"Time"},"description":"morning / day / evening / any"},{"name":"audience","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"family / adults / any","title":"Audience"},"description":"family / adults / any"},{"name":"crowd","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"intimate / small / medium / large; подходит любая","title":"Crowd"},"description":"intimate / small / medium / large; подходит любая"},{"name":"event_lang","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Язык события: ru / en / th / zh-Hans / multi (разноязычное) / any","title":"Event Lang"},"description":"Язык события: ru / en / th / zh-Hans / multi (разноязычное) / any"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Текст запроса. Ищет по названию, описанию, площадке и **месту** события, на всех языках и по словам","title":"Q"},"description":"Текст запроса. Ищет по названию, описанию, площадке и **месту** события, на всех языках и по словам"},{"name":"bbox","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"minLon,minLat,maxLon,maxLat","title":"Bbox"},"description":"minLon,minLat,maxLon,maxLat"},{"name":"near","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"lat,lon","title":"Near"},"description":"lat,lon"},{"name":"radius_m","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":200000,"minimum":100},{"type":"null"}],"title":"Radius M"}},{"name":"timezone","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Пояс, в котором считается «сегодня». По умолчанию — Asia/Bangkok","title":"Timezone"},"description":"Пояс, в котором считается «сегодня». По умолчанию — Asia/Bangkok"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpcomingResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/events/map":{"get":{"tags":["События"],"summary":"Метки и кружки карты по тем же фильтрам, что и лента","description":"**Событие приходит один раз** — своим ближайшим подходящим днём, а не\nкаждым. Лента идёт по дням, и еженедельная вечеринка стоит в ней\nпятнадцатью карточками; на карте те пятнадцать легли бы в одну точку\nстопкой, и человек видел бы одну метку, под которой спрятаны четырнадцать\nтаких же.\n\n**Прошлые дни и прошедшие часы в карту не идут.** Без заданного дня\nотсчёт начинается с сегодняшнего по поясу площадок, и из сегодняшнего\nвыпадает уже закончившееся (находка №171): карта отвечает на вопрос\n«куда пойти», а не «что тут было». Метка события при этом не пропадает —\nоно приходит своим следующим днём.\n\nСобытие без точки на карту не попадает вовсе — площадку могли записать\nодним адресом, и ставить её в случайное место значило бы соврать о том,\nкуда идти.\n\nОбъявлен **до** `/{slug}`: маршрут с параметром, стоящий раньше, принял бы\nслово `map` за адрес события.","operationId":"map_view_v1_events_map_get","parameters":[{"name":"zoom","in":"query","required":true,"schema":{"type":"integer","maximum":20,"minimum":0,"description":"Зум карты: до 12 — кружки, дальше метки","title":"Zoom"},"description":"Зум карты: до 12 — кружки, дальше метки"},{"name":"day","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"День афиши **в поясе площадки** (правило №16). Без него — весь промежуток","title":"Day"},"description":"День афиши **в поясе площадки** (правило №16). Без него — весь промежуток"},{"name":"day_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Начало промежутка дней","title":"Day From"},"description":"Начало промежутка дней"},{"name":"day_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Конец промежутка дней","title":"Day To"},"description":"Конец промежутка дней"},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Коды категорий; подходит любая из перечисленных","title":"Category"},"description":"Коды категорий; подходит любая из перечисленных"},{"name":"entry","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"free / paid / any","title":"Entry"},"description":"free / paid / any"},{"name":"time","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"morning / day / evening / any","title":"Time"},"description":"morning / day / evening / any"},{"name":"audience","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"family / adults / any","title":"Audience"},"description":"family / adults / any"},{"name":"crowd","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"intimate / small / medium / large; подходит любая","title":"Crowd"},"description":"intimate / small / medium / large; подходит любая"},{"name":"event_lang","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Язык события: ru / en / th / zh-Hans / multi (разноязычное) / any","title":"Event Lang"},"description":"Язык события: ru / en / th / zh-Hans / multi (разноязычное) / any"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Текст запроса. Ищет по названию, описанию, площадке и **месту** события, на всех языках и по словам","title":"Q"},"description":"Текст запроса. Ищет по названию, описанию, площадке и **месту** события, на всех языках и по словам"},{"name":"bbox","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"minLon,minLat,maxLon,maxLat","title":"Bbox"},"description":"minLon,minLat,maxLon,maxLat"},{"name":"near","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"lat,lon","title":"Near"},"description":"lat,lon"},{"name":"radius_m","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":200000,"minimum":100},{"type":"null"}],"title":"Radius M"}},{"name":"timezone","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Пояс, в котором считается «сегодня». По умолчанию — Asia/Bangkok","title":"Timezone"},"description":"Пояс, в котором считается «сегодня». По умолчанию — Asia/Bangkok"},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":50,"minimum":1},{"type":"null"}],"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__events__MapResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/events":{"get":{"tags":["События"],"summary":"Лента раздела: карточки событий выбранного дня, курсорная пагинация","description":"Единица ленты — **день события**, а не само событие: еженедельная\nвечеринка попадает в ленту каждого своего вторника. Порядок внутри дня —\nпо времени начала; события «весь день» идут последними.\n\nБез заданного дня лента начинается с **сегодняшнего** по поясу площадок:\nпрошедшие дни остаются в базе, но афише отвечать нечем — туда уже не\nсходить. По той же причине из сегодняшнего дня выпадает **то, что уже\nзакончилось** (находка №171): концерт, доигравший в 14:00, не ответ на\nвопрос «куда пойти» в 19:00. Полоска календаря считает с той же отсечкой\n— иначе она обещала бы над лентой больше, чем лента показывает.\n\nСпросили конкретный день — отвечаем на его вопрос целиком, включая уже\nпрошедшее: «что было сегодня» тоже законный вопрос.\n\nТексты приходят на языке запроса, у переведённых стоит пометка (Р-063).","operationId":"feed_v1_events_get","parameters":[{"name":"with_total","in":"query","required":false,"schema":{"type":"boolean","description":"Добавить `total` — число подходящих **событий**","default":false,"title":"With Total"},"description":"Добавить `total` — число подходящих **событий**"},{"name":"day","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"День афиши **в поясе площадки** (правило №16). Без него — весь промежуток","title":"Day"},"description":"День афиши **в поясе площадки** (правило №16). Без него — весь промежуток"},{"name":"day_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Начало промежутка дней","title":"Day From"},"description":"Начало промежутка дней"},{"name":"day_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Конец промежутка дней","title":"Day To"},"description":"Конец промежутка дней"},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Коды категорий; подходит любая из перечисленных","title":"Category"},"description":"Коды категорий; подходит любая из перечисленных"},{"name":"entry","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"free / paid / any","title":"Entry"},"description":"free / paid / any"},{"name":"time","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"morning / day / evening / any","title":"Time"},"description":"morning / day / evening / any"},{"name":"audience","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"family / adults / any","title":"Audience"},"description":"family / adults / any"},{"name":"crowd","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"intimate / small / medium / large; подходит любая","title":"Crowd"},"description":"intimate / small / medium / large; подходит любая"},{"name":"event_lang","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Язык события: ru / en / th / zh-Hans / multi (разноязычное) / any","title":"Event Lang"},"description":"Язык события: ru / en / th / zh-Hans / multi (разноязычное) / any"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Текст запроса. Ищет по названию, описанию, площадке и **месту** события, на всех языках и по словам","title":"Q"},"description":"Текст запроса. Ищет по названию, описанию, площадке и **месту** события, на всех языках и по словам"},{"name":"bbox","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"minLon,minLat,maxLon,maxLat","title":"Bbox"},"description":"minLon,minLat,maxLon,maxLat"},{"name":"near","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"lat,lon","title":"Near"},"description":"lat,lon"},{"name":"radius_m","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":200000,"minimum":100},{"type":"null"}],"title":"Radius M"}},{"name":"timezone","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Пояс, в котором считается «сегодня». По умолчанию — Asia/Bangkok","title":"Timezone"},"description":"Пояс, в котором считается «сегодня». По умолчанию — Asia/Bangkok"},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":50,"minimum":1},{"type":"null"}],"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__events__FeedResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/events/{slug}":{"get":{"tags":["События"],"summary":"Страница события по адресу","description":"Черновик и снятое событие отдают `404`, а не «скрыто»: ответ «есть, но не\nпокажу» рассказывает о том, чего гостю знать не нужно.\n\nЧасы приходят вместе с `timezone_notice` — поясом площадки и пояснением о\nразнице с поясом гостя (правило №16). Показать «с 20:00» без пояса — та же\nошибка, что показать цену без валюты.","operationId":"event_v1_events__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/listings/{listing_id}/availability":{"get":{"tags":["Объекты"],"summary":"Календарь объекта: свободные даты, цена дня, минимальный срок","operationId":"availability_v1_listings__listing_id__availability_get","parameters":[{"name":"listing_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Listing Id"}},{"name":"from","in":"query","required":true,"schema":{"type":"string","format":"date","title":"From"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","format":"date","title":"To"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvailabilityResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/listings/{listing_id}/slots":{"get":{"tags":["Объекты"],"summary":"Свободные выходы впечатления или окна услуги","operationId":"slots_v1_listings__listing_id__slots_get","parameters":[{"name":"listing_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Listing Id"}},{"name":"from","in":"query","required":true,"schema":{"type":"string","format":"date","title":"From"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","format":"date","title":"To"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlotsResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/listings/{listing_id}/quote":{"post":{"tags":["Объекты"],"summary":"Расчёт стоимости построчно","description":"Даты заняты — приходит `available: false` и `conflict_dates`, а не пустой\nответ: гость должен видеть, какие именно даты мешают, и подвинуть их.","operationId":"quote_v1_listings__listing_id__quote_post","parameters":[{"name":"listing_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Listing Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteRequest"}}}},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/listings/{key}":{"get":{"tags":["Объекты"],"summary":"Полная карточка объекта — по адресу или идентификатору","description":"Вход не нужен: выбирать можно без регистрации (Р-013). Вошедшему\nдополнительно видно, лежит ли объект у него в избранном.\n\nМаршрут объявлен **после** `/{listing_id}/availability` и соседей: иначе\nон перехватил бы их пути, приняв «availability» за адрес объекта.","operationId":"listing_card_v1_listings__key__get","parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string","title":"Key"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Listing Card V1 Listings Key Get"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{},{"bearerAuth":[]}]}},"/v1/listings/{key}/similar":{"get":{"tags":["Объекты"],"summary":"Похожие рядом — тот же тип в том же месте","operationId":"listing_similar_v1_listings__key__similar_get","parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string","title":"Key"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Listing Similar V1 Listings Key Similar Get"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/bookings":{"post":{"tags":["Бронирования"],"summary":"Создаёт бронь. Мгновенная сразу подтверждена, по запросу — pending","operationId":"create_booking_v1_bookings_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingCreate"}}}},"responses":{"201":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingDetail"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]},"get":{"tags":["Бронирования"],"summary":"Мои поездки, новые сверху","description":"`scope` отбирает по ходу поездки. Без него список остаётся прежним — всё\nподряд: это умолчание держит старых клиентов, которые про `scope` не\nзнают. Порядок от `scope` не зависит, см. `booking_service.page`.","operationId":"my_bookings_v1_bookings_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/BookingStatus"},{"type":"null"}],"title":"Status"}},{"name":"scope","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(upcoming|completed|cancelled|past|all)$"},{"type":"null"}],"description":"Вкладки S63: upcoming — живые и не закончившиеся, completed — завершённые (в том числе неявка), cancelled — отменённые, отклонённые и просроченные; past — completed и cancelled вместе; all — всё (умолчание)","title":"Scope"},"description":"Вкладки S63: upcoming — живые и не закончившиеся, completed — завершённые (в том числе неявка), cancelled — отменённые, отклонённые и просроченные; past — completed и cancelled вместе; all — всё (умолчание)"},{"name":"with_counts","in":"query","required":false,"schema":{"type":"boolean","description":"Добавить `counts` — числа на трёх вкладках","default":false,"title":"With Counts"},"description":"Добавить `counts` — числа на трёх вкладках"},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":50,"minimum":1},{"type":"null"}],"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingPage"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/bookings/{booking_id}":{"get":{"tags":["Бронирования"],"summary":"Карточка брони. Адрес открывается только по подтверждённой","operationId":"booking_card_v1_bookings__booking_id__get","parameters":[{"name":"booking_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Booking Id"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingDetail"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/bookings/{booking_id}/refund-preview":{"get":{"tags":["Бронирования"],"summary":"Сколько вернётся, если отменить прямо сейчас","description":"Отдельным эндпоинтом, а не текстом в карточке: сумма зависит от момента,\nи гость должен видеть её **до** нажатия, а не узнавать после.","operationId":"refund_preview_v1_bookings__booking_id__refund_preview_get","parameters":[{"name":"booking_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Booking Id"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundBody"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/bookings/{booking_id}/cancel":{"post":{"tags":["Бронирования"],"summary":"Отмена гостем. В ответе — сумма возврата","operationId":"cancel_booking_v1_bookings__booking_id__cancel_post","parameters":[{"name":"booking_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Booking Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelRequest"}}}},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundBody"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/bookings/{booking_id}/guests":{"get":{"tags":["Бронирования"],"summary":"Кто едет: список проживающих (Р-197)","description":"Приходит **заполненным наполовину**: первая строка — сам заказчик, из его\nпрофиля, остальные пустые по числу людей в брони. Заставлять человека\nпереписывать в форму собственные имя и возраст, которые сервис и так\nзнает, — верный способ получить незаполненную форму.","operationId":"read_guests_v1_bookings__booking_id__guests_get","parameters":[{"name":"booking_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Booking Id"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StayGuestBody"},"title":"Response Read Guests V1 Bookings Booking Id Guests Get"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]},"put":{"tags":["Бронирования"],"summary":"Переписывает список участников целиком — и телефон для связи (Р-352)","description":"Пустые строки не сохраняются. У объекта с `guest_details = required`\nданные всех участников обязательны и стереть их правкой нельзя —\n`400 guest_details_required`. `contact_phone` не передан — не меняется,\nпустой — `400 phone_required`.\n\n**Правится только до оплаты** (Р-352): оплатой человек подтвердил, кого и\nкак везут, и партнёр по этим данным оформляет страховку. Оплаченная или\nзакрытая бронь отвечает `409 guests_locked`.","operationId":"write_guests_v1_bookings__booking_id__guests_put","parameters":[{"name":"booking_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Booking Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StayGuestsRequest"}}}},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StayGuestBody"},"title":"Response Write Guests V1 Bookings Booking Id Guests Put"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/bookings/{booking_id}/qr":{"get":{"tags":["Бронирования"],"summary":"Билет заселения (Р-066)","description":"Клиент рисует QR из строки сам: картинка с сервера не нужна и лишний раз\nсветит бронь в кешах. Рядом с кодом печатается номер брони — им заселяют,\nкогда камера не справилась.","operationId":"booking_ticket_v1_bookings__booking_id__qr_get","parameters":[{"name":"booking_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Booking Id"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TicketResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/rentals":{"get":{"tags":["Долгосрочная аренда"],"summary":"Мои долгосрочные заявки","operationId":"read_rentals_v1_rentals_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RentalPage"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/rentals/{booking_id}":{"get":{"tags":["Долгосрочная аренда"],"summary":"Состояние сделки: что уже сделано, чей сейчас ход и все её чеки","operationId":"read_rental_v1_rentals__booking_id__get","parameters":[{"name":"booking_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Booking Id"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RentalDetail"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/rentals/{booking_id}/document":{"get":{"tags":["Долгосрочная аренда"],"summary":"Договор потоком. Прямой ссылки на приватный файл не существует","operationId":"download_document_v1_rentals__booking_id__document_get","parameters":[{"name":"booking_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Booking Id"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/rentals/{booking_id}/sign":{"post":{"tags":["Долгосрочная аренда"],"summary":"Согласие с договором — и конец пути (Р-194)","description":"Подписывает **гость**: партнёр расписался тем, что приложил договор и\nзакрепил за ним номер с датами. С этой подписью договор заключён,\nизменению не подлежит, а его дни становятся занятыми.\n\nПосле срока (семь дней от приложения) — `409 sign_expired`: подпись\nбольше не принимается, и партнёр решает, прислать договор заново или\nотменить сделку.","operationId":"sign_v1_rentals__booking_id__sign_post","parameters":[{"name":"booking_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Booking Id"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RentalBody"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/rentals/{booking_id}/cancel":{"post":{"tags":["Долгосрочная аренда"],"summary":"Отказ от сделки — до подписи (Р-194)","description":"После подписи договор заключён между сторонами, и расторгают его они\nсами: сервис не сторона этой бумаги. Такой вызов — `409 already_signed`.","operationId":"cancel_v1_rentals__booking_id__cancel_post","parameters":[{"name":"booking_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Booking Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RentalCancel"}}}},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RentalBody"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/dialogs":{"get":{"tags":["Чат"],"summary":"Мои диалоги, свежие сверху; с q — только те, где нашлось","operationId":"list_dialogs_v1_dialogs_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":100},{"type":"null"}],"description":"Поиск (нехватка №39): имя хозяина, название объекта, номер брони, тема обращения, текст сообщений — оригинал и перевод на языке запроса. Скрытые контакты не ищутся","title":"Q"},"description":"Поиск (нехватка №39): имя хозяина, название объекта, номер брони, тема обращения, текст сообщений — оригинал и перевод на языке запроса. Скрытые контакты не ищутся"}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DialogList"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]},"post":{"tags":["Чат"],"summary":"Открывает переписку с бизнесом — по бизнесу, объекту или брони","description":"Переписка **одна на пару «гость — бизнес»** (Р-484): со страницы\nбизнеса, с объявления и из брони открывается одна и та же, объект к ней\nне прикрепляется — о нём пишут ссылкой. Ответ — переписка целиком, как в\nсписке.","operationId":"open_dialog_v1_dialogs_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DialogOpen"}}}},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DialogBody"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/dialogs/support":{"post":{"tags":["Чат"],"summary":"Обращение в поддержку. Открытое обращение у человека одно","operationId":"open_support_v1_dialogs_support_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupportOpen"}}},"required":true},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DialogBody"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/dialogs/{dialog_id}/messages":{"get":{"tags":["Чат"],"summary":"Лента сообщений, новые снизу","description":"`before_id` листает историю вверх, `after_id` добирает пропущенное вперёд:\nклиент, у которого не открылся сокет, спрашивает «что было после этого\nномера», а не «последние тридцать».\n\n`with_deleted` — по запросу, а не всегда: ленту читают и клиенты, которые\nзаглушку рисовать не умеют (лента заказа, выпущенные приложения), — у них\nудалённое вышло бы пустым пузырём.","operationId":"history_v1_dialogs__dialog_id__messages_get","parameters":[{"name":"dialog_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Dialog Id"}},{"name":"before_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"История вверх: «дай N до этого id»","title":"Before Id"},"description":"История вверх: «дай N до этого id»"},{"name":"after_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Добор вперёд: «дай всё после этого id»","title":"After Id"},"description":"Добор вперёд: «дай всё после этого id»"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":30,"title":"Limit"}},{"name":"with_deleted","in":"query","required":false,"schema":{"type":"boolean","description":"Вместе с удалёнными — заглушкой `deleted: true` без текста и файла (нехватка №57); без флага их нет, как раньше","default":false,"title":"With Deleted"},"description":"Вместе с удалёнными — заглушкой `deleted: true` без текста и файла (нехватка №57); без флага их нет, как раньше"}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessagePage"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]},"post":{"tags":["Чат"],"summary":"Отправляет сообщение","description":"Перевод для собеседника ставится **после ответа** (Р-064): это сетевой\nвызов к модели, и держать на нём отправителя незачем. Оригинал уйдёт\nсразу, перевод догонит событием `message.translated`.","operationId":"send_message_v1_dialogs__dialog_id__messages_post","parameters":[{"name":"dialog_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Dialog Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageSend"}}}},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageBody"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/dialogs/{dialog_id}/files":{"post":{"tags":["Чат"],"summary":"Пакет документов: до десяти файлов и двадцать мегабайт суммарно (Р-205)","description":"Каждый файл сначала загружается обычным `POST /v1/uploads`, а сюда\nприходят их идентификаторы. Отправка одна: для человека это одно действие,\nи в переписке оно должно выглядеть одним событием.\n\nЛимит скорости — тот же, что у сообщений: пакет считается одной отправкой,\nиначе десять файлов упирались бы в секундный потолок на середине.","operationId":"send_files_v1_dialogs__dialog_id__files_post","parameters":[{"name":"dialog_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Dialog Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilesSend"}}}},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MessageBody"},"title":"Response Send Files V1 Dialogs Dialog Id Files Post"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/dialogs/{dialog_id}/messages/{message_id}":{"delete":{"tags":["Чат"],"summary":"Убирает СВОЁ сообщение из переписки","description":"Человек написал не то и хочет это убрать — обычное дело, и запрещать\nнезачем. Из базы сообщение при этом не пропадает (правило №6): спор о\nброне разбирается через месяцы, и «гость удалил сообщение» не должно\nозначать «доказательств нет».\n\nСистемную запись — подтверждение брони, оплату — удалить нельзя: по ней\nобе стороны восстанавливают, что происходило и когда.","operationId":"delete_message_v1_dialogs__dialog_id__messages__message_id__delete","parameters":[{"name":"dialog_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Dialog Id"}},{"name":"message_id","in":"path","required":true,"schema":{"type":"integer","title":"Message Id"}}],"responses":{"204":{"description":"Успешный ответ"},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/dialogs/{dialog_id}/read":{"post":{"tags":["Чат"],"summary":"Помечает прочитанным до указанного сообщения включительно","operationId":"mark_read_v1_dialogs__dialog_id__read_post","parameters":[{"name":"dialog_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Dialog Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__chat__ReadRequest"}}}},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Mark Read V1 Dialogs Dialog Id Read Post"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/uploads":{"post":{"tags":["Чат"],"summary":"Загружает вложение до отправки сообщения","description":"Файлы в WebSocket не летят вовсе: разрыв связи посреди отправки терял бы\nи файл, и сообщение сразу.","operationId":"upload_v1_uploads_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_v1_uploads_post"}}},"required":true},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/messages/{message_id}/file":{"get":{"tags":["Чат"],"summary":"Приватное вложение диалога: голосовое или документ","description":"Отдаётся **потоком после проверки прав**, а не ссылкой: файл лежит в\nприватном бакете, и ссылка из истории браузера без действующей сессии\nучастника ничего не откроет (правило №7).","operationId":"attachment_v1_messages__message_id__file_get","parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"integer","title":"Message Id"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/notifications":{"get":{"tags":["Уведомления"],"summary":"Лента: ключи и параметры, тексты собирает клиент (docs/api.md §3)","description":"Название объекта в параметрах — уже на языке запроса (находка №85).","operationId":"feed_v1_notifications_get","parameters":[{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":50,"minimum":1},{"type":"null"}],"title":"Limit"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationPage"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/notifications/read":{"post":{"tags":["Уведомления"],"summary":"Отметить уведомления прочитанными — до up_to_id включительно или все","description":"Ответ — `{\"read\": сколько отмечено, \"unread\": сколько осталось}`: число у\nколокольчика (`/v1/me/badges`) клиент берёт отсюда, без второго запроса.","operationId":"mark_read_v1_notifications_read_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__notifications__ReadRequest"}}},"required":true},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Mark Read V1 Notifications Read Post"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/devices":{"get":{"tags":["Уведомления"],"summary":"Устройства, куда сейчас уходят пуши: с действующей сессией (Р-424)","operationId":"list_devices_v1_devices_get","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/DeviceBody"},"type":"array","title":"Response List Devices V1 Devices Get"}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]},"post":{"tags":["Уведомления"],"summary":"Регистрация пуш-токена. Повторный запуск приложения — обновление","description":"Устройство записывается **вместе с сессией** (Р-424): пуш уходит, пока\nсессия жива. Вышел человек или вошёл заново — клиент присылает токен ещё\nраз, и устройство переезжает на новую сессию. Платформы — `web`,\n`android`, `ios`.","operationId":"register_device_v1_devices_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeviceRegister"}}},"required":true},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeviceBody"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/devices/forget":{"post":{"tags":["Уведомления"],"summary":"Выключить пуши на этом устройстве — по его токену (Р-424)","description":"Браузер знает свой токен, но не идентификатор строки. Чужой или\nнезнакомый токен — тот же `204`: устройство и так молчит.","operationId":"forget_this_device_v1_devices_forget_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeviceForget"}}},"required":true},"responses":{"204":{"description":"Успешный ответ"},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/devices/{device_id}":{"delete":{"tags":["Уведомления"],"summary":"Забыть своё устройство: пуши на него больше не уходят (Р-424)","operationId":"forget_device_v1_devices__device_id__delete","parameters":[{"name":"device_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Device Id"}}],"responses":{"204":{"description":"Успешный ответ"},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/unsubscribe":{"get":{"tags":["Уведомления"],"summary":"Отписка по подписанной ссылке, без входа: выключает все уведомления роли (Р-404)","description":"Ссылка одна на все четыре роли — гостя, партнёра, модератора и админа:\nроль и человек лежат в токене.","operationId":"unsubscribe_v1_unsubscribe_get","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string","minLength":16,"title":"Token"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnsubscribeResult"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/listings/{listing_id}/reviews":{"get":{"tags":["Отзывы"],"summary":"Отзывы объекта и средние по критериям","description":"Порядок, отбор по оценке и поиск нужны отдельной странице отзывов\n(Р-225): на карточке объекта тем же эндпоинтом берутся три лучших.\nСредние по критериям и счётчик отбор **не меняет** — они по всему объекту.","operationId":"listing_reviews_v1_listings__listing_id__reviews_get","parameters":[{"name":"listing_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Listing Id"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":50,"minimum":1},{"type":"null"}],"title":"Limit"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","description":"Порядок: recent — свежие, best — лучшие, worst — худшие","default":"recent","title":"Sort"},"description":"Порядок: recent — свежие, best — лучшие, worst — худшие"},{"name":"rating","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":5,"minimum":1},{"type":"null"}],"description":"Только с этой оценкой","title":"Rating"},"description":"Только с этой оценкой"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Поиск по тексту отзыва","title":"Q"},"description":"Поиск по тексту отзыва"}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListingReviews"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/reviews/pending":{"get":{"tags":["Отзывы"],"summary":"По каким поездкам можно оставить отзыв и до какого момента","operationId":"pending_v1_reviews_pending_get","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/PendingBooking"},"type":"array","title":"Response Pending V1 Reviews Pending Get"}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/reviews":{"post":{"tags":["Отзывы"],"summary":"Отзыв об объекте по завершённой поездке","description":"Ответ отдаётся автору, поэтому в нём виден и ещё не раскрытый отзыв: свой\nтекст человек имеет право увидеть сразу.","operationId":"create_review_v1_reviews_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewCreate"}}},"required":true},"responses":{"201":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewBody"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/reviews/{review_id}":{"patch":{"tags":["Отзывы"],"summary":"Правит свой отзыв — пока он не опубликован","description":"После публикации правка запрещена, и это не придирка. Раскрытие слепое:\nобе стороны пишут не глядя друг на друга, партнёр отвечает на конкретный\nтекст. Разрешить менять текст после ответа — значит позволить поменять\nвопрос, на который уже ответили.","operationId":"update_review_v1_reviews__review_id__patch","parameters":[{"name":"review_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Review Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewUpdate"}}}},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewBody"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["Отзывы"],"summary":"Автор забирает свой отзыв обратно","description":"Разрешено и после публикации: промолчать человек вправе всегда, а вот\nпереписать сказанное задним числом — нет. Удаление мягкое (правило №6):\nстрока и текст остаются, из показа и из рейтинга отзыв уходит.","operationId":"delete_review_v1_reviews__review_id__delete","parameters":[{"name":"review_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Review Id"}}],"responses":{"204":{"description":"Успешный ответ"},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/reviews/my":{"get":{"tags":["Отзывы"],"summary":"Мои отзывы и опубликованные отзывы обо мне","operationId":"my_reviews_v1_reviews_my_get","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MyReviews"}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/report-reasons":{"get":{"tags":["Жалобы"],"summary":"Причины для вида цели — в порядке формы, «другое» последним","operationId":"report_reasons_v1_report_reasons_get","parameters":[{"name":"target_kind","in":"query","required":false,"schema":{"enum":["listing","partner","review"],"type":"string","default":"listing","title":"Target Kind"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ReportReason"},"title":"Response Report Reasons V1 Report Reasons Get"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/reports":{"post":{"tags":["Жалобы"],"summary":"Жалоба на объект, бизнес или отзыв. Повтор до разбора — счётчик, а не новая","operationId":"create_report_v1_reports_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportCreate"}}},"required":true},"responses":{"201":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportAccepted"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/partners/{partner_id}":{"get":{"tags":["Бизнес"],"summary":"Карточка бизнеса и его объекты одним ответом","description":"Одним, потому что страница без объектов — это пустая страница: два\nзапроса означали бы, что человек сначала видит название компании, а через\nмгновение под ним появляются виллы и всё подпрыгивает.","operationId":"partner_page_v1_partners__partner_id__get","parameters":[{"name":"partner_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Partner Id"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerPage"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{},{"bearerAuth":[]}]}},"/v1/partners/{partner_id}/reviews":{"get":{"tags":["Бизнес"],"summary":"Отзывы по всем объектам бизнеса, свежие сверху","description":"Одной лентой, а не по объектам: человек хочет понять, как эта компания\nработает вообще, а не листать отзывы двадцати вилл по очереди.","operationId":"partner_reviews_v1_partners__partner_id__reviews_get","parameters":[{"name":"partner_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Partner Id"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerReviews"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/bookings/{booking_id}/payment":{"post":{"tags":["Оплата"],"summary":"Начинает оплату и возвращает адрес страницы банка","description":"Платить можно только подтверждённую бронь: пока партнёр не ответил, он\nещё может отказать, и деньги пришлось бы возвращать.","operationId":"start_payment_v1_bookings__booking_id__payment_post","parameters":[{"name":"booking_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Booking Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentStart"}}}},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentStarted"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/payments/confirm":{"get":{"tags":["Оплата"],"summary":"Проверяет платёж после возврата из банка","description":"Номер платежа приходит из адреса, а состояние — из запроса к провайдеру:\nадрес человек правит руками, и «оплачено» в нём не значит ничего.","operationId":"confirm_payment_v1_payments_confirm_get","parameters":[{"name":"payment_id","in":"query","required":true,"schema":{"type":"string","minLength":8,"maxLength":128,"title":"Payment Id"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentResult"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/ego/v1/health":{"get":{"tags":["Витрина в EGO"],"summary":"Проверка здоровья модуля. EGO зовёт её раз в минуту","description":"Подписи не требует намеренно: по этому ответу в разделе «Модули» рисуется\n«онлайн», и он обязан зависеть от сервиса, а не от ключа.","operationId":"health_ego_v1_health_get","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Health Ego V1 Health Get"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/ego/v1/search_listings":{"post":{"tags":["Витрина в EGO"],"summary":"Поиск объектов одной из пяти категорий по фильтрам","operationId":"search_listings_ego_v1_search_listings_post","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Search Listings Ego V1 Search Listings Post"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/ego/v1/listing_details":{"post":{"tags":["Витрина в EGO"],"summary":"Карточка объекта по адресу или идентификатору из выдачи","operationId":"listing_details_ego_v1_listing_details_post","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Listing Details Ego V1 Listing Details Post"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/ego/v1/search_events":{"post":{"tags":["Витрина в EGO"],"summary":"Афиша города по фильтрам: день, категория, вход, время, язык","operationId":"search_events_ego_v1_search_events_post","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Search Events Ego V1 Search Events Post"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/ego/v1/upcoming_events":{"post":{"tags":["Витрина в EGO"],"summary":"Ближайшие события подборкой — по одному на событие","operationId":"upcoming_events_ego_v1_upcoming_events_post","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Upcoming Events Ego V1 Upcoming Events Post"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/ego/v1/event_details":{"post":{"tags":["Витрина в EGO"],"summary":"Страница события по адресу из выдачи","operationId":"event_details_ego_v1_event_details_post","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Event Details Ego V1 Event Details Post"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/ego/v1/account/status":{"post":{"tags":["Витрина в EGO: аккаунт и брони"],"summary":"Вошёл ли человек в Bounty, а если нет — есть ли аккаунт на его почту","operationId":"account_status_ego_v1_account_status_post","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Account Status Ego V1 Account Status Post"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/ego/v1/account/connect":{"post":{"tags":["Витрина в EGO: аккаунт и брони"],"summary":"Войти в аккаунт на почту из EGO или завести его одним действием","operationId":"account_connect_ego_v1_account_connect_post","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Account Connect Ego V1 Account Connect Post"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/ego/v1/account/profile":{"post":{"tags":["Витрина в EGO: аккаунт и брони"],"summary":"Кто человек в Bounty и сколько у него броней впереди","operationId":"account_profile_ego_v1_account_profile_post","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Account Profile Ego V1 Account Profile Post"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/ego/v1/account/logout":{"post":{"tags":["Витрина в EGO: аккаунт и брони"],"summary":"Выйти: ключ EGO гасится, аккаунт остаётся","operationId":"account_logout_ego_v1_account_logout_post","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Account Logout Ego V1 Account Logout Post"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/ego/v1/listing/slots":{"post":{"tags":["Витрина в EGO: аккаунт и брони"],"summary":"Выходы объекта на день или на две недели вперёд","operationId":"listing_slots_ego_v1_listing_slots_post","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Listing Slots Ego V1 Listing Slots Post"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/ego/v1/booking/quote":{"post":{"tags":["Витрина в EGO: аккаунт и брони"],"summary":"Сколько будет стоить бронь и что спросят перед ней","operationId":"booking_quote_ego_v1_booking_quote_post","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Booking Quote Ego V1 Booking Quote Post"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/ego/v1/booking/create":{"post":{"tags":["Витрина в EGO: аккаунт и брони"],"summary":"Оформить бронь — тем же обработчиком, что POST /v1/bookings сайта","description":"Ключ идемпотентности — тот, что прислал EGO (`Idempotency-Key`): двойное\nнажатие и повтор из-за сети дают одну бронь.\n\nОтказ по делу (места разобрали, нет телефона, не хватает участников)\nприходит ответом `created: false` с причиной словами: окно EGO показывает\nчеловеку только текст ответа, а текст ошибки — нет. Попытка откатывается\nцеликом: бронь либо записана вся, либо её нет.","operationId":"booking_create_ego_v1_booking_create_post","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Booking Create Ego V1 Booking Create Post"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/ego/v1/bookings/mine":{"post":{"tags":["Витрина в EGO: аккаунт и брони"],"summary":"Свои брони, новые сверху: впереди, прошедшие или все","operationId":"bookings_mine_ego_v1_bookings_mine_post","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Bookings Mine Ego V1 Bookings Mine Post"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/ego/v1/bookings/details":{"post":{"tags":["Витрина в EGO: аккаунт и брони"],"summary":"Карточка своей брони: статус, чек, оплата, отмена, адрес, шаги","operationId":"bookings_details_ego_v1_bookings_details_post","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Bookings Details Ego V1 Bookings Details Post"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/ego/v1/bookings/pay":{"post":{"tags":["Витрина в EGO: аккаунт и брони"],"summary":"Ссылка «Оплатить» по своей брони — и сколько, и на каких условиях","operationId":"bookings_pay_ego_v1_bookings_pay_post","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Bookings Pay Ego V1 Bookings Pay Post"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/ego/v1/bookings/messages":{"post":{"tags":["Витрина в EGO: аккаунт и брони"],"summary":"Лента заказа: реплики человека и партнёра, новые снизу","description":"Открыл ленту в окне — прочитал: счётчик непрочитанного на сайте гаснет.","operationId":"bookings_messages_ego_v1_bookings_messages_post","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Bookings Messages Ego V1 Bookings Messages Post"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/ego/v1/bookings/message":{"post":{"tags":["Витрина в EGO: аккаунт и брони"],"summary":"Написать партнёру в ленту заказа — тем же обработчиком, что у сайта","operationId":"bookings_message_ego_v1_bookings_message_post","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Bookings Message Ego V1 Bookings Message Post"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/ego/v1/bookings/cancel_preview":{"post":{"tags":["Витрина в EGO: аккаунт и брони"],"summary":"Сколько вернётся, если отменить прямо сейчас, и по какому правилу","operationId":"bookings_cancel_preview_ego_v1_bookings_cancel_preview_post","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Bookings Cancel Preview Ego V1 Bookings Cancel Preview Post"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/ego/v1/bookings/cancel":{"post":{"tags":["Витрина в EGO: аккаунт и брони"],"summary":"Отменить свою бронь — тем же обработчиком, что у сайта","operationId":"bookings_cancel_ego_v1_bookings_cancel_post","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Bookings Cancel Ego V1 Bookings Cancel Post"}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}}}},"/v1/favorite-lists":{"get":{"tags":["Избранное"],"summary":"Списки избранного вместе с числом объектов в каждом","operationId":"read_lists_v1_favorite_lists_get","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/FavoriteListResponse"},"type":"array","title":"Response Read Lists V1 Favorite Lists Get"}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]},"post":{"tags":["Избранное"],"summary":"Новый список: «Пхукет февраль», «Идеи на лето»","operationId":"create_list_v1_favorite_lists_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FavoriteListRequest"}}},"required":true},"responses":{"201":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FavoriteListResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/favorite-lists/{list_id}":{"patch":{"tags":["Избранное"],"summary":"Переименование списка","operationId":"rename_list_v1_favorite_lists__list_id__patch","parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"List Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FavoriteListRequest"}}}},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FavoriteListResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["Избранное"],"summary":"Удаление списка вместе с закладками в нём","description":"Список по умолчанию удалить нельзя: в него падает всё, что добавляют\nсердечком из ленты, и без него добавление некуда девать.","operationId":"delete_list_v1_favorite_lists__list_id__delete","parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"List Id"}}],"responses":{"204":{"description":"Успешный ответ"},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/favorites":{"get":{"tags":["Избранное"],"summary":"Объекты избранного — теми же карточками, что и в ленте, плюс цена на момент добавления","operationId":"read_favorites_v1_favorites_get","parameters":[{"name":"list_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Только этот список","title":"List Id"},"description":"Только этот список"},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":50,"minimum":1},{"type":"null"}],"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FavoritesPage"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]},"post":{"tags":["Избранное"],"summary":"Положить объект в избранное","description":"Повторное добавление ошибкой не считается: двойной тап по сердечку — это\nдвойной тап, а не попытка обмануть сервис.","operationId":"add_favorite_v1_favorites_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FavoriteRequest"}}}},"responses":{"201":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FavoriteResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/favorites/{listing_id}":{"delete":{"tags":["Избранное"],"summary":"Убрать объект из избранного — из всех своих списков сразу","operationId":"remove_favorite_v1_favorites__listing_id__delete","parameters":[{"name":"listing_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Listing Id"}}],"responses":{"204":{"description":"Успешный ответ"},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/leads":{"post":{"tags":["Заявки на подбор"],"summary":"Оставить заявку: имя, способ связи и контакт, комментарий по желанию","operationId":"create_lead_v1_leads_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadRequest"}}},"required":true},"responses":{"201":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadResponse"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{},{"bearerAuth":[]}]}},"/v1/assistant":{"get":{"tags":["Bounty AI"],"summary":"Работает ли помощник, сколько сообщений осталось в окне и что можно прислать","operationId":"read_state_v1_assistant_get","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Read State V1 Assistant Get"}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/assistant/messages":{"get":{"tags":["Bounty AI"],"summary":"Лента от старых к новым. before — листать назад, after — новые","description":"Лента одна, тем нет (Р-431): `thread_id` у сообщений — наследство\nпрежних тем, клиенту разделять по нему нечего.","operationId":"read_messages_v1_assistant_messages_get","parameters":[{"name":"before","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Before"}},{"name":"after","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"After"}},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":100,"minimum":1},{"type":"null"}],"title":"Limit"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Read Messages V1 Assistant Messages Get"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]},"post":{"tags":["Bounty AI"],"summary":"Сообщение помощнику. 202 — вопрос сохранён, ответ пишется в фоне","description":"В ответе — сообщение гостя, заготовка ответа (`status: pending`) и окно\nлимита. Готовый ответ приходит событием `assistant.message` по `/v1/ws`;\nбез сокета — `GET /v1/assistant/messages?after=…`. Повтор с тем же\n`Idempotency-Key` возвращает то же сообщение и не тратит лимит дважды.\n\nОшибки: `503 assistant_unavailable`; `429 assistant_limit`\n(`details.resets_at`); `409 assistant_busy`; `400 assistant_message_empty`\n/ `assistant_text_too_long` / `assistant_files_too_many` /\n`assistant_files_too_large_total`; `404 assistant_file_not_found`.","operationId":"send_v1_assistant_messages_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendRequest"}}}},"responses":{"202":{"description":"Успешный ответ","content":{"application/json":{"schema":{}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["Bounty AI"],"summary":"«Очистить переписку»: прежнее скрыто у гостя, в базе остаётся (правило №6)","operationId":"clear_v1_assistant_messages_delete","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Clear V1 Assistant Messages Delete"}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/assistant/greeting":{"post":{"tags":["Bounty AI"],"summary":"Заход в помощника: приветствие, если оно положено (Р-489, assistant.md §11.7)","description":"Клиент зовёт при каждом открытии помощника — приложение при запуске, сайт\nна странице `/ai` — с точкой устройства, если доступ к геолокации уже\nдан (запрашивать разрешение ради приветствия не нужно). Первый заход за\nокно лимита (6 ч) — в ответе новое сообщение `kind: proactive`,\n`trigger: greeting` (блоки `greeting`, `events`, `suggestions`); оно же\nуходит событием `assistant.message` на остальные устройства. Иначе —\n`{\"message\": null}`. Лимит сообщений не тратится. Точка сохраняется как\n«последнее известное место» на 30 дней в любом случае.","operationId":"greeting_v1_assistant_greeting_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GreetingRequest"}}},"required":true},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Greeting V1 Assistant Greeting Post"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/assistant/messages/{message_id}":{"get":{"tags":["Bounty AI"],"summary":"Одно сообщение — проверить, готов ли ответ, без сокета","operationId":"read_message_v1_assistant_messages__message_id__get","parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"integer","title":"Message Id"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Read Message V1 Assistant Messages Message Id Get"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/assistant/files":{"post":{"tags":["Bounty AI"],"summary":"Файл до сообщения: фото, документ (PDF, DOCX, XLSX, CSV, TXT) или голосовое","description":"Тип определяется по содержимому, а не по `kind`: `kind=voice` лишь говорит,\nчто это запись (ffmpeg приведёт её к mp3). Всё ложится в приватный бакет.\nОшибки: `assistant_file_type`, `assistant_file_too_large`,\n`assistant_pdf_too_long`, `assistant_voice_too_long`,\n`assistant_voice_unavailable`, `assistant_unavailable`.","operationId":"upload_v1_assistant_files_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_v1_assistant_files_post"}}},"required":true},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Upload V1 Assistant Files Post"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/assistant/files/{file_id}":{"get":{"tags":["Bounty AI"],"summary":"Файл потоком после проверки владельца (правило №7). Чужой — 404","operationId":"download_v1_assistant_files__file_id__get","parameters":[{"name":"file_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"File Id"}},{"name":"size","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"thumb — превью фото","title":"Size"},"description":"thumb — превью фото"}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/assistant/messages/{message_id}/retry":{"post":{"tags":["Bounty AI"],"summary":"«Спросить ещё раз»: неудачный ответ снова пишется. Тратит одно сообщение","operationId":"retry_v1_assistant_messages__message_id__retry_post","parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"integer","title":"Message Id"}}],"responses":{"202":{"description":"Успешный ответ","content":{"application/json":{"schema":{}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/assistant/messages/{message_id}/stop":{"post":{"tags":["Bounty AI"],"summary":"«Остановить ответ» (Р-447): заготовка — в «Вы остановили ответ» (stopped)","description":"Клиенты кнопку больше не показывают (Р-461): пока помощник отвечает,\nотправить новое нельзя — ждут ответа. Эндпоинт оставлен для совместимости.\n\nСообщение возвращается в лимит — помощник не ответил. Ответ, который\nуже готов, не трогается и возвращается как есть. Задача, которая пишет\nответ, бросает работу на ближайшем шаге; следующий вопрос можно\nотправлять сразу. Повторить — `POST …/retry`.","operationId":"stop_v1_assistant_messages__message_id__stop_post","parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"integer","title":"Message Id"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Stop V1 Assistant Messages Message Id Stop Post"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/assistant/messages/{message_id}/offer":{"post":{"tags":["Bounty AI"],"summary":"Ответ на предложение помощника (Р-449): уведомление или заметка","description":"`accept` у `reminder_offer` ставит уведомление (`local_time` —\n«Другое время»), у `note_offer` записывает заметку (`title`, `text` —\nпоправленные гостем). `skip` — крестик: предложение скрывается. Блок\nполучает `state` и номер созданного (`reminder_id`, `note_id`) на всех\nустройствах; повторный ответ ничего не меняет. Лимит не тратится.\n\nОшибки: `404 assistant_message_not_found` (нет такого предложения),\n`reminder_invalid`, `reminders_too_many`, `note_invalid`, `notes_too_many`.","operationId":"answer_offer_v1_assistant_messages__message_id__offer_post","parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"integer","title":"Message Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferAnswer"}}}},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Answer Offer V1 Assistant Messages Message Id Offer Post"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/assistant/messages/{message_id}/feedback":{"post":{"tags":["Bounty AI"],"summary":"👍/👎 ответу. У 👎 — причина (wrong, useless, other) и текст","operationId":"feedback_v1_assistant_messages__message_id__feedback_post","parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"integer","title":"Message Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackRequest"}}}},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Feedback V1 Assistant Messages Message Id Feedback Post"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/assistant/messages/{message_id}/checklist":{"post":{"tags":["Bounty AI"],"summary":"Галочка чек-листа. Сохраняется — видна с любого устройства","operationId":"checklist_v1_assistant_messages__message_id__checklist_post","parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"integer","title":"Message Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChecklistRequest"}}}},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Checklist V1 Assistant Messages Message Id Checklist Post"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/assistant/read":{"post":{"tags":["Bounty AI"],"summary":"Прочитано до сообщения включительно — гаснет счётчик на пункте меню","operationId":"read_v1_assistant_read_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__routers__assistant__ReadRequest"}}},"required":true},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Read V1 Assistant Read Post"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/assistant/settings":{"get":{"tags":["Bounty AI"],"summary":"Настройки помощника гостя: сообщения первым, голос, озвучка, память","operationId":"read_settings_v1_assistant_settings_get","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Read Settings V1 Assistant Settings Get"}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]},"patch":{"tags":["Bounty AI"],"summary":"Настройки помощника. Меняется только присланное","description":"* `proactive` — «Bounty AI пишет первым»: `all`, `trips`, `off`;\n* `voice` — голос помощника: `female`, `male` (Р-429);\n* `voice_reply` — отвечать голосом на голосовое (Р-429);\n* `ask_location` — можно ли спрашивать точное местоположение (Р-432);\n «Не сейчас» у запроса выключает само.","operationId":"change_settings_v1_assistant_settings_patch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingsRequest"}}},"required":true},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Change Settings V1 Assistant Settings Patch"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/assistant/memory":{"get":{"tags":["Bounty AI"],"summary":"Что помнит Bounty AI о госте","operationId":"read_memory_v1_assistant_memory_get","responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Read Memory V1 Assistant Memory Get"}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["Bounty AI"],"summary":"Забыть всё, что помощник помнит о госте. Ответ — 204 без тела","operationId":"forget_everything_v1_assistant_memory_delete","responses":{"204":{"description":"Успешный ответ"},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/assistant/memory/{fact_id}":{"delete":{"tags":["Bounty AI"],"summary":"Забыть один факт памяти помощника. Ответ — 204 без тела","operationId":"forget_fact_v1_assistant_memory__fact_id__delete","parameters":[{"name":"fact_id","in":"path","required":true,"schema":{"type":"integer","title":"Fact Id"}}],"responses":{"204":{"description":"Успешный ответ"},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]}},"/v1/assistant/messages/{message_id}/speech":{"post":{"tags":["Bounty AI"],"summary":"Озвучить ответ помощника или одну его фразу (Р-429, docs/assistant.md §8а)","description":"Без `block` — ответ целиком, тепло; с `block` — фраза блока `phrases`\n(`item` — её номер) или «Покажите водителю», медленно и чётко. Голос —\nгостя (`voice` в настройках). Звук создаётся один раз: повтор и другое\nустройство получают тот же файл. Лимит сообщений не тратится.\n\nОшибки: `503 assistant_speech_unavailable`, `400 assistant_speech_empty`,\n`502 assistant_speech_failed`, `404 assistant_message_not_found`.","operationId":"speech_v1_assistant_messages__message_id__speech_post","parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"integer","title":"Message Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpeechRequest"}}}},"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Speech V1 Assistant Messages Message Id Speech Post"}}}},"400":{"description":"Неверные параметры или тело запроса — `validation_error`; в `details.fields` — какие поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"validation_error","message":"Проверьте заполненные поля","request_id":"0f1c2b7e9a4d4c1e"}}}}},"401":{"description":"Нет входа, токен истёк или сессия закрыта — `unauthorized`. Обновите пару `POST /v1/auth/refresh` и повторите; не вышло — на вход","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"unauthorized","message":"Требуется авторизация","request_id":"0f1c2b7e9a4d4c1e"}}}}},"403":{"description":"Вход есть, но действие недоступно: почта не подтверждена — `email_not_confirmed`, аккаунт ограничен — `account_restricted`, нет прав — `forbidden`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"email_not_confirmed","message":"Подтвердите почту, чтобы продолжить","request_id":"0f1c2b7e9a4d4c1e"}}}}},"404":{"description":"Нет такого объекта или он вам не принадлежит — `not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"Не найдено","request_id":"0f1c2b7e9a4d4c1e"}}}}},"429":{"description":"Слишком часто — `rate_limited`. Подождите столько секунд, сколько в заголовке `Retry-After`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Слишком много запросов","request_id":"0f1c2b7e9a4d4c1e"}}}}},"500":{"description":"Сбой на стороне сервиса — `internal_error`; `request_id` — для поддержки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"internal_error","message":"Внутренняя ошибка","request_id":"0f1c2b7e9a4d4c1e"}}}}}},"security":[{"bearerAuth":[]}]},"get":{"tags":["Bounty AI"],"summary":"Озвучка потоком — для