GET /cruises

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

Для загрузки всех круизов в вашу систему с листанием страиниц, надо обязательно указать константную dateStartFrom. Если её не указать, будет поиск круизов с датой отправления большей текущего времени, которое меняется от вызова к вызову, и при листании страниц некоторые круизы могут быть пропущены.

Запрос

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 - продолжительность по убыванию. Можно указать несколько параметров сортировки через запятую в порядке приоритета. Если указаны противоположные параметры (например, date-asc и date-desc), то первый будет исключать второй. По умолчанию результаты будут отсортированы по дате отправления.	date	sort=price-desc
ship	integer	Идентификатор теплохода или лайнера, можно указано несколько через запятую		ship=311 или 311,312,400
operator	integer	Идентификатор оператора, можно указано несколько через запятую		operator=256 или 256,64
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 - речной, (или riverAsOnMainSite, fromSochiAsOnMainSite, turkishRivieraAsOnMainSite, riverForeignAsOnMainSite, seaAsOnMainSite - разбиение на табы как на главном сайте)		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
rivers	integer	Идентификатор реки/озера/моря/водохранилица, можно указать несколько через запятую		rivers=8,51
popularRoutes	integer	Идентификатор популярного маршрута, можно указать несколько через запятую		popularRoutes=4,67
pointsInRoute	integer	Идентификатор точки на "Маршруте круиза" (поле 'route'), можно указать несколько через запятую. Новое. Используте вместо citiesInRoute, но id у них совсем разные.		pointsInRoute=14,12
citiesInRoute	integer	Идентификатор города в Графике Маршруте, можно указать несколько через запятую. Находит только круизы в будущем. У круизов "График Маршрута" иногда еще не введён, и такие круиза не находятся: используте новый pointsInRoute.		citiesInRoute=164,154
weekend	integer	Идентификатор круиза выходного дня		weekend=1
noVisa	integer	Только круизы для которых виза не нужна		noVisa=1
onlyFreeCabins	boolean	Показывает круизы только со свободными каютами		onlyFreeCabins=1
minFreeCabins	boolean	Показывает только круизы у которых minFreeCabins свободных кают		minFreeCabins=10
hasFreeSingle	boolean	Показывает только круизы у которых есть хотя бы одна свободная одноместная каюта		hasFreeSingle=1

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

Параметр	Тип	Описание
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	Красивое название
dateStart	datetime	Дата начала круиза
dateEnd	datetime	Дата окончания круиза
days	integer	Количество дней
nights	integer	Количество ночей
route	string	Маршрут круиза
routeShort	string	Сокращённая запись маршрута круиза
description	string	Описание круиза
routeBottomText	string	Текст под маршрутом
include	string	Включено в стоимость круиза
additional	string	Оплачивается отдельно
important	string	Важная информация
discountsText	string	Текстовое описание скидок
min_price	integer	Минимальная цена еще непроданной каюты. null если все каюты проданы.
max_price	integer	Максимальная цена еще непроданной каюты. null если все каюты проданы.
min_price_absolute	integer	Минимальная цена каюты (в том числе и проданных)
max_price_absolute	integer	Максимальная цена каюты (в том числе и проданных)
shipType	integer	Тип судна
currency	integer	Тип валюты теплохода (1 - рубли, 2 - доллары, 3 - евро)
rate	float	Курс валюты по отношению к рублю
rate_euro	float	Курс евро в рублях
freeCabins	integer	Количество свободных кают
hasFreeSingle	boolean	На этом круизе есть свободная одноместная каюта
dateStartTimestamp	timestamp	Дата начала круиза
portStart	integer	Индентификатор порта отправления
portEnd	integer	Индентификатор порта прибытия
dockStart	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	Минимальная цена каюты в рублях
min_price_euro	integer	Минимальная цена каюты в евро + 2% за конвертацию валюты
russian_squad	boolean	Наличие русской группы
russian_squad_title	array of string	Типы русских групп
noVisa	integer	false - нужна виза или нет неизвестно, true - виза точно не нужна
sug	array of CruiseSug	Массив скидок и акций
ship	object CruiseShip	Круизный теплоход или лайнер
discounts	array of CruiseDiscount	Скидки, доступные для круиза
maxDiscount	integer	Максимально возможная скидка для одного пассажира (в процентах
type	object CruiseType	Тип круиза
isSeaFormattedCabins	boolean	Если true (т.е. "морской"), то вместо freeCabins, cruises/{id}/cabins и /cruises/:id/cabins/search нужно использовать cruises/SeaCategories/{id}, /cruises/SeaCabins/:id.
rivers	array of River	Реки или моря, по которым проходит круизный маршрут
regions	array of Region	Регионы круиза
popularRoutes	array of PopularRoute	Популярные маршруты
cabinCapacity	object CruiseCabinCapacity	Информация о количестве свободных/забранированных кают
photos	array of CruisePhotos	Фотографии круиза
pointsInRoute	array of PointInRoute	Массив точкек на "Маршруте круиза" (поле 'route'). Используется для одноименного параметра поиска.
timetable	array of Timetable	Круизный маршрут Только в /cruise/:id!
oneWay	boolean	В одну сторону
oneMoreDayStop	boolean	С остановкой, длятельностью более одного дня
min_cabins_price	integer	Минимальная цена среди доступных кабин (со статусом 0) Только в /cruise/:id/cabins
max_cabins_price	integer	Максимальная цена среди доступных кабин (со статусом 0) Только в /cruise/:id/cabins

Объект 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	Идентификатор типа теплохода или лайнера ()
operatorId	integer	Идентификатор оператора
operatorName	string	Название (юридическое) оператора
operatorBrandName	string	Бренд оператора
moscow_time	boolean	Время круиза и Графика Маршрута указано московское
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	Описание

Объект PointInRoute

Параметр	Тип	Описание
id	integer	Идентификатор точки на "Маршруте Круиза"
name	string	Название точки
countryId	integer	Идентификатор страны где находится это точка (город)
countryName	integer	Идентификатор страны где находится это точка (город)
countryCode	integer	Идентификатор страны где находится это точка (город)
priority	integer	Приоритет точки

Объект Timetable

Параметр	Тип	Описание
id	integer	Идентификатор путевой точки круизного маршрута
cruiseId	integer	Идентификатор круиза
dateArrival	datetime	Дата и время прибытия в путевую точку
dateDeparture	datetime	Дата и время отправления из путевой точки
place	string	Название путевой точки
cityId	integer	Идентификатор города
port	integer	Идентификатор порта
description	string	Описание путевой точки
cityImages	array	Массив ссылок на фотографии города
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	Название города (английский язык)