Описание 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 (формат можно выбрать, установив соответствующий глобальный параметр).

Банкетный флот - Информация о стоянке

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

Параметры

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

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

createdate - Дата и время создания ответа
- Тип: Дата и время, формат определяется значением глобального параметра DATETIME
- Обязательный: Да
version - Текущая версия API
- Тип: Строка
- Обязательный: Да
status - Результат выполнения запроса. -1 - Ошибка выполнения, 0 - Нет данных, 1 - Выполнен успешно.
- Тип: Целое число
- Обязательный: Да
answer - Ответ
- Тип: Набор данных
- Обязательный: Да
- pointid - ID стоянки
  - Тип: Строка
  - Обязательный: Да
- pointname - Название стоянки
  - Тип: Строка
  - Обязательный: Да
- cityid - ID города (населённого пункта)
  - Тип: Целое число
  - Обязательный: Да
- cityname - Название города (населённого пункта)
  - Тип: Строка
  - Обязательный: Да
- citytitleimage - Заглавная фотография города (населённого пункта).. URL изображения без указания протокола (http://).
  - Тип: Строка
  - Обязательный: Да
- federalsubjname - Название субъекта федерации
  - Тип: Строка
  - Обязательный: Да
- portshortname - Краткое название причала
  - Тип: Строка
  - Обязательный: Да
- portfullname - Полное название причала
  - Тип: Строка
  - Обязательный: Да
- portaddress - Адрес причала
  - Тип: Строка
  - Обязательный: Да
request - Запрос. Содержит массив принятых и использованных для выполнения запроса параметров.
- Тип: Массив данных
- Обязательный: Да
warnings - Предупреждения. Содержит массив предупреждений (если есть).
- Тип: Массив данных
- Обязательный: Да
errors - Ошибки. Содержит массив ошибок (если есть).
- Тип: Массив данных
- Обязательный: Да

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

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

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

<?xml version="1.0" encoding="utf-8"?>
<result>
  <createdate>2025-05-06T15:55:27</createdate>
  <version>2.0.14</version>
  <status>1</status>
  <answer>
    <pointid>105</pointid>
    <pointname>Бухта Радости</pointname>
    <cityid>105</cityid>
    <cityname>Бухта Радости</cityname>
    <citydesc><div>
	<div>
		&nbsp;</div>

	<div>
		&nbsp;</div>

	<div>
		Зона отдыха <strong>Бухта Радости </strong>расположена в 20 км от Москвы по Осташковскому шоссе (23 км по воде от Северного речного вокзала), на берегу Пироговского водохранилища.&nbsp;</div>

	<ul>
		<li>
			красивые лесные поляны</li>
		<li>
			открытые и закрытые беседки и шатры</li>
		<li>
			чистые песчаные и зеленые пляжи</li>
		<li>
			банька на воде</li>
		<li>
			плавучие дачи</li>
		<li>
			причалы и пирсы для водного транспорта</li>
		<li>
			охраняемый паркинг для автотранспорта.</li>
	</ul>
</div>
</citydesc>
    <citytitleimage>booking.mosturflot.ru/sites/default/files/mtf/images/43/68/39/29/43683929.jpg</citytitleimage>
    <federalsubjname></federalsubjname>
    <portshortname></portshortname>
    <portfullname></portfullname>
    <portaddress></portaddress>
  </answer>
  <request>
    <format>xml</format>
    <dateformat>msk</dateformat>
    <userhash>6ab4436ca3aeb1fcbb81a58a9f9d622baa400194</userhash>
    <section>banquetfleet</section>
    <request>port</request>
    <portid>105</portid>
    <images>0</images>
  </request>
  <errors/>
  <warnings/>
</result>

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

array (
  'createdate' => '2025-05-06T15:55:27',
  'version' => '2.0.14',
  'status' => 1,
  'answer' => 
  array (
    'pointid' => 105,
    'pointname' => 'Бухта Радости',
    'cityid' => 105,
    'cityname' => 'Бухта Радости',
    'citydesc' => '<div>
	<div>
		 </div>

<div>
		Зона отдыха <strong>Бухта Радости </strong>расположена в 20 км от Москвы по Осташковскому шоссе (23 км по воде от Северного речного вокзала), на берегу Пироговского водохранилища. </div>

<ul>
		<li>
			красивые лесные поляны</li>
		<li>
			открытые и закрытые беседки и шатры</li>
		<li>
			чистые песчаные и зеленые пляжи</li>
		<li>
			банька на воде</li>
		<li>
			плавучие дачи</li>
		<li>
			причалы и пирсы для водного транспорта</li>
		<li>
			охраняемый паркинг для автотранспорта.</li>
	</ul>
</div>
',
    'citytitleimage' => 'booking.mosturflot.ru/sites/default/files/mtf/images/43/68/39/29/43683929.jpg',
    'federalsubjname' => NULL,
    'portshortname' => NULL,
    'portfullname' => NULL,
    'portaddress' => NULL,
  ),
  'request' => 
  array (
    'format' => 'xml',
    'dateformat' => 'msk',
    'userhash' => '6ab4436ca3aeb1fcbb81a58a9f9d622baa400194',
    'section' => 'banquetfleet',
    'request' => 'port',
    'portid' => '105',
    'images' => 0,
  ),
  'errors' => 
  array (
  ),
  'warnings' => 
  array (
  ),
)