IT-Tour API Документация

Логика работы с API

Для работы с API необходимо быть подписанным на необходимые услуги API-интеграции. У каждого метода API указана своя обязательная услуга (в противном случание метод будет возвращать ошибку).
В настройках личного кабинета нужно сгенерировать токен. IP адрес устанавливать не обязательно, он автоматически установится после первого запроса к API. IP адрес с которого отправляются запросы должен соответствовать IP адресу в личном кабинете.

В каждом запросе к API обязательно нужно передавать сгенерированный токен в заголовке.

Цепочка необходимых методов для бронирования тура:
-> Загрузка справочников для формы поиска методами Параметры поиска и Фильтр параметров
-> Поиск туров методом Поиск туров
-> Получение данных о туре Данные о туре, Валидация тура (желательно, для проверки актуальности), Бронирование

Методы для формы поиска туров

Параметры поиска - Получение справочников: типы туров, валюты, страны, группы стран, регионы, рейтинги отелей, типы транспортов
Поиск направления - Поиск стран, регионов, отелей по искомому слову
Фильтр параметров - Получение справочников: отели, типы питаний, города отправления

Методы для поиска туров

Поиск туров - Поиск туров с группировкой по отелю, с сортировкой по возрастанию цены
Поиск туров списком - Поиск туров списком (без группировки по отелю), с сортировкой по возрастанию цены
Поиск туров по ключу - Поиск туров по ключам (без группировки по отелю). Для реализации функционала избранных туров

Методы для поиска туров

Данные о туре - Получение подробной информации о туре с перелетами и информацией по отелю
Валидация тура - Проверка актуальности тура на сайте у туроператора
Данные о рейсах - Получение данных о перетах в туре
Создать запрос - Создание запроса по интересующему туру
Бронирование - Бронирование тура
Онлайн-оплата - Онлайн оплата тура через платежную систему LiqPay (необходимо иметь ключи доступа к сервису LiqPay)

Методы для работы с Заявкой

Онлайн-оплата - Возвращает HTML форму для оплаты заявки.
Документы бронирования - Возвращает статус и документы бронирования по заявке
Статус бронирования - Возвращает статус бронирования заявки, статус документов а так же изменения времени вылета рейсов
Получение договора - Получение сгенерированного договора с туристом

Методы для работы с Экскурсионной заявкой

Онлайн-оплата - Возвращает HTML форму для оплаты заявки.
Документы бронирования - Возвращает статус и документы бронирования по заявке
Статус бронирования - Возвращает статус бронирования заявки
Получение договора - Получение сгенерированного договора с туристом

Методы для работы с отелем

Отзывы - Получение отзывов по отелю с оценками отеля
Диаграмма цен - Диаграмма минимальных цен по отелю с группировкой по датам (интервал не более 30 дней)

Получение дополнительных справочников

Гражданство - Возвращает список гражданств. Необходим для отправки пасспортных данных туриста при бронировании тура.
Типы комнат - Возвращает наименования типов комнат
Размещения - Возвращает наименования размещений
Характеристики отелей - Возвращает список характеристик отелей, ключ 'Код характеристики'
Услуги, категории услуг отелей - Возвращает список услуг отелей (ключ 'id'), категории услуг (ключ 'category_id'
Фото стран - Возвращает фото стран
Аэропорты - Возвращает список аэропортов
Визовые требования - Возвращает список визовых требований по стране
Типы Виз - Возвращает список типов виз для заполнения паспортных данных туристов
  • Параметры

    *

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

    Ответные сообщения

    Заголовки запроса

    *

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

    Схема ответа

    {}
    (required) (optional)