{"openapi":"3.1.0","info":{"title":"I love Saratov — открытые данные","version":"1.0.0","summary":"Справочник по Саратову в машиночитаемом виде.","description":"Данные независимого некоммерческого путеводителя по Саратову: достопримечательности, цены, ответы на частые вопросы, известные люди, климат и расчёт бюджета поездки.\n\nАвторизация не нужна, всё только на чтение, CORS открыт. Цены и режим работы — ориентиры на август 2026 года, а не оферта. Перед визитом проверяйте на сайте конкретного заведения.\n\nТе же данные доступны как HTML-страницы, как markdown (`Accept: */*` или адрес с расширением `.md`) и как JSON-LD в разметке каждой страницы.","contact":{"email":"hello@ilovesaratov.shop","url":"https://ilovesaratov.shop/about.html"},"license":{"name":"Данные можно свободно использовать со ссылкой на источник.","url":"https://ilovesaratov.shop/about.html"}},"servers":[{"url":"https://ilovesaratov.shop/api/v1","description":"Основной адрес"}],"paths":{"/":{"get":{"summary":"Что есть в этом API","description":"Список эндпоинтов, адрес спеки и условия использования данных.","operationId":"","responses":{"200":{"description":"Что есть в этом API","content":{"application/json":{"schema":{"type":"object"},"examples":{"пример":{"externalValue":"https://ilovesaratov.shop/api/v1/"}}}}}}}},"/attractions":{"get":{"summary":"Достопримечательности","description":"Четырнадцать мест в городе с адресами, часами работы, ценами билетов и рекомендуемым временем осмотра, плюс четыре поездки по области с расстояниями.","operationId":"attractions","responses":{"200":{"description":"Достопримечательности","content":{"application/json":{"schema":{"type":"object"},"examples":{"пример":{"externalValue":"https://ilovesaratov.shop/api/v1/attractions"}}}}}}}},"/prices":{"get":{"summary":"Цены","description":"Цены по категориям: дорога из Москвы, жильё, еда, транспорт, билеты. Плюс три готовых бюджета на три дня.","operationId":"prices","responses":{"200":{"description":"Цены","content":{"application/json":{"schema":{"type":"object"},"examples":{"пример":{"externalValue":"https://ilovesaratov.shop/api/v1/prices"}}}}}}}},"/faq":{"get":{"summary":"Вопросы и ответы","description":"Восемнадцать практических вопросов о поездке с полными ответами.","operationId":"faq","responses":{"200":{"description":"Вопросы и ответы","content":{"application/json":{"schema":{"type":"object"},"examples":{"пример":{"externalValue":"https://ilovesaratov.shop/api/v1/faq"}}}}}}}},"/people":{"get":{"summary":"Известные люди","description":"Пятнадцать человек, связанных с городом, и что от них осталось в Саратове.","operationId":"people","responses":{"200":{"description":"Известные люди","content":{"application/json":{"schema":{"type":"object"},"examples":{"пример":{"externalValue":"https://ilovesaratov.shop/api/v1/people"}}}}}}}},"/city":{"get":{"summary":"О городе","description":"Факты о городе, климат по сезонам с оценкой для поездки и все способы добраться из Москвы с ценами.","operationId":"city","responses":{"200":{"description":"О городе","content":{"application/json":{"schema":{"type":"object"},"examples":{"пример":{"externalValue":"https://ilovesaratov.shop/api/v1/city"}}}}}}}},"/budget":{"get":{"summary":"Рассчитать бюджет поездки","description":"Считает стоимость поездки для заданного числа дней, людей, уровня комфорта и сезона. Расчёт выполняется на сервере, ответ зависит только от параметров запроса. Жильё считается по ночёвкам: поездка на N дней — это N−1 ночь.","operationId":"budget","parameters":[{"name":"days","in":"query","required":true,"description":"Сколько дней длится поездка.","schema":{"type":"integer","minimum":1,"maximum":14,"example":14}},{"name":"people","in":"query","required":true,"description":"Сколько человек едет.","schema":{"type":"integer","minimum":1,"maximum":20,"example":10}},{"name":"level","in":"query","required":true,"description":"Уровень комфорта: econom — хостел и столовые, comfort — отель 3★ и кафе, premium — отель 4★ и рестораны.","schema":{"type":"string","enum":["econom","comfort","premium"],"example":"premium"}},{"name":"season","in":"query","required":true,"description":"velvet — май и сентябрь, обычные цены; summer — июнь–август, жильё дороже на 20 %; winter — октябрь–апрель, дешевле на 15 %.","schema":{"type":"string","enum":["velvet","summer","winter"],"example":"winter"}},{"name":"travel","in":"query","required":false,"description":"1 — добавить дорогу из Москвы и обратно.","schema":{"type":"string","enum":["0","1"],"example":"1"}}],"responses":{"200":{"description":"Расчёт бюджета","content":{"application/json":{"schema":{"type":"object"},"examples":{"пример":{"externalValue":"https://ilovesaratov.shop/api/v1/budget?days=14&people=10&level=premium&season=winter&travel=1"}}}}},"400":{"description":"Параметр вне допустимых значений; в теле — что именно не так."}}}}}}