Вход/Регистрация

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 курорта
Пример запроса: показать/скрыть
Пример ответа: показать/скрыть
в оглавление

Отели и цены

Отели

Имя метода: 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 нет Смещение кол-ва записей
Пример запроса: показать/скрыть
Пример ответа: показать/скрыть
в оглавление

Питание

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

Цены отелей

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

Квоты отелей

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

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

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

Имя метода: 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 нет Телефон
comment text нет Комментарий
Пример запроса: показать/скрыть
Пример ответа: показать/скрыть
в оглавление

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

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

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

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