Туроператор Русь

Туры по России Речные круизы Корпоративные туры Как оплатить Отзывы О компании Агентствам Контакты Личный кабинет
Операторы в чате c 06:00 до 01:00

Выгрузка данных по турам


Общая информация


Для удобства наших партнеров, а также в целях совместимости наше API поддерживает старые и новые методы.

Обращаем ваше внимание, что порядок работы может отличаться от метода к методу. За более подробным описанием обращайтесь к необходимому методу.


Форматы выгрузки


Наше API поддерживает несколько вариантов формата выгрузки (XML и JSON).

Для управления форматом данных существуют флаги is_json и data_type, которые необходимо указывать в аргументе HTTP-запроса.
Например: data_type=json, data_type=xml, is_json=1 или is_json=0.

Если не указывать тип явно, то выгрузка придёт в формате XML (за исключением нескольких методов).


Авторизация


К каждому методу необходимо указывать уникальный токен авторизации. Для получения токена Вам необходимо зарегистрироваться в личном кабинете агента. После того как токен будет сгенерирован, Вам откроются возможности выгрузки данных и создания заказов.


Динамическое ценообразование


В настоящий момент на все туры действует система динамического ценообразования. Основным термином данной системы является - коэффициент динамической цены.

Коэффициент динамической цены (КДЦ) - специальный множитель, отражающий текущий спрос на рынке на определенный тур. На текущем этапе у Вас есть возможность не использовать его в своей системе, но мы рекомендуем учесть его.

Для простоты понимания далее приведена формула, как рассчитать стоимость тура для клиента с учетом КДЦ.

S = (basicSum + margins) * D + additionalServices
, где basicSum - базовая цена,
margins - наценки,
D - КДЦ,
additionalServices - дополнительные услуги,

Содержание


  • Получить всё
  • Получить актуальные туры
  • Получить даты тура
  • Получить изображения
  • Получить перечень услуг на тур
  • Получить информацию по скидкам на услугу
  • Получить информацию о городах в туре
  • Получить список возможных скидок
  • Получить цены на тур
  • Получить дерево категорий
  • Получить все категории
  • Получить список направлений
  • Создать заказ
  • Помощь
  • Получить общую информацию по актуальным турам
  • Получить общую информацию по конкретному туру
  • Получить даты проведения тура
  • Получить общую информацию по конкретной дате тура
  • Получить информацию о ценах на конкретную дату тура
  • Получить всю информацию по туру

Подробное описание


  • Получить всё

    Возвращает аккумулированную информацию из всех запросов далее.

    • Пример запроса
      https://www.rtoperator.ru/export.html?entity=all&data_type=<Тип данных>&token=<Токен авторизации>
    • Список аргументов
      • data_type - Тип данных
      • token - Токен авторизации
  • Получить актуальные туры

    Возвращает список актуальных туров по параметрам

    • Пример запроса
      https://www.rtoperator.ru/export.html?entity=tour&tour_id=<ID тура>&owner=<Является ли тур нашим?>&category_id=<ID категории тура>&data_type=<Тип данных>&token=<Токен авторизации>
    • Список аргументов
      • tour_id - ID тура
      • owner - Является ли тур нашим?
      • category_id - ID категории тура
      • data_type - Тип данных
      • token - Токен авторизации
  • Получить даты тура

    Возвращает даты тура по ID тура

    • Пример запроса
      https://www.rtoperator.ru/export.html?entity=tourDate&tour_id=<ID тура>&data_type=<Тип данных>&token=<Токен авторизации>
    • Список аргументов
      • tour_id - ID тура
      • data_type - Тип данных
      • token - Токен авторизации
  • Получить изображения

    Возвращает все картинки для тура по ID

    • Пример запроса
      https://www.rtoperator.ru/export.html?entity=tourImage&tour_id=<ID тура>&data_type=<Тип данных>&token=<Токен авторизации>
    • Список аргументов
      • tour_id - ID тура
      • data_type - Тип данных
      • token - Токен авторизации
  • Получить перечень услуг на тур

    Возвращает информацию по всем услугам.
    Обращаем ваше внимание, что доп. услуги - это отдельная сущность

    • Пример запроса
      https://www.rtoperator.ru/export.html?entity=tourService&tour_id=<ID тура>&data_type=<Тип данных>&token=<Токен авторизации>
    • Список аргументов
      • tour_id - ID тура
      • data_type - Тип данных
      • token - Токен авторизации
  • Получить информацию по скидкам на услугу

    Возвращает информацию по всем скидкам на услугу

    • Пример запроса
      https://www.rtoperator.ru/export.html?entity=tourDiscount&service_id=<ID услуги>&data_type=<Тип данных>&token=<Токен авторизации>
    • Список аргументов
      • service_id - ID услуги
      • data_type - Тип данных
      • token - Токен авторизации
  • Получить информацию о городах в туре

    Возвращает массив объектов, которые хранят информацию о городе, ID тура и позиции города по маршруту тура.

    • Пример запроса
      https://www.rtoperator.ru/export.html?entity=tourCity&data_type=<Тип данных>&token=<Токен авторизации>
    • Список аргументов
      • data_type - Тип данных
      • token - Токен авторизации
  • Получить список возможных скидок

    Возвращает список объектов, содержащих информацию об ID услуг и скидках для них

    • Пример запроса
      https://www.rtoperator.ru/export.html?entity=discount&data_type=<Тип данных>&token=<Токен авторизации>
    • Список аргументов
      • data_type - Тип данных
      • token - Токен авторизации
  • Получить цены на тур

    Возвращает прайс-лист тура

    • Пример запроса
      https://www.rtoperator.ru/export.html?entity=price&tour_id=<ID тура>&data_type=<Тип данных>&token=<Токен авторизации>
    • Список аргументов
      • tour_id - ID тура
      • data_type - Тип данных
      • token - Токен авторизации
  • Получить дерево категорий

    Возвращает массив связей между категориями

    • Пример запроса
      https://www.rtoperator.ru/export.html?entity=categoryMap&data_type=<Тип данных>&token=<Токен авторизации>
    • Список аргументов
      • data_type - Тип данных
      • token - Токен авторизации
  • Получить все категории

    Возвращает список всех категорий

    • Пример запроса
      https://www.rtoperator.ru/export.html?entity=category&data_type=<Тип данных>&token=<Токен авторизации>
    • Список аргументов
      • data_type - Тип данных
      • token - Токен авторизации
  • Получить список направлений

    Возвращает список всех направлений

    • Пример запроса
      https://www.rtoperator.ru/export.html?entity=country&data_type=<Тип данных>&token=<Токен авторизации>
    • Список аргументов
      • data_type - Тип данных
      • token - Токен авторизации
  • Создать заказ

    Метод создает заказ в нашей системе, а Вам возвращается стоимость, выставленная для туристов, с учетом комиссий и скидок

    • Пример запроса
      https://www.rtoperator.ru/export.html?entity=makeOrder&token=<Токен авторизации>
    • Список аргументов
      • token - Токен авторизации
    • Структура данных
      data: object - Тело данных (required)
          tourDateId: int - Дата тура (required)
          room: object - Дата тура (required)
              bed: string - Тип кровати (required)
              <index>: object - Турист (required)
                  fio: string - ФИО (required)
                  passport: string - Номер документа
                  date: string - Дата рождения (required)
                  isChild: boolean - Является ли ребенком? (required)
                  bed: string - Тип кровати
                  pansion: string - Питание
                  note: string - Комментарий
                  phone: int - Телефон (required)
                  seat: string - Место
                  excursions: string - Доп. услуги
  • Помощь

    Возвращает справку по API

    • Пример запроса
      https://www.rtoperator.ru/export.html?entity=help&is_json=1&token=<Токен авторизации>
    • Список аргументов
      • is_json - Вывод в формате JSON
      • token - Токен авторизации
  • Получить общую информацию по актуальным турам

    Возвращает список актуальных туров со свойствами: идентификатор направления, разметку заголовков и описаний, количество дней и ночей, города, наш ли это тур и т.д. (JSON-Only)

    • Пример запроса
      https://www.rtoperator.ru/export.html?entity=toursGeneralData&token=<Токен авторизации>
    • Список аргументов
      • token - Токен авторизации
  • Получить общую информацию по конкретному туру

    Возвращает общую информацию по туру: идентификатор направления, разметку заголовков и описаний, количество дней и ночей, города, наш ли это тур и т.д. (JSON-Only)

    • Пример запроса
      https://www.rtoperator.ru/export.html?entity=tourGeneralData&tour_id=<ID тура>&token=<Токен авторизации>
    • Список аргументов
      • tour_id - ID тура
      • token - Токен авторизации
  • Получить даты проведения тура

    Возвращает список пар дат (старт-конец) для конкретного тура (JSON-Only)

    • Пример запроса
      https://www.rtoperator.ru/export.html?entity=tourDatesByTourId&tour_id=<ID тура>&token=<Токен авторизации>
    • Список аргументов
      • tour_id - ID тура
      • token - Токен авторизации
  • Получить общую информацию по конкретной дате тура

    Возвращает общую информацию о конкретной дате тура: даты начала и конца, доступность мест и комнат, время последнего изменения (JSON-Only)

    • Пример запроса
      https://www.rtoperator.ru/export.html?entity=tourDateGeneralData&tour_date_id=<ID даты тура>&token=<Токен авторизации>
    • Список аргументов
      • tour_date_id - ID даты тура
      • token - Токен авторизации
  • Получить информацию о ценах на конкретную дату тура

    Возвращает массив с данными о ценообразовании тура: базовую цену, планы питания и доп. услуги. Обратите внимание, что динамический коэффициент выступает общим множителем для всех слагаемых базовой цены (JSON-Only)

    • Пример запроса
      https://www.rtoperator.ru/export.html?entity=tourDatePrice&tour_date_id=<ID даты тура>&token=<Токен авторизации>
    • Список аргументов
      • tour_date_id - ID даты тура
      • token - Токен авторизации
  • Получить всю информацию по туру

    Возвращает информацию по туру: списки доступных дат, общую информацию о каждой дате, информацию о цене для каждой даты (JSON-Only)

    • Пример запроса
      https://www.rtoperator.ru/export.html?entity=allTourRelatedData&tour_id=<ID тура>&token=<Токен авторизации>
    • Список аргументов
      • tour_id - ID тура
      • token - Токен авторизации

Ещё один формат данных по туру

  • Пример запроса
    https://www.rtoperator.ru/export/tourdate-meal-feed.php?id=
  • Список аргументов
    • id - ID тура