Описание API

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

Для работы с API необходимо получить уникальный идентификатор пользователя (USERHASH). Работа с API организуется путём отправки HTTP-запросов на адрес https://booking.mosturflot.ru/api?language=ru, необходимые параметры передаются методом 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-06T14:11:22</createdate>
  <version>2.0.14</version>
  <status>1</status>
  <answer>
    <shipid>207</shipid>
    <shipname>Александр Грин</shipname>
    <shipown>1</shipown>
    <shipdesc><div>
	<div>
		<div>
			Теплоход &laquo;Александр Грин&raquo;(проект РV08) построен в 2012 году на Верфи братьев Нобель (г. Рыбинск) с использованием отдельных элементов корпуса судна австрийской постройки проекта Q-065.</div>

		<div>
			Проект PV08 разработан Морским инженерным бюро по заказу компании &laquo;Мостурфлот&raquo;.</div>

		<div>
			Теплоход &laquo;Александр Грин&raquo;&nbsp; сдан в эксплуатацию 9 июня 2012 года.</div>

		<div>
			Максимальная пассажировместимость теплохода 112 человек. Численность экипажа и обслуживающего персонала 78 человек.</div>

		<div>
			На теплоходе 56 комфортабельных кают, в которых имеются беспроводной Интернет (Wi-Fi),&nbsp;балкон, двуспальная кровать, большая туалетная комната с душевой кабиной, кондиционер, телевизор, фен, сейф, радио, электрическая розетка 220 В и 110В. Площадь &nbsp;кают от 14 до 24 кв. метров. Пассажирский лифт соединяет все палубы теплохода. Большая верхняя открытая палуба с шезлонгами служит для полноценного отдыха туристов. На главной палубе расположен ресторан, бар, парикмахерская, массажный салон, медпункт, комфортная зона приема &nbsp;гостей.</div>

		<div>
			Новые современные двигатели и оборудование, средства радионавигации, управления и автоматизации обеспечивают безопасную эксплуатацию судна в любых режимах, включая круизы по Ладожскому и Онежскому озерам. Судно соответствует повышенным стандартам экологической безопасности.</div>

		<div>
			Теплоход &laquo;Александр Грин&raquo; построен в &nbsp;рамках нового закона о поддержке отечественного судостроения и судоходства, направленного на предоставление льгот операторам рынка, участвующих в новом судостроении и регистрирующих суда под государственным флагом Российской федерации.</div>

		<div>
			ОАО &laquo;Московское речное пароходство&raquo; осуществило реализацию данного проекта по принципиально новой для судостроения схеме финансирования, с привлечением лизинговой компании &laquo;Гознак - лизинг&raquo;.</div>

		<div>
			&nbsp;</div>

		<div>
			Технические характеристики:</div>

		<div>
			&nbsp;</div>

		<div>
			Длина габаритная, м &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>
			Ширина габаритная, м &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>
			Осадка по КВЛ, м &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>
			Скорость, км/ч &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>
			Пассажировместимость, чел &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;112</div>

		<div>
			Класс Российского Речного Регистра &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp;М 3,0</div>

		<div>
			&nbsp;</div>

		<div>
			<strong><a href="https://my.matterport.com/show/?m=EjE6kTH9SyD" rel="nofollow"><span style="color:#FF0000">3D Тур по теплоходу Грин</span></a></strong></div>
	</div>
</div>

<div>
	&nbsp;</div>

<div>
	<div>
		<strong><a href="https://www.mosturflot.ru/wp-content/uploads/2022/05/sob_grin.jpg" target="_blank">Свидетельство о праве собственности на судно</a></strong></div>

	<div>
		<strong><a href="https://www.mosturflot.ru/wp-content/uploads/2022/05/sob_grin.jpg" target="_blank"><img alt="" src="https://www.mosturflot.ru/wp-content/uploads/2022/05/sob_grin.jpg" style="width:80px; height:113px" /></a></strong></div>
</div>

<div>
	&nbsp;</div>

<div>
	<div>
		<strong><a href="http://youtu.be/0zFgAvWBHws" rel="nofollow">Безопасность</a></strong></div>

	<div>
		&nbsp;</div>

	<div>
		<div>
			<strong><a href="https://www.mosturflot.ru/articles/meditsinskie-uslugi-na-bortu-2/" target="_blank">Медицинские услуги на борту</a></strong></div>
	</div>

	<div>
		&nbsp;</div>

	<div>
		<div>
			<strong><a href="https://www.mosturflot.ru/articles/pitanie-na-teplokhodakh-kompanii-mostu/" target="_blank">Питание на теплоходах компании &laquo;Мостурфлот&raquo;</a></strong></div>
	</div>

	<div>
		&nbsp;</div>

	<div>
		<strong><a href="http://tour.mosturflot.ru/tours/">Электронный каталог экскурсий </a></strong></div>

	<div>
		&nbsp;</div>

	<div>
		<strong><a href="https://www.mosturflot.ru/shipsonline/">Дислокация флота</a></strong></div>

	<div>
		&nbsp;</div>

	<div>
		<div>
			<strong><a href="https://www.mosturflot.ru/articles/pervyi-raz-v-kruiz-sovety-novichkam/" target="_blank">&quot;Первый раз в круиз? Наши советы:&quot;</a></strong></div>

		<div>
			&nbsp;</div>

		<div>
			<strong><a href="https://www.mosturflot.ru/articles/internet-na-bortu/" target="_blank">Wi-fi Интернет на борту.&nbsp;</a></strong><u><a href="https://www.mosturflot.ru/articles/internet-na-bortu/" target="_blank"><em>Условия платного и бесплатного предоставления услуги.</em></a></u></div>

		<div>
			&nbsp;</div>

		<div>
			<strong><a href="https://www.mosturflot.ru/articles/programmy-strakhovaniya/" target="_blank">Программа страхования</a></strong></div>

		<div>
			&nbsp;</div>
	</div>
</div>
</shipdesc>
    <shipclass>ЛЮКС</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-06T14:11:22',
  'version' => '2.0.14',
  'status' => 1,
  'answer' => 
  array (
    'shipid' => 207,
    'shipname' => 'Александр Грин',
    'shipown' => 1,
    'shipdesc' => '<div>
	<div>
		<div>
			Теплоход «Александр Грин»(проект РV08) построен в 2012 году на Верфи братьев Нобель (г. Рыбинск) с использованием отдельных элементов корпуса судна австрийской постройки проекта Q-065.</div>

<div>
			Проект PV08 разработан Морским инженерным бюро по заказу компании «Мостурфлот».</div>

<div>
			Теплоход «Александр Грин»  сдан в эксплуатацию 9 июня 2012 года.</div>

<div>
			Максимальная пассажировместимость теплохода 112 человек. Численность экипажа и обслуживающего персонала 78 человек.</div>

<div>
			На теплоходе 56 комфортабельных кают, в которых имеются беспроводной Интернет (Wi-Fi), балкон, двуспальная кровать, большая туалетная комната с душевой кабиной, кондиционер, телевизор, фен, сейф, радио, электрическая розетка 220 В и 110В. Площадь  кают от 14 до 24 кв. метров. Пассажирский лифт соединяет все палубы теплохода. Большая верхняя открытая палуба с шезлонгами служит для полноценного отдыха туристов. На главной палубе расположен ресторан, бар, парикмахерская, массажный салон, медпункт, комфортная зона приема  гостей.</div>

<div>
			Новые современные двигатели и оборудование, средства радионавигации, управления и автоматизации обеспечивают безопасную эксплуатацию судна в любых режимах, включая круизы по Ладожскому и Онежскому озерам. Судно соответствует повышенным стандартам экологической безопасности.</div>

<div>
			Теплоход «Александр Грин» построен в  рамках нового закона о поддержке отечественного судостроения и судоходства, направленного на предоставление льгот операторам рынка, участвующих в новом судостроении и регистрирующих суда под государственным флагом Российской федерации.</div>

<div>
			ОАО «Московское речное пароходство» осуществило реализацию данного проекта по принципиально новой для судостроения схеме финансирования, с привлечением лизинговой компании «Гознак - лизинг».</div>

<div>
			Технические характеристики:</div>

<div>
			Длина габаритная, м                                              90,10</div>

<div>
			Ширина габаритная, м                                            14,76</div>

<div>
			Осадка по КВЛ, м                                                    1,60</div>

<div>
			Скорость, км/ч                                                          20</div>

<div>
			Пассажировместимость, чел                                  112</div>

<div>
			Класс Российского Речного Регистра                     М 3,0</div>

<div>
			<strong><a href="https://my.matterport.com/show/?m=EjE6kTH9SyD" rel="nofollow"><span style="color:#FF0000">3D Тур по теплоходу Грин</span></a></strong></div>
	</div>
</div>

<div>
	<div>
		<strong><a href="https://www.mosturflot.ru/wp-content/uploads/2022/05/sob_grin.jpg" target="_blank">Свидетельство о праве собственности на судно</a></strong></div>

<div>
	<div>
		<strong><a href="http://youtu.be/0zFgAvWBHws" rel="nofollow">Безопасность</a></strong></div>

<div>
		<div>
			<strong><a href="https://www.mosturflot.ru/articles/meditsinskie-uslugi-na-bortu-2/" target="_blank">Медицинские услуги на борту</a></strong></div>
	</div>

<div>
		<div>
			<strong><a href="https://www.mosturflot.ru/articles/pitanie-na-teplokhodakh-kompanii-mostu/" target="_blank">Питание на теплоходах компании «Мостурфлот»</a></strong></div>
	</div>

<div>
		<strong><a href="http://tour.mosturflot.ru/tours/">Электронный каталог экскурсий </a></strong></div>

<div>
		<strong><a href="https://www.mosturflot.ru/shipsonline/">Дислокация флота</a></strong></div>

<div>
		<div>
			<strong><a href="https://www.mosturflot.ru/articles/pervyi-raz-v-kruiz-sovety-novichkam/" target="_blank">"Первый раз в круиз? Наши советы:"</a></strong></div>

<div>
			<strong><a href="https://www.mosturflot.ru/articles/internet-na-bortu/" target="_blank">Wi-fi Интернет на борту. </a></strong><u><a href="https://www.mosturflot.ru/articles/internet-na-bortu/" target="_blank"><em>Условия платного и бесплатного предоставления услуги.</em></a></u></div>

<div>
			<strong><a href="https://www.mosturflot.ru/articles/programmy-strakhovaniya/" target="_blank">Программа страхования</a></strong></div>

<div>
			 </div>
	</div>
</div>
',
    'shipclass' => 'ЛЮКС',
    '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 (
  ),
)