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 отеля
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.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",

        }
}

в оглавление