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

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

Методы АПИ

Города
Город
cruises
Круизы
Круиз
Статусы кают в круизе
Подбор кают для пассажиров и расчет стоимости
Скидки
Скидка
Правила применения скидок
Услуги на борту
Услуга на борту
Общественные места
Общественное место
Реки
Река
Порты
Порт
Страны
Страна
Регионы
Регион
Теплоходы и лайнеры
Теплоход или лайнер
Популярные маршруты
Популярный маршрут
Заявки и бронирование
Заявка

GET /cruises

Возвращает постраничный список круизов

Запрос

GET https://restapi.infoflot.com/cruises

Параметры в строке запроса

ПараметрТипОписаниеПо умолчаниюПример
limit integer Количество круизов в выборке 100 limit=20
page integer Страница выборки 1 page=5
sort string, enum Сортировка результата: date (date-asc) - по дате по возрастанию, date-desc - по дате по убыванию, price (price-asc) - по цене по возрастанию, price-desc - по цене по убыванию, length (length-asc) - продолжительность по возрастанию, length-desc - продолжительность по убыванию.

Сортировка по цене работает только с фильтром по валюте (currency)

Можно указать несколько параметров сортировки через запятую в порядке приоритета. Если указаны противоположные параметры (например, date-asc и date-desc), то первый будет исключать второй.
date sort=price-desc
ship integer Идентификатор теплохода или лайнера, можно указано несколько через запятую ship=311 или 311,312,400
dateStartFrom date Начало диапазона дат начала круиза в формате ГГГГ-ММ-ДД dateStartFrom=2018-06-01
dateStartTo date Конец диапазона дат начала круиза в формате ГГГГ-ММ-ДД dateStartTo=2018-09-01
dateEndFrom date Начало диапазона дат окончания круиза в формате ГГГГ-ММ-ДД dateEndFrom=2018-07-01
dateEndTo date Начало диапазона дат начала круиза в формате ГГГГ-ММ-ДД dateEndTo=2018-08-01
type string, enum Тип круиза: sea - морской, river - речной type=sea
lengthMin integer Минимальная длина круиза в днях lengthMin=5
lengthMax integer Максимальная длина круиза в днях lengthMax=10
nightsMin integer Минимальная длина круиза в ночах nightsMin=5
nightsMax integer Максимальная длина круиза в ночах nightsMax=10
days integer Длина круиза в днях (строгое равенство), можно несколько вариантов через запятую days=7,11
nights integer Длина круиза в ночах (строгое равенство), можно несколько вариантов через запятую nights=12
startCity integer Город отправления, можно несколько вариантов через запятую startCity=12
startCountry integer Страна отправления, можно несколько вариантов через запятую startCountry=12
portStart integer Порт отправления, можно несколько вариантов через запятую portStart=12
portEnd integer Порт прибытия, можно несколько вариантов через запятую portEnd=12
currency integer Валюта круиза (1 - российский рубль, 2 - доллар США, 3 - евро, 4 - фунт стерлингов currency=1
minPriceFrom integer Начало диапазона минимальной цены. Не применяется без currency minPriceFrom=10000
minPriceTo integer Конец диапазона минимальной цены. Не применяется без currency minPriceTo=50000
maxPriceFrom integer Начало диапазона максимальной цены. Не применяется без currency maxPriceFrom=40000
maxPriceTo integer Конец диапазона минимальной цены. Не применяется без currency maxPriceTo=80000
regions integer Идентификатор региона, можно указано несколько через запятую regions=2,11

Параметры ответа

ПараметрТипОписание
filter object Фильтры, использованные в запросе в формате ключ-значение с типом, соответствующим параметру командной строки запроса
pagination object Pagination Количество записей и пагнация
data array of Cruise Круизы
excursions array of Excursion Экскурсии

Объект Pagination

ПараметрТипОписание
pages object Pages Данные о страницах ответа
records object Records Данные о записях ответа

Объект Pages

ПараметрТипОписание
total integer Количество страниц в выборке
current object Page Текущая страница
next object Page Следующая страница
previous object Page Предыдущая страница

Объект Page

ПараметрТипОписание
number integer Номер страницы
url integer Относительный URL страницы

Объект Records

ПараметрТипОписание
total integer Общее количество записей в выборке
onCurrentPage integer Количество записей на текущей странице выборки
perPage integer Количество записей в на странице выборки

Объект Cruise

ПараметрТипОписание
id integer Идентификатор круиза
name string Название круиза
beautifulName string Красивое название
cruisePopular boolean Популярный круиз
dateStart datetime Дата начала круиза
dateEnd datetime Дата окончания круиза
days integer Количество дней
nights integer Количество ночей
route string Маршрут круиза
routeShort string Сокращённая запись маршрута круиза
region string Регион круиза (для обратной совместимости)
river string Река или море, по которой проходит основная часть круизного маршрута (для обратной совместимости)
description string Описание круиза
routeAboveText string Текст над маршрутом
routeBottomText string Текст под маршрутом
include string Включено в стоимость круиза
additional string Оплачивается отдельно
important string Важная информация
discountsText string Текстовое описание скидок
min_price integer Минимальная цена каюты
max_price integer Максимальная цена каюты
shipType integer Тип судна
currency integer Тип валюты теплохода (1 - рубли, 2 - доллары, 3 - евро
rate float Курс валюты по отношению к рублю
freeCabins integer Количество свободных кают
dateStartTimestamp timestamp Дата начала круиза
portStart integer Индентификатор порта отправления
portEnd integer Индентификатор порта прибытия
weekend integer Круиз выходного дня? (1 - да, 0 - нет)
notesExcursions string Примечания к экскурсиям
startCity integer Индентификатор города отправления
startCityName string Название города отправления
startCityNameEn string Английское название города отправления
startCityCountry integer Индентификатор страны отправления
timetableDoc string Расписание круиза в формате doc
timetablePdf string Расписание круиза в формате pdf
map string Ссылка на карту круиза
prices array of CruisePrices Цены круиза
min_price_rur integer Минимальная цена каюты в рублях
russian_squad boolean Наличие русской группы
russian_squad_title array of string Типы русских групп
sug array of CruiseSug Массив скидок и акций
ship object CruiseShip Круизный теплоход или лайнер
discounts array of CruiseDiscount Скидки, доступные для круиза
maxDiscount integer Максимально возможная скидка для одного пассажира (в процентах
type object CruiseType Тип круиза
rivers array of River Реки или моря, по которым проходит круизный маршрут
regions array of Region Регионы круиза
popularRoutes array of PopularRoute Популярные маршруты
cabinCapacity object CruiseCabinCapacity Информация о количестве свободных/забранированных кают
photos array of CruisePhotos Фотографии круиза
timetable array of Timetable Круизный маршрут Только в /cruise/:id!
oneWay boolean В одну сторону
oneMoreDayStop boolean С остановкой, длятельностью более одного дня

Объект CruisePrices

ПараметрТипОписание
min integer Минимальная цена круиза
infoflotBonus integer Х1
old integer Х2
bsoz Х3

Объект CruiseSug

ПараметрТипОписание
id integer Идентификатор скидки/акции
type integer Тип скидки/акции ()
title string Название скидки/акции
descr string Описание скидки/акции
icon string Ссылка на иконку (изображение) для скидки/акции

Объект CruiseShip

ПараметрТипОписание
id integer Идентификатор теплохода или лайнера
name string Название теплохода
type integer Идентификатор типа теплохода или лайнера ()
decks array of CruiseDeck Палубы
cabins array of Cabin Каюты

Объект CruiseDeck

ПараметрТипОписание
id integer Идентификатор палубы
name string Название палубы
position integer Номер палубы

Объект Cabin

ПараметрТипОписание
id integer Идентификатор каюты
deck integer Идентификатор палубы, на которой находится каюта
name string Название каюты
photos object ShipPhotos Фотографии

Объект ShipPhotos

ПараметрТипОписание
position integer Порядок сортировки
filename string Наименование файла
filetype string Тип файла
filesize string Размер файла
description string Описание

Объект CruiseDiscount

ПараметрТипОписание
type object CruiseDiscountType Тип скидки
values array of CruiseDiscountValue Значения скидки

Объект CruiseDiscountType

ПараметрТипОписание
id integer Идентификатор типа скидки
name string Наименование типа скидки

Объект CruiseDiscountValue

ПараметрТипОписание
id integer Идентификатор скидки
timeStart datetime Время начала действия скидки (время бронирования)
timeEnd datetime Время окончания действия скидки (время бронирования)
amount integer Размер скидки (в процентах
gender integer Пол пассажира (0 - без ограничений, 1 - мужской, 2 - женский)

Объект CruiseType

ПараметрТипОписание
id integer Идентификатор типа
name string Название типа

Объект River

ПараметрТипОписание
id integer Идентификатор реки
name string Название реки

Объект Region

ПараметрТипОписание
id integer Идентификатор региона
name string Название региона

Объект PopularRoute

ПараметрТипОписание
id integer Идентификатор популярного маршрута
name string Название популярного маршрута

Объект CruiseCabinCapacity

ПараметрТипОписание
total integer Общее количество кают
busy integer Количество забронированных кают
free integer Количество свободных кают

Объект CruisePhotos

ПараметрТипОписание
position integer Порядок сортировки
filename string Наименование файла
filetype string Тип файла
filesize string Размер файла
description string Описание

Объект Timetable

ПараметрТипОписание
id integer Идентификатор путевой точки круизного маршрута
cruiseId integer Идентификатор круиза
dateArrival datetime Дата и время прибытия в путевую точку
dateDeparture datetime Дата и время отправления из путевой точки
place string Название путевой точки
cityId integer Идентификатор города
port integer Идентификатор порта
description string Описание путевой точки
excursions array of Excursion / array of integer Экскурсии (для /cruise/:id) или массив идентификаторов экскурсий (для /cruise)
city object City Город
hideDate boolean Флаг скрытия даты
hideTime boolean Флаг скрытия времени

Объект Excursion

ПараметрТипОписание
id integer Идентификатор экскурсии
name string Название экскурсии
description string Описание экскурсии
length integer Продолжительность в часах
minimumPeople integer Минимальное количество людей для экскурсии
priceAdult integer Стоимость для взрослого в валюте priceAdultCurrency
priceAdultCurrency integer Валюта стоимости для взрослого (1 - рубль, 2- доллар, 3 - евро)
priceChild integer Стоимость для ребёнка в валюте priceChildCurrency
priceChildCurrency integer Валюта стоимости для ребёнка (1 - рубль, 2- доллар, 3 - евро)
included boolead Включена ли экскурсия в стоимость
photos array Массив ссылок на фотографии экскурсии
hasTranslate Есть переводчик
timeStart string Время начала экскурсии
timeEnd string Время окончания экскурсии
date Дата проведения
images array of ExcursionPhotos Массив ссылок на фотографии экскурсии

Объект ExcursionPhotos

ПараметрТипОписание
position integer Порядок сортировки
filename string Наименование файла
filetype string Тип файла
description string Описание

Объект City

ПараметрТипОписание
id integer Идентификатор города
name string Название города
name_en string Название города (английский язык)