Логика работы с API
Для работы с API необходимо быть подписанным на необходимые услуги API-интеграции. У каждого метода API указана своя обязательная услуга (в противном случание метод будет возвращать ошибку).
В настройках личного кабинета нужно сгенерировать токен. IP адрес устанавливать не обязательно, он автоматически установится после первого запроса к API. IP адрес с которого отправляются запросы должен соответствовать IP адресу в личном кабинете.
В каждом запросе к API обязательно нужно передавать сгенерированный токен в заголовке.
Цепочка необходимых методов для бронирования тура:
-> Загрузка справочников для формы поиска методами Параметры поиска и Фильтр параметров
-> Поиск туров методом Поиск туров
-> Получение данных о туре Данные о туре, Валидация тура (желательно, для проверки актуальности), Бронирование
В настройках личного кабинета нужно сгенерировать токен. IP адрес устанавливать не обязательно, он автоматически установится после первого запроса к API. IP адрес с которого отправляются запросы должен соответствовать IP адресу в личном кабинете.
В каждом запросе к API обязательно нужно передавать сгенерированный токен в заголовке.
Цепочка необходимых методов для бронирования тура:
-> Загрузка справочников для формы поиска методами Параметры поиска и Фильтр параметров
-> Поиск туров методом Поиск туров
-> Получение данных о туре Данные о туре, Валидация тура (желательно, для проверки актуальности), Бронирование
Методы для формы поиска туров
Параметры поиска - Получение справочников: типы туров, валюты, страны, группы стран, регионы, рейтинги отелей, типы транспортов
Поиск направления - Поиск стран, регионов, отелей по искомому слову
Фильтр параметров - Получение справочников: отели, типы питаний, города отправления
Поиск направления - Поиск стран, регионов, отелей по искомому слову
Фильтр параметров - Получение справочников: отели, типы питаний, города отправления
Методы для поиска туров
Поиск туров - Поиск туров с группировкой по отелю, с сортировкой по возрастанию цены
Поиск туров списком - Поиск туров списком (без группировки по отелю), с сортировкой по возрастанию цены
Поиск туров по ключу - Поиск туров по ключам (без группировки по отелю). Для реализации функционала избранных туров
Поиск туров списком - Поиск туров списком (без группировки по отелю), с сортировкой по возрастанию цены
Поиск туров по ключу - Поиск туров по ключам (без группировки по отелю). Для реализации функционала избранных туров
Методы для поиска туров
Данные о туре - Получение подробной информации о туре с перелетами и информацией по отелю
Валидация тура - Проверка актуальности тура на сайте у туроператора
Данные о рейсах - Получение данных о перетах в туре
Создать запрос - Создание запроса по интересующему туру
Бронирование - Бронирование тура
Онлайн-оплата - Онлайн оплата тура через платежную систему LiqPay (необходимо иметь ключи доступа к сервису LiqPay)
Валидация тура - Проверка актуальности тура на сайте у туроператора
Данные о рейсах - Получение данных о перетах в туре
Создать запрос - Создание запроса по интересующему туру
Бронирование - Бронирование тура
Онлайн-оплата - Онлайн оплата тура через платежную систему LiqPay (необходимо иметь ключи доступа к сервису LiqPay)
Методы для работы с Заявкой
Онлайн-оплата - Возвращает HTML форму для оплаты заявки.
Документы бронирования - Возвращает статус и документы бронирования по заявке
Статус бронирования - Возвращает статус бронирования заявки, статус документов а так же изменения времени вылета рейсов
Получение договора - Получение сгенерированного договора с туристом
Документы бронирования - Возвращает статус и документы бронирования по заявке
Статус бронирования - Возвращает статус бронирования заявки, статус документов а так же изменения времени вылета рейсов
Получение договора - Получение сгенерированного договора с туристом
Методы для работы с Экскурсионной заявкой
Онлайн-оплата - Возвращает HTML форму для оплаты заявки.
Документы бронирования - Возвращает статус и документы бронирования по заявке
Статус бронирования - Возвращает статус бронирования заявки
Получение договора - Получение сгенерированного договора с туристом
Документы бронирования - Возвращает статус и документы бронирования по заявке
Статус бронирования - Возвращает статус бронирования заявки
Получение договора - Получение сгенерированного договора с туристом
Методы для работы с отелем
Отзывы - Получение отзывов по отелю с оценками отеля
Диаграмма цен - Диаграмма минимальных цен по отелю с группировкой по датам (интервал не более 30 дней)
Диаграмма цен - Диаграмма минимальных цен по отелю с группировкой по датам (интервал не более 30 дней)
Получение дополнительных справочников
Гражданство - Возвращает список гражданств. Необходим для отправки пасспортных данных туриста при бронировании тура.
Типы комнат - Возвращает наименования типов комнат
Размещения - Возвращает наименования размещений
Характеристики отелей - Возвращает список характеристик отелей, ключ 'Код характеристики'
Услуги, категории услуг отелей - Возвращает список услуг отелей (ключ 'id'), категории услуг (ключ 'category_id'
Фото стран - Возвращает фото стран
Аэропорты - Возвращает список аэропортов
Визовые требования - Возвращает список визовых требований по стране
Типы Виз - Возвращает список типов виз для заполнения паспортных данных туристов
Типы комнат - Возвращает наименования типов комнат
Размещения - Возвращает наименования размещений
Характеристики отелей - Возвращает список характеристик отелей, ключ 'Код характеристики'
Услуги, категории услуг отелей - Возвращает список услуг отелей (ключ 'id'), категории услуг (ключ 'category_id'
Фото стран - Возвращает фото стран
Аэропорты - Возвращает список аэропортов
Визовые требования - Возвращает список визовых требований по стране
Типы Виз - Возвращает список типов виз для заполнения паспортных данных туристов
-
Пример ответа
Схема ответа
{}(required) (optional)