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

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

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

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

Попробуйте наше демо в Swagger

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

Наше 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)
        <room_index>: object - Комната (required)
            <tourist_index>: object - Турист (required)
                fio: string - ФИО (required)
                passport: string - Номер документа (required)
                date: string - Дата рождения (required)
                isChild: boolean - Является ли ребенком? (required)
                phone: int - Телефон (required)

Пример входных данных:

{
    "data": {
        "tourDateId": 74722,
        "room": {
            "0": {
                "0": {
                    "fio": "Бортич Александра Николаевна",
                    "passport": "1234567890",
                    "date": "1990-01-01",
                    "isChild": false,
                    "phone": 9123456789
                },
                "1": {
                    "fio": "Арзамасова Елизавета Николаевна",
                    "passport": "1234567890",
                    "date": "1997-01-01",
                    "isChild": false,
                    "phone": 9123456789
                }
            },
            "1": {
                "0": {
                    "fio": "Депардье Жерар",
                    "passport": "1234567890",
                    "date": "1990-01-01",
                    "isChild": true,
                    "phone": 9123456789
                },
                "1": {
                    "fio": "Петров Александр",
                    "passport": "1234567890",
                    "date": "1990-01-01",
                    "isChild": true,
                    "phone": 9123456789
                }
            }
        }
    }
}

Пример ответа:

{
    "success": "true",
    "error": "false",
    "data": {
        "orderId": "527153",
        "totalSum": "171157.2",
        "totalCommission": "37655",
        "waitList": true
    }
}

Помощь

Возвращает справку по 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 тура

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

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

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

Авторизация

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

Содержание

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

Пример запроса:

Список аргументов:

Пример запроса:

Список аргументов:

Пример запроса:

Список аргументов:

Пример запроса:

Список аргументов:

Пример запроса:

Список аргументов:

Пример запроса:

Список аргументов:

Пример запроса:

Список аргументов:

Пример запроса:

Список аргументов:

Пример запроса:

Список аргументов:

Пример запроса:

Список аргументов:

Пример запроса:

Список аргументов:

Пример запроса:

Список аргументов:

Пример запроса:

Список аргументов:

Структура данных:

Пример входных данных:

Пример ответа:

Пример запроса:

Список аргументов:

Пример запроса:

Список аргументов:

Пример запроса:

Список аргументов:

Пример запроса:

Список аргументов:

Пример запроса:

Список аргументов:

Пример запроса:

Список аргументов:

Пример запроса:

Список аргументов:

Пример запроса

Список аргументов