Описание API

Версия API 2.0.14, последнее изменение 06.05.2022 15:01 (MSK).

Для работы с API необходимо получить уникальный идентификатор пользователя (USERHASH). Работа с API организуется путём отправки HTTP-запросов на адрес https://booking.mosturflot.ru/api?language=en-US, необходимые параметры передаются методом GET, POST, либо путём загрузки XML-файла с параметрами запроса (в случае загрузки файла, его имя может быть любым, если загружено несколько файлов, будет обработан только первый из них). Обрабатываются только ожидаемые параметры, всё остальное игнорируется. Ответ предоставляется в формате XML либо JSON (формат можно выбрать, установив соответствующий глобальный параметр).

Речные круизы - Информация о теплоходе

Возвращает полные данные по конкретному теплоходу. Объём данных определяется параметрами запроса.

Параметры

shipid - ID теплохода. Определяет теплоход, по которому запрашиваются данные.
- Тип: Целое число
- Обязательный: Да
images - Фотографии теплохода. При установке в TRUE в ответ будут добавлены ссылки на фотографии теплохода.
- Тип: Логический
- Обязательный: Нет
- Значение по умолчанию: FALSE
cabins - Каюты теплохода. При установке в TRUE в ответ будут добавлены данные обо всех каютах теплохода. Если параметр IMAGES установлен в TRUE, также будут добавлены ссылки на фотографии кают.
- Тип: Логический
- Обязательный: Нет
- Значение по умолчанию: FALSE

Формат ответа

createdate - Дата и время создания ответа
- Тип: Дата и время, формат определяется значением глобального параметра DATETIME
- Обязательный: Да
version - Текущая версия API
- Тип: Строка
- Обязательный: Да
status - Результат выполнения запроса. -1 - Ошибка выполнения, 0 - Нет данных, 1 - Выполнен успешно.
- Тип: Целое число
- Обязательный: Да
answer - Ответ
- Тип: Набор данных
- Обязательный: Да
- shipid - ID теплохода
  - Тип: Целое число
  - Обязательный: Да
- shipname - Название теплохода
  - Тип: Строка
  - Обязательный: Да
- shipown - Признак собственности. TRUE - собственный теплоход ОАО "Мостурфлот".
  - Тип: Логический
  - Обязательный: Да
- shipdesc - Описание теплохода. Текст в формате HTML.
  - Тип: Строка
  - Обязательный: Да
- shipclass - Класс теплохода
  - Тип: Строка
  - Обязательный: Да
- shipdeckplan - План палуб теплохода. URL изображения без указания протокола (http://).
  - Тип: Строка
  - Обязательный: Да
- shiptitleimage - Заглавная фотография теплохода. URL изображения без указания протокола (http://).
  - Тип: Строка
  - Обязательный: Да
- shipcabinsqty - Общее число кают теплохода
  - Тип: Целое число
  - Обязательный: Да
- shiptoursqty - Число актуальных круизов теплохода в базе данных
  - Тип: Целое число
  - Обязательный: Да
- shiptourmindate - Дата начала самого раннего актуального круиза теплохода в базе данных
  - Тип: Дата и время, формат определяется значением глобального параметра DATETIME
  - Обязательный: Да
- shiptourmaxdate - Дата окончания самого позднего актуального круиза теплохода в базе данных
  - Тип: Дата и время, формат определяется значением глобального параметра DATETIME
  - Обязательный: Да
- shipimages - Массив фотографий теплохода. Присутствует при установке в TRUE параметра IMAGES.
  - Тип: Массив данных
  - Обязательный: Нет
  - item (элемент массива) - Данные о фотографии
    Тип: Набор данных
    
    Обязательный: Нет
    
    image - Полноразмерная фотография. URL изображения без указания протокола (http://).
    Тип: Строка
    
    Обязательный: Да
    
    thumb - Предпросмотр (thumbnail) фотографии. URL изображения без указания протокола (http://).
    Тип: Строка
    
    Обязательный: Да
    
    desc - Описание. Подпись к фотографии.
    Тип: Строка
    
    Обязательный: Да
    
    width - Ширина полноразмерной фотографии в пикселях
    Тип: Целое число
    
    Обязательный: Да
    
    height - Высота полноразмерной фотографии в пикселях
    Тип: Целое число
    
    Обязательный: Да
- shipcabins - Массив кают теплохода. Присутствует при установке в TRUE параметра CABINS.
  - Тип: Массив данных
  - Обязательный: Нет
  - item (элемент массива) - Данные о каюте
    Тип: Набор данных
    
    Обязательный: Нет
    
    cabinid - ID каюты
    Тип: Целое число
    
    Обязательный: Да
    
    cabinnumber - Номер каюты
    Тип: Целое число
    
    Обязательный: Да
    
    cabincategoryid - ID категории каюты
    Тип: Целое число
    
    Обязательный: Да
    
    cabincategoryname - Название категории каюты
    Тип: Строка
    
    Обязательный: Да
    
    cabinclass - Класс каюты
    Тип: Строка
    
    Обязательный: Да
    
    cabindesc - Описание каюты. Текст в формате HTML.
    Тип: Строка
    
    Обязательный: Да
    
    cabinmainpass - Число основных мест в каюте
    Тип: Целое число
    
    Обязательный: Да
    
    cabinupperpass - Число верхних мест в каюте
    Тип: Целое число
    
    Обязательный: Да
    
    cabinadvpass - Число дополнительных мест в каюте
    Тип: Целое число
    
    Обязательный: Да
    
    cabinmaxpass - Максимальная пассажировместимость каюты. CABINMAINPASS + CABINUPPERPASS + CABINADVPASS.
    Тип: Целое число
    
    Обязательный: Да
    
    cabinimages - Массив фотографий каюты. Присутствует при установке в TRUE параметра IMAGES.
    Тип: Массив данных
    
    Обязательный: Нет
    
    item (элемент массива) - Данные о фотографии
    Тип: Набор данных
    
    Обязательный: Нет
    
    image - Полноразмерная фотография. URL изображения без указания протокола (http://).
    Тип: Строка
    
    Обязательный: Да
    
    thumb - Предпросмотр (thumbnail) фотографии. URL изображения без указания протокола (http://).
    Тип: Строка
    
    Обязательный: Да
    
    desc - Описание. Подпись к фотографии.
    Тип: Строка
    
    Обязательный: Да
    
    width - Ширина полноразмерной фотографии в пикселях
    Тип: Целое число
    
    Обязательный: Да
    
    height - Высота полноразмерной фотографии в пикселях
    Тип: Целое число
    
    Обязательный: Да
request - Запрос. Содержит массив принятых и использованных для выполнения запроса параметров.
- Тип: Массив данных
- Обязательный: Да
warnings - Предупреждения. Содержит массив предупреждений (если есть).
- Тип: Массив данных
- Обязательный: Да
errors - Ошибки. Содержит массив ошибок (если есть).
- Тип: Массив данных
- Обязательный: Да

Пример GET-запроса

Пример XML-запроса

Пример XML ответа

<?xml version="1.0" encoding="utf-8"?>
<result>
  <createdate>2025-05-06T15:17:17</createdate>
  <version>2.0.14</version>
  <status>1</status>
  <answer>
    <shipid>207</shipid>
    <shipname>Alexander Grin</shipname>
    <shipown>1</shipown>
    <shipdesc><div>
	<div>
		<div>
			<div>
				MV Alexander Grin (project PV 08) was built in 2012 by the Nobel Brothers Shipyard (Rybinsk), using individual body elements of the Austrian vessel project Q-065.</div>

			<div>
				Project PV08 was designed by the Marine Engineering Bureau on commission from the company Mosturflot.</div>

			<div>
				MV Alexander Grin was put into operation on June 9, 2012.</div>

			<div>
				The maximum passenger capacity of the ship is 112 people. The number of crew and maintenance staff is 78 people.</div>

			<div>
				On the ship, there are 56 comfortable cabins, each of which has a balcony, a double bed, a large bathroom with a shower, air conditioning, satellite TV, a hairdryer, a safe, a radio, an electrical outlet with 220 V and 110 V connections, internal and external telephone, Wi-Fi, as well as satellite television and internet. The area of the cabins is between 14 and 24 square meters. An elevator connects all the decks of the ship. A large upper outdoor deck with lounge chairs provides recreation for the tourists. On the main deck there is a restaurant, bar, hair salon, massage parlor, medical center, and a comfortable reception area.</div>

			<div>
				New, modern engines, equipment, and techniques for navigation, control and automation ensure safe use of the vessel in all conditions, including cruises on the Ladoga and Onega lakes. The ship meets high environmental standards.</div>

			<div>
				&nbsp;</div>

			<div>
				Specifications:</div>

			<div>
				&nbsp;</div>

			<div>
				Length overall, m&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 90.10</div>

			<div>
				Width overall, m&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 14.76</div>

			<div>
				Draft at design waterline, m&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;1.60</div>

			<div>
				Speed, km/h&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 20</div>

			<div>
				Passenger capacity, pers.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 112</div>

			<div>
				Russian River Register class&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; M 3.0</div>

			<div>
				&nbsp;</div>

			<div>
				<a href="http://mosturflot.ru/media/pdf/sv-vo_grin.pdf"><strong>The certificate of ownership of the ship</strong></a></div>

			<div>
				&nbsp;</div>

			<div>
				<a href="http://youtu.be/0zFgAvWBHws" rel="nofollow"><strong>Security</strong></a></div>

			<div>
				&nbsp;</div>

			<div>
				<a href="https://www.mosturflot.ru/articles/30222/"><strong>Medical Services on board</strong></a></div>

			<div>
				&nbsp;</div>

			<div>
				<a href="http://tour.mosturflot.ru/tours/"><strong>Electronic catalog of excursions</strong></a></div>

			<div>
				&nbsp;</div>

			<div>
				<div>
					<strong><a href="https://www.mosturflot.ru/shipsonline/">Fleet Deployment</a></strong></div>
			</div>
		</div>
	</div>
</div>

<div>
	<div>
		&nbsp;</div>
</div>
</shipdesc>
    <shipclass>LUXE</shipclass>
    <shipdeckplan>booking.mosturflot.ru/rivercruises/ships/207/deckplan</shipdeckplan>
    <shiptitleimage>booking.mosturflot.ru/sites/default/files/mtf/photo/97/c4/fd/97c4fd7ae37f32110b3305e280981def.jpg</shiptitleimage>
    <shipcabinsqty>57</shipcabinsqty>
    <shiptoursqty>0</shiptoursqty>
    <shiptourmindate></shiptourmindate>
    <shiptourmaxdate></shiptourmaxdate>
  </answer>
  <request>
    <format>xml</format>
    <dateformat>msk</dateformat>
    <userhash>6ab4436ca3aeb1fcbb81a58a9f9d622baa400194</userhash>
    <section>rivercruises</section>
    <request>ship</request>
    <shipid>207</shipid>
    <images>0</images>
    <cabins>0</cabins>
  </request>
  <errors/>
  <warnings/>
</result>

Пример JSON ответа (преобразован в массив)

array (
  'createdate' => '2025-05-06T15:17:17',
  'version' => '2.0.14',
  'status' => 1,
  'answer' => 
  array (
    'shipid' => 207,
    'shipname' => 'Alexander Grin',
    'shipown' => 1,
    'shipdesc' => '<div>
	<div>
		<div>
			<div>
				MV Alexander Grin (project PV 08) was built in 2012 by the Nobel Brothers Shipyard (Rybinsk), using individual body elements of the Austrian vessel project Q-065.</div>

<div>
				Project PV08 was designed by the Marine Engineering Bureau on commission from the company Mosturflot.</div>

<div>
				MV Alexander Grin was put into operation on June 9, 2012.</div>

<div>
				The maximum passenger capacity of the ship is 112 people. The number of crew and maintenance staff is 78 people.</div>

<div>
				On the ship, there are 56 comfortable cabins, each of which has a balcony, a double bed, a large bathroom with a shower, air conditioning, satellite TV, a hairdryer, a safe, a radio, an electrical outlet with 220 V and 110 V connections, internal and external telephone, Wi-Fi, as well as satellite television and internet. The area of the cabins is between 14 and 24 square meters. An elevator connects all the decks of the ship. A large upper outdoor deck with lounge chairs provides recreation for the tourists. On the main deck there is a restaurant, bar, hair salon, massage parlor, medical center, and a comfortable reception area.</div>

<div>
				New, modern engines, equipment, and techniques for navigation, control and automation ensure safe use of the vessel in all conditions, including cruises on the Ladoga and Onega lakes. The ship meets high environmental standards.</div>

<div>
				Specifications:</div>

<div>
				Length overall, m                                                 90.10</div>

<div>
				Width overall, m                                                    14.76</div>

<div>
				Draft at design waterline, m                              1.60</div>

<div>
				Speed, km/h                                                            20</div>

<div>
				Passenger capacity, pers.                                       112</div>

<div>
				Russian River Register class                                  M 3.0</div>

<div>
				<a href="http://mosturflot.ru/media/pdf/sv-vo_grin.pdf"><strong>The certificate of ownership of the ship</strong></a></div>

<div>
				<a href="http://youtu.be/0zFgAvWBHws" rel="nofollow"><strong>Security</strong></a></div>

<div>
				<a href="https://www.mosturflot.ru/articles/30222/"><strong>Medical Services on board</strong></a></div>

<div>
				<a href="http://tour.mosturflot.ru/tours/"><strong>Electronic catalog of excursions</strong></a></div>

<div>
				<div>
					<strong><a href="https://www.mosturflot.ru/shipsonline/">Fleet Deployment</a></strong></div>
			</div>
		</div>
	</div>
</div>

<div>
	<div>
		 </div>
</div>
',
    'shipclass' => 'LUXE',
    'shipdeckplan' => 'booking.mosturflot.ru/rivercruises/ships/207/deckplan',
    'shiptitleimage' => 'booking.mosturflot.ru/sites/default/files/mtf/photo/97/c4/fd/97c4fd7ae37f32110b3305e280981def.jpg',
    'shipcabinsqty' => 57,
    'shiptoursqty' => 0,
    'shiptourmindate' => false,
    'shiptourmaxdate' => false,
  ),
  'request' => 
  array (
    'format' => 'xml',
    'dateformat' => 'msk',
    'userhash' => '6ab4436ca3aeb1fcbb81a58a9f9d622baa400194',
    'section' => 'rivercruises',
    'request' => 'ship',
    'shipid' => 207,
    'images' => 0,
    'cabins' => 0,
  ),
  'errors' => 
  array (
  ),
  'warnings' => 
  array (
  ),
)