Технологии
Партнёрский поисковый контракт целиком. Эндпоинты, семантика ошибок, устройство идентичности цены и что происходит с истёкшей котировкой. Если что-то здесь не ложится в вашу интеграцию, мы это меняем — примеры доработок на странице дистрибуции.
Эндпоинты
Поиск
Живой поиск. Синхронный JSON-массив бронируемых вариантов: ни поллинга, ни предварительного открытия сессии. Холодный маршрут отвечает до 15 секунд, повторный запрос по тому же направлению — за десятки миллисекунд.
Маршруты
Справочник маршрутов: пары IATA-кодов в обеих ориентациях, считается на лету по текущему инвентарю, а не отдаётся статикой. Без авторизации — забрать можно до того, как мы выдадим ключ.
Статистика
Сверка заказов: статусы, суммы, ваши marker и market в ответе. XML по умолчанию, JSON через заголовок Accept.
Поведение
Ошибки
Проблемы валидации никогда не дают ошибочный статус. Нераспознанный город, некорректная дата или невозможный состав пассажиров возвращают HTTP 200 с пустым массивом — плохой запрос с вашей стороны не превратится в сбой на нашей. Единственный статус отказа — HTTP 401 на неизвестный ключ. Всё остальное трактуйте как пустой результат.
Идентичность цены
Идентификатор варианта производен от его финальной цены во всех валютах, состава пассажиров и вашего партнёрского аккаунта. Цена под идентификатором измениться не может, потому что он из неё и посчитан. Любое движение цены рождает новый идентификатор, а исходный вариант продолжает отдаваться и бронироваться по выданной цене.
Окно бронирования
60 минут с момента котировки. У переданного пассажиру варианта всегда остаётся не меньше 45 минут: из кеша мы не отдаём котировку старше 15 минут. До истечения котировка незаметно обновляется; если цена к этому моменту изменилась, пассажир видит обе суммы и подтверждает выбор, только после этого разблокируется оплата.
Диплинк
https://gtavia.com/{locale}/booking/{variantId}?currency={code}Локали: en, ru, ka. variantId — та самая идентичность цены. Ваши marker и market проходят через весь флоу бронирования, сохраняются в заказе и возвращаются в /partners/statistics.
Другие каналы
Почасовой прайс-фид
Для фидовых потребителей раз в час выгружаем весь продаваемый инвентарь в CSV по SFTP: маршруты, номера рейсов, даты вылета, наличие мест, цены OW, RT и инфантов, варианты багажа и даты окончания продажи. Точный состав колонок и детали доставки — в техпакете. Сейчас работает с европейской дистрибуционной платформой.
Сверка
GET /partners/statistics возвращает ваши заказы со статусами, суммами, валютой и значениями marker и market, зафиксированными при бронировании. Используйте для периодических взаиморасчётов; помесячный отчёт сверки готовится и на нашей стороне.
Нужно что-то другое
Другая схема, другой транспорт, push вместо pull — это запрос, а не ограничение. Типовой срок кастомного контракта 1–4 недели. Пишите на team@gtavia.com.