АПИ Инфофлота

Отправляйте АПИ-ключ параметром в командной строке ?key=XXXXXXXXX или заголовком запроса x-api-key

Методы АПИ

Города
Город
Города
Круизы
Круиз
Статусы кают в круизе
Подбор кают для пассажиров и расчет стоимости
Скидки
Скидка
Правила применения скидок
Услуги на борту
Услуга на борту
Общественные места
Общественное место
Реки
Река
Порты
Порты после фильтра
Порт
Страны
Страна
Гражданство
Гражданство
Курсы валют
Курсы валют
Регионы
Регион
Возвращает список броней круиза
Новости и спецпредложения
Новость или спецпредложение
Теплоходы и лайнеры
Теплоход или лайнер
Теплоходы и лайнеры (активные)
Теплоход или лайнер
Теплоходы и лайнеры (как в меню)
Дополнительная информация о корабле
Популярные маршруты
Популярный маршрут
Поиск по названию
Заявки и бронирование
Заявка
ВАЖНО! c 23.09.2019 года прекратили работу методы /discounts, /discounts/:id и /discounts-rules. Данные о скидках теперь доступны в методах /cruises, /cruises/:id, /ships и /ships/:id в секциях discounts.
История изменений
15.09.2023
Добавлены методы /currencies/ и /currencies/:id для получения курсов валют используемых Инфофлотом.
14.09.2023
Добавлены методы /citizenships/ и /citizenships/:id для получения списка кодов гражданств которые используются для ввода паспортных данных.
Метод /cruises/ теперь возвращает и:
- 'rate_euro' - Курс евро в рублях
- 'min_price_euro' - Минимальную цену каюты в евро
26.07.2023
Метод /onboard-services/ теперь выводит и:
- 'icon' - SVG иконка услуги на борту
- 'priority' - Сортировка иконок, от большего к меньшему
В ответ метода /ships/:id в CabinTypes добавлен список услуг "В каюте" inRoomServices.
В ответ метода /ships/:id в CabinTypes добавлено поле 'group' - Группировка каюты по виду окна.
В ответ метода /ships/:id добавлено поле 'touristicProduct' - Текст секции "Обслуживание на борту (турпродукт)".
19.07.2023
В метод /ships/:id добавлен sug - массив скидок и акций.

В метод /ships/:id в список категорий кают добавлен position - порядковый номер для сортировки.
21.06.2023
В методе /ships/:id технические характеристики (длинна, ширина, к-во пассажиров, к-во палуб) вынесены из текствого описания корабля (descriptionBig) в объект techSpecifications.

В метод /ships/:id добавлена ссылка excursionProgram на файл в формате word или pdf с описанием экскурсий (если имеется).

В методах /ships/:id и /cruises, починены: подробное описание корабля (descriptionBig), "включено в стоимость" (include), "оплачивается отдельно" (additional) и SVG схемы (schemes, svgScheme).
16.06.2023
Метод /cruises теперь возвращает и dockStart - индентификатор причала порта отправления, который известен только в день отправления.
05.06.2023
В метод /cruises добавлен фильтр по minFreeCabins который показывает только круизы у которых minFreeCabins свободных кают.
05.05.2023
В метод /ports добавлена информация о причалах.
11.04.2023
Методы /ships, /ships-active, /cruises теперь возвращают и оператора, а именно поля:
- operatorId - Идентификатор оператора
- operatorName - Название (юридическое) оператора
- operatorBrandName - Бренд оператора (на пример "MSC" у которого юридическое лицо совсем по другому назвывается: operatorName=ПАК Тревел).

Так же в метод /cruises для поиска по индентификатору оператора (возможно перечисленным через запятую) добавлен фильтр operator.
07.04.2023
Для методов /ships-active, /popular-routes, /regions, /countries в фильтр типы кораблей (поле type): который разделяет круизы на табы как на главном сайте, добавлен тип/таб:
- turkishRivieraAsOnMainSite - "Круизы по турецкой ривьере".
16.12.2022
В документацию метода /requests/:id добавлено описание statuses.
30.09.2022
Метод /ships/:id теперь не только принимает :id - "численное id корабля" как раньше, но и "имя в url" типа "nekrasov" как на главном сайте.
23.08.2022
В методы /ships-active, /popular-routes, /regions, /countries добавлены в фильтр типы кораблей (поле type): riverAsOnMainSite, fromSochiAsOnMainSite, riverForeignAsOnMainSite, seaAsOnMainSite - который разделяет круизы на табы как на главном сайте.
28.07.2022
В метод /cruises добавлены в фильтр типы кораблей (поле type): riverAsOnMainSite, fromSochiAsOnMainSite, riverForeignAsOnMainSite, seaAsOnMainSite - который разделяет круизы на табы как на главном сайте.
28.07.2022
Добавлен метод /ships/additional/:id/:operation , который позволяет получить информацию "В цену включено" (operation=priceIncludes) корабля в текстовом формате с HTML.
07.06.2022
Метод /cities-departures , теперь возвращает список только тех городов из которых есть отправление активного круиза "по России и СНГ".
07.06.2022
Добавлен метод /ships-active аналогичный /ships, но он возвращает список только тех кораблей которые отчаливают в круиз в будущем.
07.06.2022
Добавлен метод /cities-departures аналогичный /cities, но он возвращает список только тех городов из которых есть отправление активного круиза.
07.06.2022
Добавлено поле moscow_time в обьект ship в метод /cruises/{id}.
Если moscow_time равно 1, то время возвращаемое методом /cruises/{id} указано московское. Иначе, местное.
06.06.2022
Как принято в речных круизах, время отправления и прибытия круиза теперь указывается по местному времени, в формате: YYYY-MM-DD HH:MM:SS без "T" и без часового пояся.
Раньше оно было по местному времени но указывалось как UTC по московскому времени +3 часа по Гринвичу, что было неправильно для других часовых поясов.
06.06.2022
К списку портов, /ports, добавлен фильтр, departurePorts, который возвращает список только тех портов с которых начинаются маршруты активных круизов (круизов с датой отправления в будущем).
Этот список доступен по ссылке: https://restapi.infoflot.com/ports/filter/departurePorts?key=XXXXXXXXX .
02.06.2022
Добавлены поля в метод /cruises/{id}:
- min_price_absolute, max_price_absolute - Минимальная/максимальная цена каюты в том числе и проданных (в отличии от min_price, max_price возвращающих только цены кают досупных для продажы).
11.05.2022
Добавлен метод /news отдающий список новостей и спецпредложений от компании Инфофлот
21.04.2022
В метод /cruises добавлен фильтр "Круиз выходного дня"
18.04.2022
В метод /cruises добавлен фильтр по популярным маршрутам
В метод /cruises добавлен фильтр по рекам/озерам/морям
22.06.2020
В метод /cruises добавлен фильтр по регионам
31.10.2019
В метод /cruises добавлена возможность сортировки результата по дате, цене и продолжительности круиза
24.10.2019
В метод /cruises добавлены фильтры по цене и валюте
19.09.2019
Добавлены методы /ports и /ports/{id}/ отдающие список портов и информацию по одному порту соответственно.
Добавлены методы /countries и /countries/{id}/ отдающие список стран и информацию по одной стране соответственно.
В метода /cruises добавлены новые фильтры days, nights, nightsMin, nightsMax, startCity, startCountry, portStart, portEnd, позволяющие детализировать выборку по продолжительности круиза в днях, ночах, городу отправления, стране отправления, портам отправления и прибытия.
11.09.2019
Из ответа метода /cruises убрано поле timetable. Для информации о круизном маршруте в списке круизов пользуйтесь полями route и routeShort. Подрбный круизный маршрут доступен только в методе /cruises/{id}
04.09.2019
В ответ методов /cruises и /cruises/{id} добавлено поле discountsText с текстовым описанием скидок на круизе
27.08.2019
В ответ методов /cruises и /cruises/{id} добавлены поля discounts - список скидок, доступных для круиза и maxDiscount - максимально возможная скидка на круизе для одного пассажира
27.08.2019
Обновлена документация по скидкам в методах /discounts и /discounts/{id}
24.06.2019
В ответ метода /ships/{id}/ добавлено поле schemes с массивом схем судна по дате их актуализации. Поле svgScheme сохранено для обратной совместимости и содержит URL схемы, актуальной на текущую дату.
17.05.2019
Добавлен метод /dashboard/{id}/ для онлайн-табло.
05.04.2019
В ответ метода/ships/{id}/ добавлено поле отзывы reviews.
04.04.2019
В ответ метода /cities/{id} добавлено поле photos. С 01.05.2019 из
С 01.05.2019 из метода /cities/{id} будет удалено поле photo, используйте поле photos
03.04.2019
В ответ методов /cruises и /cruises/{id} добавлено поле beautifulName
01.04.2019
В ответ методов /ships/ и /ships/{id}/ добавлено поле звездность теплохода stars.
В ответ метода /cruises/{id} в объект excursions добавлены поля timeStart, timeEnd и photos
29.03.2019
В ответ метода /ships/{id}/ добавлено поле features.
В ответ методов /ships/ и /ships/{id}/ добавлено поле слоган 2 tagline2.
В ответ метода /ships/{id}/ в объект cabins добавлено поле typeFriendlyName.
28.03.2019
В ответ методов /public-places/ и /public-places/{id}/ добавлено поле photo .
В ответ методов /ships/ и /ships/{id}/ добавлено поле typeName.
27.03.2019
Добавлены методы /public-places/ и /public-places/{id}/ .
В ответ метода /ships/{id}/ добавлен список общественных мест publicPlaces.
26.03.2019
В ответ методов /cruises и /cruises/{id} добавлены поля additional и important
В ответ метода /cities/{id} добавлены поля photo и description
В ответ метода /ships/{id}/ добавлено поле currentCruiseId
25.03.2019
Добавлены методы /onboard-services/ и /onboard-services/{id}/ .
В ответ метода /ships/{id}/ добавлен список услуг на борту onboardServices.
В ответ метода /ships/{id}/ добавлен объект координат coordinates.
В ответ метода /ships/{id}/ в объект project добавлено поле description
В ответ метода /ships/{id}/ добавлен объект соц.сетей social
В ответ метода /ships/{id}/ добавлено поле interestingFacts
В ответ метода /ships/{id}/ добавлено поле interestingFactsPhotos
В ответ методов /ships/ и /ships/{id}/ добавлено поле пассажировместимость capacity.
В ответ методов /ships/ и /ships/{id}/ добавлено поле SVG-схема svgScheme.
В ответ методов /ships/ и /ships/{id}/ добавлено поле слоган tagline.
11.02.2019
В ответ метода /ships/{id} в массив категорий кают cabinTypes добавлены альтернативные названия кают и информация о классе категории и наличии удобств.
16.01.2019
В ответ метода /ships/{id} добавлен массив категорий кают cabinTypes.
11.12.2018
В ответ метода /ships/{id} в массив cabins добавлены поля typeName и typeDescription - имя и описания типа категории каюты соответственно.
Исправлена ошибка в документации к /ships и /ships/{id}.
29.11.2018
В ответ метода /cruises/{id} добавлено поле photos с фотографиями круиза.
22.11.2018
В ответ методов /cruises и /cruises/{id} добавлено поле description, содержащее описание круиза.
20.11.2018
Важно! В методе /cruises изменился формат выдачи экскурсий в круизах. Теперь экскурсии передаютя отдельных массивом excursions, а в полях cruise.timetable.excursions находится массив идентификаторов экскурсий.
Добавлены новые фильтры для круизов /cruises: фильтр type позволяет выбрать только речные или только морские круизы, фильтры lengthMin и lengthMax ограничивают минимальную и максимальную продолжительность круиза в днях
Изменён фильтр ship для запроса круизов /cruises. Теперь можно выбрать несколько теплоходов, указав их идентификаторы через запятую.
12.11.2018
В ответ метода /cruises/{id}/cabins добавлено поле external_prices, содержащее информацию о возможных наценках на каюты.
В ответ методов /cruises и /cruises/{id} в объект Timetable добавлено поле excursions - экскурсии в точке на маршруте.
07.11.2018
Добавлены методы /requests и /requests/{id} для создания, просмотра и отмены заявок (бронирования).
08.10.2018
В ответ методов /ships и /ships/{id} добавлены поля 3dtour и video, содержащее ссылку на 3d-тур по теплоходу и видеопрезентацию теплохода соответственно.
03.10.2018
В ответ метода /ships/{id} добавлено поле photos с перечнем файлов фотографий теплохода или лайнера. Такое же поле photos добавлено для каждой каюты теплохода.
02.10.2018
В ответ методов /ships и /ships/{id} добавлено поле files, содержащее информацию о файлах, связанных с теплоходом или лайнером: фотографию, схему, флеш-схему, фото капитана.
20.09.2018
В ответ метода /cruises/{id}/cabins добавлено поле type_description, содержащее описание каюты.
12.09.2018
АПИ-ключ можно передавать как в заголовке x-api-key, так и параметром в строке запроса, например, cruises?key=XXXXXXXXX
11.09.2018
В ответ методов /cruises и /cruises/{id} добавлено поле include (услуги, включённые в стоимость круиза) и массив popularRoutes (список популярных маршрутов круиза)
04.09.2018
Добавлен справочник регионов (методы: /regions и /regions/{id})
В ответ методов /cruises и /cruises/{id} добавлены массивы rivers (список рек круиза) и regions (список регионов круиза)