25 лет Мультитур

API документация

Уважаемые коллеги! Мы очень ценим сотрудничество с Вами!
Для вашего удобства, максимальной автоматизации, увеличения Ваших продаж и для удобства Ваших туристов мы разработали API наших туров по всем направлениям с подробной технической документацией. С помощью данного API, вы можете выгружать с нашего сайта на свой сайт, абсолютно БЕСПЛАТНО, интересующие Вас туры по интересующим направлениям. Теперь Вам не нужно заниматься наполнением вашего сайта, т.к. данное API всю работу сделает за Вас!
Удачных Вам продаж и успешной работы!

Введение

Формат запроса

Запрос представляет из себя отправку данных методом POST на URL https://www.multitour.ru/api/v2/ Данные это данные упакованные в JSON (т.е. фактически данные типа «строка»).

Для запросов получите свой токен в разделе API-токены

Пример:
{
    "header" : {
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method":"Geo.Resort"
    },
    "request":{
        "country_id": 6228
    }
}
в оглавление

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

Ответ на запрос отсылается упакованным в JSON формат, при этом в ответе сохраняется секция header , а также полностью сохраняется секция request. Данные ответа располагаются в секции response.
Пример:
{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method":"Geo.Resort"
    },
    "request":{
        "country_id": 6228
    },
    "response":{
        /*..... данные ответа .....*/
    }
}
в оглавление

Формат ошибок

Ошибки располагаются в секции error. Если ошибок нет эта секция отсутствует
Пример ответа с ошибкой:
{
  "header": {
    "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
    "method": "Geo.Resort"
  },
  "request": {
    "country_id": "xxxx"
  },
  "response": {
    "options": null
  },
  "error": [
    "Некорректный идентификатор страны \u0022country_id\u0022 "
  ]
}
в оглавление

Справочники

Страны

Имя метода: Geo.Country
Параметры: отсутствуют
Пример запроса: показать/скрыть
Пример ответа: показать/скрыть
в оглавление

Регионы

Имя метода: Geo.Region
Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
country_id int да ID страны
Пример запроса: показать/скрыть
Пример ответа: показать/скрыть
в оглавление

Курорты

Имя метода: Geo.Resort
Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
country_id int да ID страны
Пример запроса: показать/скрыть
Пример ответа: показать/скрыть
в оглавление

Города

Имя метода: Geo.City
Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
country_id int да ID страны
region_id int нет ID региона
resort_id int нет ID курорта
Пример запроса: показать/скрыть
Пример ответа: показать/скрыть
в оглавление

Наименование локации

Имя метода: Geo.Name
Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
country_id int нет ID страны
city_id int нет ID города
region_id int нет ID региона
resort_id int нет ID курорта
Пример запроса: показать/скрыть
Пример ответа: показать/скрыть
в оглавление

Отели и цены

Отели

Имя метода: Hotel.Desc
Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
country_id int нет ID страны
region_id int нет ID региона
resort_id int нет ID курорта
city_id int нет ID города
hotel_id int нет ID отеля
limit int нет Кол-во записей, макс. 1000
offset int нет Смещение кол-ва записей
room_options object нет Опции номера
Пример запроса: показать/скрыть
Пример ответа: показать/скрыть
в оглавление

Питание

Имя метода: Hotel.Meals
Параметры: отсутствуют
Пример запроса: показать/скрыть
Пример ответа: показать/скрыть
в оглавление

Цены отелей

Имя метода: Hotel.Offers
Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
country_id int нет ID страны
region_id int нет ID региона
resort_id int нет ID курорта
city_id int нет ID города
hotel_id int нет ID отеля
quote bool нет Гарантированные места
date_begin date да Дата заезда
date_end date да Дата выезда
adult int да Кол-во взрослых
children int[] нет Возраста детей
meal_code string[] нет Типы питания
skip_hotel_ids int[] нет Исключить отели
limit int нет Лимит
Пример запроса: показать/скрыть
Пример ответа: показать/скрыть
в оглавление

Информация о предложении

Имя метода: Hotel.Offer
Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
id int да ID предложения
Пример запроса: показать/скрыть
Пример ответа: показать/скрыть
в оглавление

Квоты отелей

Имя метода: Hotel.Quotas
Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
hotel_id int да ID отеля
date_begin date да Дата от
date_end date да Дата до
Пример запроса: показать/скрыть
Пример ответа: показать/скрыть
в оглавление

Количество отелей

Имя метода: Hotel.Count
Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
country_id int нет ID страны
region_id int нет ID региона
resort_id int нет ID курорта
city_id int нет ID города
Пример запроса: показать/скрыть
Пример ответа: показать/скрыть
в оглавление

Листинг отелей

Имя метода: Hotel.Listing
Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
country_id int нет ID страны
region_id int нет ID региона
resort_id int нет ID курорта
city_id int нет ID города
limit int нет Кол-во записей, макс. 1000
offset int нет Смещение кол-ва записей
Пример запроса: показать/скрыть
Пример ответа: показать/скрыть
в оглавление

Тарифы

Имя метода: Hotel.Tariffs
Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
hotel_id int да ID отеля
Пример запроса: показать/скрыть
Пример ответа: показать/скрыть
в оглавление

Цены отелей

Имя метода: Hotel.OffersAtelica
Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
country_id int нет ID страны
region_id int нет ID региона
resort_id int нет ID курорта
city_id int нет ID города
hotel_id int нет ID отеля
quote bool нет Гарантированные места
date_begin date да Дата заезда
date_end date да Дата выезда
adult int да Кол-во взрослых
children int[] нет Возраста детей
meal_code string[] нет Типы питания
limit int нет Лимит
Пример запроса: показать/скрыть
Пример ответа: показать/скрыть
в оглавление

Экскурсии

Экскурсии

Имя метода: Excursion.Excursions
Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
country_id int нет ID страны
city_id int нет ID города
date date:d.m.Y да Начальная дата
date_to date:d.m.Y да Конечная дата
Пример запроса: показать/скрыть
Пример ответа: показать/скрыть
в оглавление

Предложения по экскурсии

Имя метода: Excursion.ExcursionOffers
Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
excursion_id int да ID экскурсии
Пример запроса: показать/скрыть
Пример ответа: показать/скрыть
в оглавление

В методе Excursion.ExcursionOffers цены на допместа ("accomodation_ex": "1") носят информационный характер и бронируются через менеджера.

Бронирование

Бронирование

Имя метода: Booking.Set
Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
offer string да ID офера
persons object[] да Туристы
last_name string да Фамилия
first_name string да Имя
middle_name string нет Отчество
birthday date да Дата рождения
passport_number string нет Номер паспорта
passport_date date нет Дата действия паспорта
phone string нет Телефон
sex string нет Пол
citizen string нет Гражданство
comment text нет Комментарий
Пример запроса: показать/скрыть
Пример ответа: показать/скрыть
в оглавление

Статус бронирования

Имя метода: Booking.Status
Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
code string да ID брони
Пример запроса: показать/скрыть
Пример ответа: показать/скрыть
в оглавление

Отмена бронирования

Имя метода: Booking.Cancel
Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
code string да ID брони
Пример запроса: показать/скрыть
Пример ответа: показать/скрыть
в оглавление