агентствам +7 (495) 009-009-1

туристам +7 (499) 681-61-08

Зарегистрировать свой отель

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

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

Параметры: отсутствуют

Пример запроса: показать/скрыть

{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "Geo.Country"
    },
    "request": {}
}

Пример ответа: показать/скрыть

{
    "header": {
        "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "Geo.Country"
    },
    "response": [
            {
                "id": 81,
                "name": "Азербайджан"
            },
            {
                "id": 245,
                "name": "Армения"
            },
            {
                "id": 248,
                "name": "Беларусь"
            },
            ...
        ]
}

в оглавление

Регионы

Имя метода: Geo.Region

Параметры:

Параметр	Тип	Обязательный	по умолчанию	Комментарий
country_id	int	да		ID страны

Пример запроса: показать/скрыть

{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "Geo.Region"
    },
    "request": {
            "country_id": 3159
        }
}

Пример ответа: показать/скрыть

{
    "header": {
        "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "Geo.Region"
    },
    "response": [
            {
                "id": 3371,
                "name": "Брянская обл."
            },
            {
                "id": 3437,
                "name": "Владимирская обл."
            },
            {
                "id": 3503,
                "name": "Вологодская обл."
            },
            ...
        ]
}

в оглавление

Курорты

Имя метода: Geo.Resort

Параметры:

Параметр	Тип	Обязательный	по умолчанию	Комментарий
country_id	int	да		ID страны

Пример запроса: показать/скрыть

{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "Geo.Resort"
    },
    "request": {
            "country_id": 3159
        }
}

Пример ответа: показать/скрыть

{
    "header": {
        "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "Geo.Resort"
    },
    "response": [
            {
                "id": 10,
                "name": "Байкал"
            },
            {
                "id": 11,
                "name": "КавМинВоды"
            },
            {
                "id": 12,
                "name": "Калининградская обл."
            },
            ...
        ]
}

в оглавление

Города

Имя метода: Geo.City

Параметры:

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

Пример запроса: показать/скрыть

{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "Geo.City"
    },
    "request": {
            "country_id": 3159
        }
}

Пример ответа: показать/скрыть

{
    "header": {
        "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "Geo.City"
    },
    "response": [
            {
                "id": 3372,
                "name": "Алтухово",
                "resort_id": 16,
                "resort_name": "Средняя полоса",
                "region_id": 3371,
                "region_name": "Брянская обл."
            },
            {
                "id": 3373,
                "name": "Белая Березка",
                "resort_id": 16,
                "resort_name": "Средняя полоса",
                "region_id": 3371,
                "region_name": "Брянская обл."
            },
            {
                "id": 3374,
                "name": "Белые Берега",
                "resort_id": 16,
                "resort_name": "Средняя полоса",
                "region_id": 3371,
                "region_name": "Брянская обл."
            },
            ...
        ]
}

в оглавление

Отели и цены

Отели

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

Пример запроса: показать/скрыть

{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "Hotel.Desc"
    },
    "request": {
            "country_id": 3159,
            "resort_id": 16,
            "limit": 100,
            "offset": 0
        }
}

Пример ответа: показать/скрыть

{
    "header": {
        "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "Hotel.Desc"
    },
    "response": [
            {
                "id": 4976,
                "name": "Волга",
                "type": "пансионат",
                "url": "https://www.multitour.ru/hotel/rossiya/nizhegorodskaya-oblast/volga",
                "address": "Россия, Нижегородская область, Балахнинский район, пос. Лукино, пансионат "Волга"",
                "geo": {
                    "country_id": [
                        3159
                    ],
                    "region_id": [
                        3784
                    ],
                    "resort_id": [
                        15,
                        16
                    ],
                    "city_id": [
                        3814
                    ],
                    "lat": 56.6819,
                    "lng": 36.3942
                },
                "desc": {
                    "Внимание": "<h4>Питание</h4>\n<p>Информация о типе питания, включенном в стоимость, указана в деталях тарифа.</p>\n<h4>Размещение с детьми и информация о дополнительных кроватях</h4>\n<p>Количество дополнительных кроватей зависит от категории номера. Необходимо ознакомиться с информацией о вместимости выбранного номера.</p>\n"
                },
                "images": [
                    "https://www.multitour.ru/files/imgs/hotel_500034_4eea36cded9d5f5f81ef40dbfb1c6f94.JPG",
                    "https://www.multitour.ru/files/imgs/hotel_500034_e1f5cadcca1ca231ab2371234b04f170.JPG",
                    "https://www.multitour.ru/files/imgs/hotel_500034_d6c27cc9002ea304ce67e8bf85227954.JPG"
                ]
            },
            {
                "id": 6901,
                "name": "Октябрьская",
                "type": "гостиница",
                "url": "https://www.multitour.ru/hotel/hotel_6901",
                "address": "Нижний Новгород, Верхневолжская наб., д.9а",
                "geo": {
                    "country_id": [
                        3159
                    ],
                    "region_id": [
                        3784
                    ],
                    "resort_id": [
                        15,
                        16
                    ],
                    "city_id": [
                        3814
                    ],
                    "lat": 56.6819,
                    "lng": 36.3942
                },
                "desc": {
                    "Душ": "Да",
                    "Кондиционер": "Да",
                    "Сейф": "Да",
                    "Фен": "Да",
                    "Холодильник": "Да",
                    "Дети": "Размещение подходит для семей/детей, Детские телеканалы",
                    "Питание": "Микроволновая печь, Кофемашина, Бутилированная вода",
                    "Парковка": "Да"
                }, 
                "images": []
            }
        ]
}

в оглавление

Питание

Имя метода: Hotel.Meals

Параметры: отсутствуют

Пример запроса: показать/скрыть

{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "Hotel.Meals"
    },
    "request": {}
}

Пример ответа: показать/скрыть

{
    "header": {
        "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "Hotel.Meals"
    },
    "response": [
            {
                "id": 4,
                "name": "без питания",
            },
            {
                "id": 5,
                "name": "завтрак",
            },
            {
                "id": 6,
                "name": "завтрак «шведский стол»",
            },
            ...
        ]
}

в оглавление

Цены отелей

Имя метода: 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[]	нет		Возраста детей

Пример запроса: показать/скрыть

{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "Hotel.Offers"
    },
    "request": {
            "city_id": 4094,
            "date_begin": "2020-06-20",
            "date_end": "2020-06-27",
            "adult": 2,
            "children": [3, 8]
        }
}

Пример ответа: показать/скрыть

{
    "header": {
        "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "Hotel.Offers"
    },
    "response": [
            {
                "id": "YSY3Ig.19900120062007000",
                "hotel_id": 7095,
                "price": 129500,
                "currency": "RUB",
                "acc_name": "2 взр+1 доп (3-11)+1 доп (12-99)",
                "room_name": "2-х местный полулюкс, корпус 1",
                "meal_name": "3-х разовое питание",
                "tariff_name": "С лечением",
                "date_begin": "2020-06-20",
                "date_end": "2020-06-27",
                "nights": 7,
                "quote": 0,
                "commission": 10,
                "cancellation_info": [  // "cancellation_info": null - Без штрафа (тогда штраф при аннуляции не начисляется)
                    {
                        "days": 5,      // Дата наступления штрафа (кол-во дней до заезда)
                                        // "days": null - Невозвратный (при аннуляции штраф 100%)
                        "penalty": 18800
                    },
                    {
                        "days": 10,
                        "penalty": 9800
                    }
                ]
            },
            {
                "id": "YSY3Ig.19900220062007000",
                "hotel_id": 7095,
                "price": 131600,
                "currency": "RUB",
                "acc_name": "2 взр+2 доп (12-99)",
                "room_name": "2-х местный полулюкс, корпус 1",
                "meal_name": "3-х разовое питание",
                "tariff_name": "С лечением",
                "date_begin": "2020-06-20",
                "date_end": "2020-06-27",
                "nights": 7,
                "quote": 0,
                "commission": 10,
                "cancellation_info": [
                    {
                        "days": null,
                        "penalty": 131600
                    }
                ]
            }
        ]
}

в оглавление

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

Имя метода: Hotel.Offer

Параметры:

Параметр	Тип	Обязательный	по умолчанию	Комментарий
id	int	да		ID предложения

Пример запроса: показать/скрыть

{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "Hotel.Offer"
    },
    "request": {
            "id": "YSY3Ig.19900120062007000"
        }
}

Пример ответа: показать/скрыть

{
    "header": {
        "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "Hotel.Offer"
    },
    "response": [
            {
                "id": "YSY3Ig.19900120062007000",
                "hotel_id": 7095,
                "price": 129500,
                "currency": "RUB",
                "acc_name": "2 взр+1 доп (3-11)+1 доп (12-99)",
                "room_name": "2-х местный полулюкс, корпус 1",
                "meal_name": "3-х разовое питание",
                "tariff_name": "С лечением",
                "date_begin": "2020-06-20",
                "date_end": "2020-06-27",
                "nights": 7,
                "quote": 0,
                "commission": 10,
                "cancellation_info": [  // "cancellation_info": null - Без штрафа (тогда штраф при аннуляции не начисляется)
                    {
                        "days": 5,      // Дата наступления штрафа (кол-во дней до заезда)
                                        // "days": null - Невозвратный (при аннуляции штраф 100%)
                        "penalty": 18800
                    },
                    {
                        "days": 10,
                        "penalty": 9800
                    }
                ]
            }
        ]
}

в оглавление

Квоты отелей

Имя метода: Hotel.Quotas

Параметры:

Параметр	Тип	Обязательный	по умолчанию	Комментарий
hotel_id	int	да		ID отеля
date_begin	date	да		Дата от
date_end	date	да		Дата до

Пример запроса: показать/скрыть

{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "Hotel.Quotas"
    },
    "request": {
            "hotel_id": 13080,
            "date_begin": "2021-02-01",
            "date_end": "2021-02-12"
        }
}

Пример ответа: показать/скрыть

{
    "header": {
        "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "Hotel.Quotas"
    },
    "response": [
            {
                "room_name": "бунгало, 2-х местный 2-х комн. люкс",
                "quotas": {
                    "2021-02-01": 7,
                    "2021-02-02": 7,
                    "2021-02-03": 7
                }
            },
            {
                "room_name": "дерево, 2-х местный стандарт",
                "quotas": {
                    "2021-02-01": 6,
                    "2021-02-02": 6,
                    "2021-02-03": 6
                }
            },
            {
                "room_name": "Изба, 2-х местный 2-х комн. люкс",
                "quotas": {
                    "2021-02-01": 6,
                    "2021-02-02": 6,
                    "2021-02-03": 6
                }
            }
        ]
}

в оглавление

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

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

Имя метода: 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	нет		Комментарий

Пример запроса: показать/скрыть

{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "Booking.Set"
    },
    "request": {
            "offer": "YSY3Ig.19900120062007000",
            "persons": [
                {
                    "last_name": "Иванов",
                    "first_name": "Николай",
                    "middle_name": "Петрович",
                    "birthday": "1984-01-01",
                    "passport_number": "1122 333444",
                    "passport_date": "2020-01-01",
                    "phone": "+7 (999) 123-45-67"
                },
                {
                    "last_name": "Иванова",
                    "first_name": "Наталья",
                    "birthday": "2015-01-02"                    
                }
            ],
            "comment": "комент 123"
        }
}

Пример ответа: показать/скрыть

{
    "header": {
        "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "Booking.Set"
    },
    "response": {
            "code": "X20010203"
        }
}

в оглавление

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

Имя метода: Booking.Status

Параметры:

Параметр	Тип	Обязательный	по умолчанию	Комментарий
code	string	да		ID брони

Пример запроса: показать/скрыть

{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "Booking.Status"
    },
    "request": {
            "code": "X20010203"
        }
}

Пример ответа: показать/скрыть

{
    "header": {
        "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "Booking.Status"
    },
    "response": {
            "code": "X20010203",
            "status": "cancel",            
        }
}

в оглавление

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

Имя метода: Booking.Cancel

Параметры:

Параметр	Тип	Обязательный	по умолчанию	Комментарий
code	string	да		ID брони

Пример запроса: показать/скрыть

{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "Booking.Cancel"
    },
    "request": {
            "code": "X20010203"
        }
}

Пример ответа: показать/скрыть

{
    "header": {
        "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "Booking.Cancel"
    },
    "response": {
            "code": "X20010203",
            "status": "cancel",

        }
}

в оглавление