О компании Туристам Агентствам Контакты
Агентствам
+7 (499) 301-60-00
Туристам
+7 (495) 411skypeoff-90-57

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

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

Введение

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

Запрос представляет из себя отправку данных методом POST на URL https://multitour.ru/mtapi/ Данные это данные упакованные в JSON ( т.е. фактически данные типа «строка» ). Для запросов используйте token : 9251343b6574c9986afa9704d2abf4cf8ffc2b71
Пример:
{
    "header" : {
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method":"map.resort"
    },
    "request":{
        "country_id": 6228
    }
}
в оглавление

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

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

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

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

Справочники

Страны

Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
type string( all | tour | excurs ) нет all
  • all - все страны
  • tour - страны обычгых туров
  • excurs - страны экскурсионных туров туров
Пример запроса:
{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method":"map.country"
    },
    "request":{
        "type":"excurs"
    }
}
Пример ответа:
{
    "header": {
        "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "map.country"
    },
    "request": {
        "type": "excurs"
    },
    "response": {
        "country": [
            {
                "id": "6276",
                "name": "Абхазия Экскурсии"
            },
            {
                "id": "6282",
                "name": "Азербайджан Экскурсии"
            },
            /*..... продолжение данных .....*/
        ]
    }
}
в оглавление

Курорты

Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
country_id int да ID страны из справочника стран
Пример запроса:
{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method":"map.resort"
    },
    "request":{
        "country_id":6228
    }
}
Пример ответа:
{
    "header": {
        "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "map.resort"
    },
    "request": {
        "country_id": 6228
    },
    "response": {
        "resort": [
            {
                "id": "201",
                "name": "Анапа",
                "country_id": "6228"
            },
            {
                "id": "202",
                "name": "Геленджик",
                "country_id": "6228"
            },
            /*..... продолжение данных .....*/
        ]
    }
}
в оглавление

Города / регионы

Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
country_id int да ID страны из справочника стран
resort_id array(int) нет массив ID курортов из справочника курортов
Пример запроса:
{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method":"map.city"
    },
    "request":{
        "country_id":6228,
        "resort_id":[201,204]
    }
}
Пример ответа:
{
    "header": {
        "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "map.city"
    },
    "request": {
        "country_id": 6228,
        "resort_id": [201,204]
    },
    "response": {
        "city": [
            {
                "id": "1446",
                "name": "Адлер",
                "country_id": "6228",
                "resort_id": "204"
            },
            {
                "id": "1435",
                "name": "Анапа, Пионерский пр-т",
                "country_id": "6228",
                "resort_id": "201"
            },
            /*..... продолжение данных .....*/
        ]
    }
}
в оглавление

Отели

Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
country_id int да ID страны из справочника стран
resort_id array(int) нет масcив ID курортов из справочника курортов
city_id array(int) нет масcив ID городов / регионов из справочника городов / регионов
Пример запроса:
{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method":"map.hotel"
    },
    "request":{
        "country_id":6228,
        "resort_id":[201,204],
        "city_id":[1435,1133]
    }
}
Пример ответа:
{
  "header": {
    "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
    "method": "map.hotel"
  },
  "request": {
    "country_id": 6228,
    "resort_id": [
      201,
      204
    ],
    "city_id": [
      1435,
      1133
    ]
  },
  "response": {
    "hotel": [
      {
        "id": "9044",
        "name": "Beton Brut (Бетон Брют)**** Отель",
        "country_id": "6228",
        "resort_id": "201",
        "city_id": "1435",
        "min_age": "0", // минимальный возраст ребенка в данном объекте
        "img_src": "https:\/\/www.multitour.ru\/files\/imgs\/hotel_9044_93602_territory31024x512.jpg", // изображение отеля
        "x": "44.97709274291992", // широта
        "y": "37.27494812011719"    // долгота
      },
      {
        "id": "8562",
        "name": "Del Mare Отель",
        "country_id": "6228",
        "resort_id": "201",
        "city_id": "1435",
        "min_age": null,
        "img_src": "https:\/\/www.multitour.ru\/files\/imgs\/hotel_8562_86883_IMG_1199.jpg",
        "x": "44.954524993896484",
        "y": "37.29935836791992"
      },
      /*..... продолжение данных .....*/
    ]
  }
}
в оглавление

Категории отелей

Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
country_id int да ID страны из справочника стран
Пример запроса:
{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method":"map.category"
    },
    "request":{
        "country_id":6228
    }
}
Пример ответа:
{
  "header": {
    "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
    "method": "map.category"
  },
  "request": {
    "country_id": 6228
  },
  "response": {
    "category": [
      {
        "id": 2,
        "name": "средний",
        "hotel_id": [ // массив ID отелей из справочника отелей, которые относятся к этой категории
          "4888",
          "5528",
          "5555",
          "5004",
          "5014",
          /* продолжение массива */
        ]
      },
      {
        "id": 1,
        "name": "экономичный",
        "hotel_id": [
          "5556",
          "7578",
          "8079",
          "8080",
          "8075",
          /* продолжение массива */
        ]
      },
      /*..... продолжение данных .....*/
    ]
  }
}
в оглавление

Профили лечения

Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
country_id int да ID страны из справочника стран
Пример запроса:
{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method":"map.treatment"
    },
    "request":{
        "country_id":6228
    }
}
Пример ответа:
{
  "header": {
    "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
    "method": "map.treatment"
  },
  "request": {
    "country_id": 6228
  },
  "response": {
    "category": [
      {
        "id": "158",
        "name": "Нервная система",
        "hotel_id": [ // массив ID отелей из справочника отелей, которые поддерживают этот профиль лечения
          "4888",
          "5528",
          "5555",
          "5004",
          "5014",
          /* продолжение массива */
        ]
      },
      {
        "id": "164",
        "name": "Гинекология",
        "hotel_id": [
          "5556",
          "7578",
          "8079",
          "8080",
          "8075",
          /* продолжение массива */
        ]
      },
      /*..... продолжение данных .....*/
    ]
  }
}
в оглавление

Питание

Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
country_id int да ID страны из справочника стран
Пример запроса:
{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method":"map.pansion"
    },
    "request":{
        "country_id":6228
    }
}
Пример ответа:
{
  "header": {
    "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
    "method": "map.pansion"
  },
  "request": {
    "country_id": 6228
  },
  "response": {
    "category": [
      {
        "id": 4,
        "name": "все включено",
        "hotel_id": [ // массив ID отелей из справочника отелей, которые поддерживают этот тип питания
          "4888",
          "5528",
          "5555",
          "5004",
          "5014",
          /* продолжение массива */
        ]
      },
      {
        "id": 0,
        "name": "без питания",
        "hotel_id": [
          "5556",
          "7578",
          "8079",
          "8080",
          "8075",
          /* продолжение массива */
        ]
      },
      /*..... продолжение данных .....*/
    ]
  }
}
в оглавление

Шоссе

Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
country_id int да ID страны из справочника стран
Пример запроса:
{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method":"map.highway"
    },
    "request":{
        "country_id":6243
    }
}
Пример ответа:
{
  "header": {
    "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
    "method": "map.highway"
  },
  "request": {
    "country_id": 6243
  },
  "response": {
    "category": [
      {
        "id": 5,
        "name": "Киевское",
        "hotel_id": [ // массив ID отелей из справочника отелей, которые поддерживают этот тип питания
          "4888",
          "5528",
          "5555",
          "5004",
          "5014",
          /* продолжение массива */
        ]
      },
      {
        "id": 13,
        "name": "Ярославское",
        "hotel_id": [
          "5556",
          "7578",
          "8079",
          "8080",
          "8075",
          /* продолжение массива */
        ]
      },
      /*..... продолжение данных .....*/
    ]
  }
}
в оглавление

Тип пляжа

Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
country_id int да ID страны из справочника стран
Пример запроса:
{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method":"map.beach.type"
    },
    "request":{
        "country_id":6228
    }
}
Пример ответа:
{
  "header": {
    "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
    "method": "map.beach.type"
  },
  "request": {
    "country_id": 6228
  },
  "response": {
    "category": [
      {
        "id": 3,
        "name": "песчаный",
        "hotel_id": [ // массив ID отелей из справочника отелей, у которых этот тип пляжа
          "4888",
          "5528",
          "5555",
          "5004",
          "5014",
          /* продолжение массива */
        ]
      },
      {
        "id": 1,
        "name": "песчано-галечный",
        "hotel_id": [
          "5556",
          "7578",
          "8079",
          "8080",
          "8075",
          /* продолжение массива */
        ]
      },
      /*..... продолжение данных .....*/
    ]
  }
}
в оглавление

Удаленность от моря

Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
country_id int да ID страны из справочника стран
Пример запроса:
{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method":"map.sea.distance"
    },
    "request":{
        "country_id":6228
    }
}
Пример ответа:
{
  "header": {
    "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
    "method": "map.sea.distance"
  },
  "request": {
    "country_id": 6228
  },
  "response": {
    "category": [
      {
        "id": 100,
        "name": "до 100 м",
        "hotel_id": [ // массив ID отелей из справочника отелей, у которых этот тип пляжа
          "4888",
          "5528",
          "5555",
          "5004",
          "5014",
          /* продолжение массива */
        ]
      },
      {
        "id": 1000,
        "name": "больше 700 м",
        "hotel_id": [
          "5556",
          "7578",
          "8079",
          "8080",
          "8075",
          /* продолжение массива */
        ]
      },
      /*..... продолжение данных .....*/
    ]
  }
}
в оглавление

Особенности отелей

Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
country_id int да ID страны из справочника стран
resort_id array(int) нет масcив ID курортов из справочника курортов
city_id array(int) нет масcив ID городов / регионов из справочника городов / регионов
Пример запроса:
{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method":"map.options"
    },
    "request":{
        "country_id":6228,
        "resort_id":[201,204],
        "city_id":[1435,1133]
    }
}
Пример ответа:
{
  "header": {
    "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
    "method": "map.options"
  },
  "request": {
    "country_id": 6228,
    "resort_id": [
      201,
      204
    ],
    "city_id": [
      1435,
      1133
    ]
  },
  "response": {
    "options": [
      {
        "id": "180",
        "name": "Анимация",
        "hotel_id": [
          "5556",
          "7578",
          "8079",
          "8080",
          "8075",
          /* продолжение массива */
      },
      {
        "id": "3",
        "name": "Бассейн",
        "hotel_id": [
          "5556",
          "7578",
          "8079",
          "8080",
          "8075",
          /* продолжение массива */
      },
      /*..... продолжение данных .....*/
    ]
  }
}
в оглавление

Типы туров

Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
country_id int да ID страны из справочника стран
resort_id array(int) нет масcив ID курортов из справочника курортов
city_id array(int) нет масcив ID городов / регионов из справочника городов / регионов
Пример запроса:
{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method":"map.tour.type"
    },
    "request":{
        "country_id":6228,
        "resort_id":[201,204],
        "city_id":[1435,1133]
    }
}
Пример ответа:
{
  "header": {
    "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
    "method": "map.tour.type"
  },
  "request": {
    "country_id": 6228,
    "resort_id": [
      201,
      204
    ],
    "city_id": [
      1435,
      1133
    ]
  },
  "response": {
    "tourtype": [
      {
        "id": "17",
        "name": "Отдых"
      },
      {
        "id": "19",
        "name": "Автобусные туры из Москвы"
      },
      {
        "id": "28",
        "name": "Праздничные туры"
      },
      {
        "id": "32",
        "name": "Лечение"
      },
      {
        "id": "34",
        "name": "Спецпредложение"
      }
    ]
  }
}
в оглавление

Цены

Поиск отелей

Метод API предоставляет возможность найти отели, удовлетворяющие условиям поиска ( фильтра ), а также получить данные квот ( наличие мест ) и минимальную стоимость. Ответ на запрос содержит в себе необходимые данные справочников, поэтому в большинстве случаев отдельных запросов к справочникам не требуется.

Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
country_id int да ID страны из справочника стран
resort_id array(int) нет масcив ID курортов из справочника курортов
city_id array(int) нет масcив ID городов / регионов из справочника городов / регионов
hotel_id array(int) нет масcив ID отелей из справочника отелей
dates array( unixtime | string( 'dd.mm.YYYY' ) ) да массив дат в формате unixtime или строки типа "20.06.2018". За один запрос максимально можно передать не более 3-х дат.
nights array( int ) да массив количества ночей. За один запрос максимально можно передать не более 3-х вариантов.
adult int да количество взрослых
ages array( int ) нет массив возрастов детей , например 3 ребенка, два грудничка и 5 лет = [ 0 , 0 , 5 ]
highway array( int ) нет масcив ID шоссе из справочника шоссе. Если задано несколько вариантов то фильтр по срабатывает по принципу "ИЛИ". В настоящее время фильтр шоссе работает только в стране "Россия"
category array( int ) нет масcив ID категорий отеля из справочника категорий отеля. Если задано несколько вариантов то фильтр срабатывает по принципу "ИЛИ".
sea_distance array( int ) нет масcив ID удаленности от моря из справочника удаленность от моря. Если задано несколько вариантов то фильтр срабатывает по принципу "ИЛИ".
beach_type array( int ) нет масcив ID типа пляжа от моря из справочника типов пляжа. Если задано несколько вариантов то фильтр срабатывает по принципу "ИЛИ".
treatment array( int ) нет масcив ID питания из справочника типов питания. Если задано несколько вариантов то фильтр срабатывает по принципу "ИЛИ".
pansion array( int ) нет масcив ID питания из справочника типов питания. Если задано несколько вариантов то фильтр срабатывает по принципу "ИЛИ".
options array( int ) нет масcив ID особенностей отеля из справочника особенности отеля. Если задано несколько вариантов то фильтр срабатывает по принципу "И".
tour_type array( int ) нет масcив ID типов туров из справочника тип тура. Если задано несколько вариантов то фильтр срабатывает по принципу "ИЛИ".
price_min int нет минимальная стоимость тура
price_max int нет максимальная стоимость тура
quote bool( 0 | 1 ) нет отдавать предложения только с гарантированными местами
Пример запроса:
{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method":"list.price"
    },
    "request":{
        "country_id":6228,
        "resort_id":[201],
        "city_id":[1435,1436,1549],
        "dates":["03.08.2018","28.07.2018"],
        "nights":[7,10],
        "beach_type":[3],
        "sea_distance":[100],
        "pansion":[0,2],
        "adult":2,
        "ages":[2,10]
    }
}
Пример ответа:
{
  "header": {
    "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
    "method": "list.price"
  },
  "request": {
    "country_id": 6228,
    "resort_id": [
      201
    ],
    "city_id": [
      1435,
      1436,
      1549
    ],
    "dates": [
      "03.08.2018",
      "28.07.2018"
    ],
    "nights": [
      7,
      10
    ],
    "beach_type": [
      3
    ],
    "sea_distance": [
      100
    ],
    "pansion": [
      0,
      2
    ],
    "adult": 2,
    "ages": [
      2,
      10
    ]
  },
  "response": {
    "list_price": {
      "data": {
        "6596": {
          "price_min": "22890", // минимально возможная стоимость проживания в данном отеле
          "accomodation_min": "972", // тип размещения при минимальной стоимости, это ID его описание в массиве "response"."map"."accomodation"
          "tour_type_min": "17", // тип тура при минимальной стоимости, это ID его описание в массиве "response"."map"."tour_type"
          "pansion_min": "0", // тип питания при минимальной стоимости, это ID его описание в массиве "response"."map"."pansion_type"
          "date_min": 1532725200, // UNIXTIME дата заезда при минимальной стоимости
          "days_min": 7,// количество ночей при минимальной стоимости
          "quote": 1, // признак что по заданному запросу существуют гарантированные квоты = 1, иначе = 0 , т.е. необходимо подтверждение бронирования
          "price": { // минимальные стоимости по дням и датам в разрезе типа бронирования : квота или под запрос
            "1532725200": { // день заезда UNIXTIME
              "7": { // количество ночей
                "quote": "22890",// минимальная стоимость за этот день и количество ночей по квотному бронированию
                "request": "30520" // минимальная стоимость за этот день и количество ночей по бронированию с подтверждением
              },
              "10": {
                "quote": "32700",
                "request": "43600"
              }
            },
            "1533243600": {
              "7": {
                "quote": "22890",
                "request": "30520"
              },
              "10": {
                "quote": "32700",
                "request": "43600"
              }
            }
          }
        }
      },
      "map": {
        "accomodation": [
          {
            "id": 972,
            "name": "3 взр+1 реб (0-3) без места и пит."
          },
          {
            "id": 648,
            "name": "4 взр"
          },
          {
            "id": 1324,
            "name": "2 взр+1 доп (0-99)+1 реб (0-3) без места и пит."
          },
          {
            "id": 1089,
            "name": "2 взр+2 доп (0-99)"
          }
        ],
        "country": [
          {
            "id": 6228,
            "name": "Россия Краснодарский край"
          }
        ],
        "resort": [
          {
            "id": 201,
            "name": "Анапа"
          }
        ],
        "city": [
          {
            "id": 1435,
            "name": "Анапа, Пионерский пр-т"
          }
        ],
        "hotel_type": [
          {
            "id": 90,
            "name": "гостиница"
          }
        ],
        "pansion_type": [
          {
            "id": 0,
            "name": "без питания"
          }
        ],
        "tour_type": [
          {
            "id": 17,
            "name": "Отдых"
          }
        ],
        "hotel": [
          {
            "id": "6596",
            "name": "Антарес  Гостиница",
            "country_id": "6228",// ID страны, дополнительнаая информация в "response"."map"."country"
            "resort_id": "201",// ID курорта, дополнительнаая информация в "response"."map"."resort"
            "city_id": "1435",// ID города или региона, дополнительнаая информация в "response"."map"."city"
            "type_id": "90", // ID тип отеля, дополнительнаая информация в "response"."map"."hotel_type"
            "min_age": "0",// минимально возможный возраст ребенка в данном отеле, может отсутсвовать - тогда ограничений нет
            "img_src": "https:\/\/multitour.ru\/files\/imgs\/hotel_6596_29165_IMG_8705.jpg",// изображение отеля
            "x": "44.975101470947266",// широта отеля
            "y": "37.26350021362305", // долгота отеля
            "pansions": [ // возможные типы питания в отеле, массив ID описание в массиве "response"."map"."pansion_type"
              "0"
            ]
          }
        ]
      }
    }
  }
}
в оглавление

Цены отеля

Метод API предоставляет возможность, зная ID отеля, получить детализированные ценовые предложения, удовлетворяющие условиям поиска ( фильтра ), а также получить данные квот ( наличие мест ). Ответ на запрос содержит в себе необходимые данные справочников, поэтому в большинстве случаев отдельных запросов к справочникам не требуется.

Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
hotel_id int нет ID отеля из справочника отелей
dates array( unixtime | string( 'dd.mm.YYYY' ) ) да массив дат в формате unixtime или строки типа "20.06.2018". За один запрос максимально можно передать не более 3-х дат.
nights array( int ) да массив количества ночей. За один запрос максимально можно передать не более 3-х вариантов.
adult int да количество взрослых
ages array( int ) нет массив возрастов детей , например 3 ребенка, два грудничка и 5 лет = [ 0 , 0 , 5 ]
Пример запроса:
{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method":"hotel.price"
    },
    "request":{
        "hotel_id":4952,
        "dates":["03.08.2018","28.07.2018"],
        "nights":[7,10],
        "adult":2,
        "ages":[2,10]
    }
}
Пример ответа:
{
  "header": {
    "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
    "method": "hotel.price"
  },
  "request": {
    "hotel_id": 4952,
    "dates": [
      "03.08.2018",
      "28.07.2018"
    ],
    "nights": [
      7,
      10
    ],
    "adult": 2,
    "ages": [
      2,
      10
    ]
  },
  "response": {
    "hotel_price": {
      "map": {
        "tour_type": [
          {
            "id": "32",
            "name": "Лечение"
          },
          {
            "id": "17",
            "name": "Отдых"
          }
        ],
        "tarif": [
          {
            "id": "111479",
            "name": "С лечением питание «заказное меню» 23.02-25.02\/08.03-11.03\/01.05-02.05\/09.05\/01.06-31.08"
          },
          {
            "id": "111480",
            "name": "Без лечения и питания 23.02-25.02\/08.03-11.03\/01.05-02.05\/09.05\/01.06-31.08"
          },
          {
            "id": "111498",
            "name": "С лечением питание «шведский стол» 23.02-25.02\/08.03-11.03\/01.05-02.05\/09.05\/01.06-31.08"
          },
          {
            "id": "111505",
            "name": "Без лечения питание «заказное меню» 23.02-25.02\/08.03-11.03\/01.05-02.05\/09.05\/01.06-31.08"
          },
          {
            "id": "111507",
            "name": "Без лечения питание «шведский стол» 23.02-25.02\/08.03-11.03\/01.05-02.05\/09.05\/01.06-31.08"
          }
        ],
        "pansion": [
          {
            "id": "52",
            "name": "4-х разовое питание"
          },
          {
            "id": "38",
            "name": "Без питания"
          },
          {
            "id": "82",
            "name": "4-х разовое питание швед. стол"
          }
        ],
        "room": [
          {
            "id": "548",
            "name": "4-х местный"
          },
          {
            "id": "1267",
            "name": "3-х местный 2-х комн. люкс"
          },
          {
            "id": "645",
            "name": "4-х местный эконом"
          }
        ],
        "room_category": [
          {
            "id": "1020",
            "name": "эконом\r\n"
          },
          {
            "id": "1082",
            "name": "семейный"
          }
        ],
        "pansion_type": [
          {
            "id": "3",
            "name": "3-х разовое и более"
          },
          {
            "id": "0",
            "name": "без питания"
          }
        ],
        "accomodation": [
          {
            "id": "648",
            "name": "4 взр"
          },
          {
            "id": "971",
            "name": "3 взр+1 реб (0-2) без места и пит."
          },
          {
            "id": "846",
            "name": "3 взр+1 доп (3-99)"
          }
        ]
      },
      "data": [
        {
          "night": "7", // количество ночей
          "date": "1532725200", // UNIXTIME дата заезда
          "tour_id": "32",// ID типа тура, описание в массиве "response"."map"."tour_type"
          "hotel_id": "4952",
          "tarif_id": "111479",// ID тарифа, описание в массиве "response"."map"."tarif"
          "price_id": "1233161591",// идентификатор бронирования, на основе этого идентификатора возможно бронирование этого варианта
          "price": "59520",// стоимость в рублях
          "room_id": "548",// ID номера, описание в массиве "response"."map"."room"
          "room_category_id": "1020",// ID категории номера, описание в массиве "response"."map"."room_category"
          "pansion_id": "52",// ID тарифа питания, описание в массиве "response"."map"."pansion"
          "pansion_type_id": "3",// ID типа питания, описание в массиве "response"."map"."pansion_type"
          "accomodation_id": "648",// ID типа размещения, описание в массиве "response"."map"."accomodation"
          "quote": 0 // если = 1 это квотная заявка , = 0 - необходимо подтверждение возможности заселения
        },
        {
          "night": "7",
          "date": "1533243600",
          "tour_id": "32",
          "hotel_id": "4952",
          "tarif_id": "111479",
          "price_id": "1233165179",
          "price": "59520",
          "room_id": "548",
          "room_category_id": "1020",
          "pansion_id": "52",
          "pansion_type_id": "3",
          "accomodation_id": "648",
          "quote": 0
        },
        /*..... продолжение данных .....*/
      ]
    }
  }
}
в оглавление

Поиск цен

Метод API предоставляет возможность, поиска актуальных цен по датам и кол-ву ночей. В отличии от метода list.price не содержить отдельно справочников.

Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
dates array(unixtime | string('dd.mm.YYYY')) да массив дат в формате unixtime или строки типа "20.06.2018". За один запрос максимально можно передать не более 3-х дат.
nights array(int) да массив количества ночей. За один запрос максимально можно передать не более 3-х вариантов.
guests int да количество взрослых
age_childs array(int) нет массив возрастов детей , например 3 ребенка, два грудничка и 5 лет = [ 0 , 0 , 5 ]
country_id int нет ID страны
resort_id int нет ID курорта
city_id int нет ID города
hotel_id int нет ID отеля
hotel_options array(string) нет массив опция отеля, например ["Анимация", "Бассейн", "Акция раннее бронирование" и т.д.]. Полный список опций можно получить из запроса Опции отеля
Пример запроса:
{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "price.search"
    },
    "request":{
	    "guests": 2,
	    "age_childs": [],
	    "dates": ["01.06.2019"],
	    "nights": ["7"],
	    "hotel_options": ["Анимация", "Акция раннее бронирование"]
    }
}
Пример ответа:
{
    "header": {
        "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "price.search"
    },
    "request": {
        "guests": 2,
        "age_childs": [],
        "dates": [
            "01.06.2019"
        ],
        "nights": [
            "7"
        ],
        "hotel_options": [
            "Анимация",
            "Акция раннее бронирование"
        ]
    },
    "response": {
        "price_search": [
            {
                "id": "1513299043",
                "date": "2019-06-01",
                "nights": "7",
                "country_id": "6228",
                "country_name": "Россия Краснодарский край",
                "resort_id": "201",
                "resort_name": "Анапа",
                "city_id": "1435",
                "city_name": "Анапа, Пионерский пр-т",
                "hotel_id": "5098",
                "hotel_name": "Южный Парус",
                "hotel_category": "Пансионат",
                "room_id": "546",
                "room_name": "2-х местный",
                "room_category_id": "23",
                "room_category_name": "стандарт",
                "accommodation_id": "646",
                "accommodation_name": "2 взр",
                "pansion_id": "54",
                "pansion_name": "3-х разовое питание швед. стол",
                "price": "28000"
            },
            {
                "id": "1532187552",
                "date": "2019-06-01",
                "nights": "7",
                "country_id": "6228",
                "country_name": "Россия Краснодарский край",
                "resort_id": "204",
                "resort_name": "Сочи",
                "city_id": "1546",
                "city_name": "Уч-Дере",
                "hotel_id": "6544",
                "hotel_name": "Ивушка",
                "hotel_category": "Санаторий",
                "room_id": "546",
                "room_name": "2-х местный",
                "room_category_id": "23",
                "room_category_name": "стандарт",
                "accommodation_id": "646",
                "accommodation_name": "2 взр",
                "pansion_id": "51",
                "pansion_name": "3-х разовое питание",
                "price": "39200"
            },
            ...
        }
    }
}
в оглавление

Опции отеля

Пример запроса:
{
    "header":{
        "token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "hotel.options"
    },
    "request":{}
}
Пример ответа:
{
    "header": {
        "token": "9251343b6574c9986afa9704d2abf4cf8ffc2b71",
        "method": "hotel.options"
    },
    "response": {
        "hotel_options": [
            "Акция раннее бронирование",
            "Анимация",
            "Банкетный зал",
            "Бар",
            "Баскетбольная площадка",
            "Бассейн",
            "Бесплатные услуги",
        ...
        ]
    }
}
в оглавление

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

Внимание! для работы с методами бронирования необходимо получить индивидуальный токен.

Создание заявки на бронирование

Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
us_key int да ID пользователя от которого происходит бронирование
price_key int да ID цены тура
date string('dd.mm.YYYY') да Дата бронирования
persons array да список туристов
view string(full) | null нет Вариант отображения. Если не указан, возвращается только код договора. Если указан “full” возвращается результат booking_info
Параметры объекта persons:
Параметр Тип Обязательный по умолчанию Комментарий
sex int да Пол (1 - М, 2 - Ж, 3 - Реб-М, 4 - Реб-Ж, 5 - Млад-М, 6 - Млад-Ж)
surname int да Фамилия
firstname string да Имя
middlename string нет Отчество
birthday string('dd.mm.YYYY') да Дата рождения
passports string нет Паспорт серия
passportn string нет Паспорт номер
passportdate string('dd.mm.YYYY') нет Действителен до
citizen string нет Гражданство. Например: Россия, Украина
tel string нет Телефон
Пример запроса:
{
	"header":{
		"token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
		"method":"booking_set"
	},
	"request":{
		"us_key": 111,
		"price_key": 1438172603,
		"date": "28.06.2018",
		"persons": [
			{
				"sex": 1,
				"surname": "Иванов",
				"firstname": "Петр",
				"middlename": "Сергеевич",
				"birthday": "15.03.1976",
				"passports": "1122",
				"passportn": "333444",
				"passportdate": "01.06.2020",
				"citizen": "Россия",
				"tel": "+7 123 345 67 89",
			},
			{
				"sex": 2,
				"surname": "Иванова",
				"firstname": "Татьяна",
				"middlename": "Сергеевна",
				"birthday": "13.05.1978",
				"passports": "9876",
				"passportn": "555444",
				"passportdate": "12.02.2019",
				"citizen": "Россия"
			}
		]
    }
}
Пример ответа:
{
	"header":{
		"token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
		"method":"booking_set"
	},
	"request":{
		"us_key": 111,
		"price_key": 1438172603,
		"date": "28.06.2018",
		"persons": [
			{
				"sex": 1,
				"surname": "Иванов",
				"firstname": "Петр",
				"middlename": "Сергеевич",
				"birthday": "15.03.1976",
				"passports": "1122",
				"passportn": "333444",
				"passportdate": "01.06.2020",
				"citizen": "Россия",
				"tel": "+7 123 345 67 89",
			},
			{
				"sex": 2,
				"surname": "Иванова",
				"firstname": "Татьяна",
				"middlename": "Сергеевна",
				"birthday": "13.05.1978",
				"passports": "9876",
				"passportn": "555444",
				"passportdate": "12.02.2019",
				"citizen": "Россия"
			}
		]
	},
	"response": {
		"booking_info": {
			"code": "X1800001"
		}
	}

}
в оглавление

Получение списка заявок бронирования

Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
us_key int да ID пользователя от которого происходит бронирование
code string нет Код заявки
year int нет Год заявки
create_date_begin string('dd.mm.YYYY') нет Дата заявки “от”
create_date_end string('dd.mm.YYYY') нет Дата заявки “до”
tour_date_begin string('dd.mm.YYYY') нет Дата тура “от”
tour_date_end string('dd.mm.YYYY') нет Дата тура “до”
tour_date string('dd.mm.YYYY') нет Дата тура
tour_name string нет Название тура
tourist_name string нет Имя туриста
status string(ok, not_pay, null) нет Статус заявки
count int нет 30 Кол-во записей для отображения
page int нет 1 Номер страницы отображения
Параметры объекта persons:
Параметр Тип Обязательный по умолчанию Комментарий
sex int да Пол (1 - М, 2 - Ж, 3 - Реб-М, 4 - Реб-Ж, 5 - Млад-М, 6 - Млад-Ж)
surname int да Фамилия
firstname string да Имя
middlename string нет Отчество
birthday string('dd.mm.YYYY') да Дата рождения
passports string нет Паспорт серия
passportn string нет Паспорт номер
passportdate string('dd.mm.YYYY') нет Действителен до
citizen string нет Гражданство. Например: Россия, Украина
tel string нет Телефон
Пример запроса:
{
	"header":{
		"token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
		"method":"booking_list"
	},
	"request":{
		"us_key": 111,
		"status": "ok"
    }
}
Пример ответа:
{
	"header":{
		"token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
		"method":"booking_list"
	},
	"request":{
		"us_key": 111,
		"status": "ok"
    },
	"response": {
		"booking_list": {
			"data": [
				{
					"code": "X1800001", // код заявки
					"create_date": "28.06.2018", // дата создания заявки
					"tour_key": "1123", // ID тура
					"tour_date": "12.07.2018", // Дата тура
					"tour_name": "Золотой колос", // Название тура
					"count_tourist": "2", // Кол-во туристов
					"main_tourist": "Иванов Петр Сергеевич", // ФИО основного туриста
					"price": "54618", // стоимость
					"payed": "25787", // оплачено
					"days": "7", // Кол-во дней
					"status_key": 1, // ID статуса
					"status_name": "OK" // Название статуса
				},
				/*..... продолжение данных .....*/
			],
			"count": 99,
			"persons": 215,
			"price": 5465164,
			"payed": 5316787
		}
	}

}
в оглавление

Получение детальной информации по заявке

Параметры:
Параметр Тип Обязательный по умолчанию Комментарий
us_key int да ID пользователя от которого происходит бронирование
code string да Код заявки
Пример запроса:
{
	"header":{
		"token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
		"method":"booking_info"
	},
	"request":{
		"us_key": 111,
		"code": "X1800001"
    }
}
Пример ответа:
{
	"header":{
		"token":"9251343b6574c9986afa9704d2abf4cf8ffc2b71",
		"method":"booking_info"
	},
	"request":{
		"us_key": 111,
		"code": "X1800001"
    },
	"response": {
		"booking_info": {
			"info": { // информация по заявке
				"code": "...", // Код заявки
				"tour_date": "...", // Дата тура
				"days": "...", // Кол-во дней
				"nights": "...", // Кол-во ночей
				"price": "...", // Цена
				"payed": "..." // Оплачено
			},
			"tours": { // проживание
				"key": "...", // ID услуги
				"name": "...", // Наименование услуги
				"hotel_key": "...", // ID отеля
				"hotel_name": "...", // Название отеля
				"date_begin": "...", // Дата заезда
				"date_end": "...", // Дата выезда
				"room_key": "...", // ID номера
				"room_name": "...", // Название номера + категория + размещение
				"pansion_key": "...", // ID питания
				"pansion_name": "..." // Название питания
			},
			"transfers": [ // трансферы
				{
					"key": "...", // ID услуги
					"route": "...", // Маршрут
					"type": "...", // Тип трансфера
					"place": "...", // Место встречи
					"phone": "..." // Контактный телефон
				},
				{ ... }
			],
			"insurances": [ // страховки
				{
					"key": "...", // ID услуги
					"type": "...", // Тип страховки
					"name": "...", // Полное наименование
					"days": "..." // Продолжительность в днях
				},
				{ ... }
			],
			"tickets": [ // билеты
				{
					"key": "...", // ID услуги
					"name": "...", // Полное наименование
					"num": "...", // Номер рейса
					"route": "...", // Маршрут
					"class": "...", // Класс
					"date": "...", // Дата рейса
					"time_from": "...", // Время отправления
					"time_to": "...", // Время прибытия
					"airport": "..." // Аэропорт
				},
				{ ... }
			],
			"tourists": [ // Список туристов
				{
					"key": "...", // ID туриста
					"name": "...", // Фамилия
					"fname": "...", // Имя
					"sname": "...", // Отчество
					"sex": "...", // Пол
					"birthday": "...", // Дата рождения
					"passport_ser": "...", // Паспорт серия
					"passport_num": "...", // Паспорт номер
					"passport_date": "...", // Паспорт дата
					"phone": "...", // телефон
					"citizen": "..." // гражданство
				},
				{ ... }
			]
		}
	}

}
в оглавление