Перейти к содержимому
Блог

Сравнение travel API: оценивайте оси, а не поставщиков

Редакция Tekravel
Написано с помощью ИИ

В трёх вкладках открыты три презентации поставщиков. В каждой — слайд с длинным списком авиакомпаний, слайд с количеством отелей, песочница, REST и JSON, адрес поддержки. Вы собираете таблицу, ставите галочку в каждой клетке, и таблица заканчивается вничью. Так обычно и заканчивается сравнение travel API, построенное как чек-лист функций, — и это неправильный финал. Различия, которые определят ваш следующий год, проявляются только после запуска: в бронировании, которое прошло у поставщика, но упало по таймауту у вас; в возврате, который никто не может провести; в авиакомпании, которая была в списке, но выписать билет на неё по этому каналу нельзя.

Этот текст — для разработчика или техлида, которому принимать решение и потом его защищать. Здесь нет рейтинга поставщиков. Здесь есть оси для сравнения, план тестового периода, который тратит время на ошибки, и несколько вопросов, которые быстро показывают, с кем вы говорите: с поставщиком или с перепродавцом чужого поставщика.

Почему чек-лист функций всегда заканчивается ничьей

Чек-лист спрашивает, есть ли возможность. Почти любой travel API отвечает «да» почти на любую строку, потому что строки написаны на уровне маркетинговой страницы: поиск, ценообразование, бронирование, отмена, выписка, вебхуки, песочница. Различает их не наличие cancel, а то, что происходит, когда вы вызываете его для выписанного бронирования за двенадцать часов до вылета, на тарифе со штрафом, через канал, контент которого пришёл от третьей стороны. Для этого в чек-листе нет колонки.

Есть и вторая проблема. Чек-лист обычно заполняет сам поставщик. Вы оцениваете его самоописание.

Сравнение travel API по осям, а не по поставщикам

Замените сетку «поставщик × функция» осями, которые вы оцениваете сами, по фактам, собранным в тестовый период. Таблица ниже — та, которой пользовались бы мы. Вы можете расставить веса иначе — бизнесу, который продаёт только отели, выписка важна меньше, — и с ней стоит поспорить, прежде чем принимать.

ОсьЧто спрашивает чек-листЧто нужно выяснить на самом делеКак звучит слабый ответ
ПокрытиеСколько авиакомпаний и отелей?Сколько из них можно найти, забронировать И выписать или подтвердить через этот API — на ваших рынкахОдно большое число без разбивки
ГлубинаЕсть ли эндпоинт отмены?Какие операции после бронирования автоматизированы для каждого источника контента: void, возврат, переоформление, исправление имени, допуслуги«Этим занимается наш операционный отдел»
Достоверность ценыЦены в реальном времени?Как часто цена при бронировании отличается от цены в поиске и как API сообщает об этом«Цены всегда живые»
Смысл ошибокОшибки задокументированы?Сообщает ли ошибка, в каком состоянии бронирование, а не только что что-то сломалосьОдин общий код для любой ошибки
Идемпотентность—Может ли повторный вызов бронирования создать второе бронированиеМолчание, затем «мы такого не встречали»
Поставщик по договору—Чей договор, чей номер IATA, через какой BSP выписывается билет«Мы работаем со всеми крупными GDS»
Доступ и поддержкаЕсть ли песочница?Кто отвечает, когда завис реальный PNR, и как быстроФорма обращения без конкретного контакта

Для двух из этих строк в обычном чек-листе вообще нет вопроса. Это не случайность: именно они обходятся дороже всего, когда что-то идёт не так, и именно о них презентация поставщика вряд ли расскажет сама.

Покрытие — это не глубина

Список авиакомпаний — самый обманчивый слайд любой презентации. Список из нескольких сотен перевозчиков может означать разные вещи, и лишь одна из них — то, что вам нужно.

Часть перевозчиков идёт через GDS, их можно забронировать и выписать от начала до конца. Часть — через NDC-подключения, где поиск может работать хорошо, а обслуживание после бронирования — изменения, частичный возврат, добавление багажа — по этой авиакомпании всё ещё может оставаться ручным. Часть — лоукостеры, чей контент агрегирован у другого перепродавца: показать их можно, иногда можно забронировать, а потом билет приходит по пути, который вы не контролируете, в срок, который вы не можете обещать клиенту. А часть попала в список потому, что однажды в ответе на поиск вернулся какой-то тариф.

Перевозчик, которого можно показать, но нельзя выписать, — не покрытие. Для розничного продукта это хуже, чем его отсутствие: клиент выбирает, платит и ждёт.

С отелями та же картина, другими словами. Число объектов включает и смапленные поставщиком, и несмапленные; статические цены из кэша прошлой недели рядом с живой доступностью; номера по аллотменту с релиз-периодом рядом с free-sale. Попросите число объектов, доступных для живого бронирования в ваших городах, и спросите, как сводятся дубли между их собственными поставщиками: один и тот же отель трижды по трём ценам — это обращение в поддержку, которое просто ждёт своего часа.

Практический тест узкий. Выпишите двадцать направлений и двадцать отельных городов, на которые приходится основной объём, — скажем, Москва–Дубай, Москва–Анталья, Алматы–Стамбул — и попросите поставщика показать в песочнице именно их от начала до конца: поиск, цена, бронирование, выписка или подтверждение, отмена. У кого есть глубина, сделает это без лишних слов. У кого есть только слайд, начнёт рассказывать про слайд.

Что проверять в тестовый период: пути ошибок, а не счастливый сценарий

Любая песочница успешно бронирует билет в одну сторону в экономе на спокойном направлении. Ради этого её и строили. А ваш реальный трафик заметную часть жизни проведёт на других путях, и тестовый период — единственный дешёвый момент их увидеть.

Пройдите в тестовый период этот список и записывайте рядом, что вернул API и что оказалось правдой потом:

  • Изменение цены между поиском и бронированием. Бронирование падает, проходит по новой цене или возвращает отдельный ответ с просьбой подтвердить? Может ли ваш интерфейс различить эти случаи, не разбирая текст сообщения?
  • Истёкшее предложение. Поищите, подождите дольше времени жизни предложения, затем бронируйте. Истечение — отдельная ошибка или та же, что «поставщик недоступен»?
  • Мест нет в момент бронирования. Инвентарь исчез между прайсингом и бронированием. В каком состоянии бронирование и снимается ли авторизация платежа?
  • Повтор после таймаута. Отправьте запрос на бронирование, оборвите соединение до ответа, отправьте снова. У вас теперь один PNR или два? Один этот тест скажет о поставщике больше, чем весь остальной тестовый период.
  • Бронирование создано, выписка не прошла. Может ли API сообщить о существующем, но не выписанном PNR, и называет ли он тайм-лимит выписки?
  • Частичный сбой. Запрос на несколько номеров, где один подтверждён, а другой нет. Перелёт туда-обратно, где плечи пришли из разных источников.
  • Отмена вне бесплатного окна. Штраф показывается до подтверждения или обнаруживается в счёте?
  • Отказ поставщика. Спросите, как его смоделировать. Если никак — спросите, как поведение системы узнали их клиенты.

В каждом случае вы оцениваете две вещи. Говорит ли API правду о состоянии бронирования? И может ли ваш код действовать на основании этой правды, не заставляя человека читать свободный текст? С API, который падает понятно, жить проще, чем с API, который проходит двусмысленно.

Авиационную сторону мы подробнее разобрали в тексте о чём молчит документация API бронирования авиабилетов, а проектирование клиента для медленных отельных поставщиков — в статье про доступность отелей. Обе хорошо дополняют план тестирования.

Вопросы, которые выдают «тонкого» агрегатора

В агрегаторе нет ничего плохого. Большая часть travel-контента доходит до большинства продавцов через агрегаторов. Риск — в «тонком»: слое, который перепродаёт API другого слоя, добавляет наценку и не владеет ни договором с поставщиком, ни операционным отделом. Когда что-то ломается, ответ должен пройти через две компании вверх и вернуться обратно.

Пять вопросов быстро это выявляют:

  1. Кто поставщик этого бронирования по договору? На чьём договоре с авиакомпанией или отелем оно держится?
  2. Под чьим номером IATA и через какой BSP выписывается билет? Если ответ — «партнёра», спросите, кому приходит ADM, когда нарушено тарифное правило.
  3. Что происходит у вас, когда я вызываю отмену? Автоматический вызов поставщику или очередь, которую разбирает человек?
  4. Могу ли я увидеть исходную ошибку? Тонкий слой обычно сводит любую ошибку к одному коду, потому что не до конца понимает ошибки, которые получает.
  5. Кому я звоню по зависшему реальному бронированию и кому звонит он? Посчитайте звенья.

Ни один из этих ответов сам по себе не исключает поставщика. Номер IATA партнёра может быть нормой, если в договоре ясно сказано, кто несёт дебет-ноту. Важно, чтобы поставщик отвечал точно и быстро. Размытые ответы здесь — это те же ответы, которые вы получите потом, в продакшене, в худший час.

Во что обходится неверный выбор

Интеграция — дешёвая часть. Дорогие части приходят позже и не попадают ни в одну оценку.

Ошибка двойного бронирования — это клиент, с которого списали дважды, и PNR, который надо найти и отменить вручную, возможно, уже после закрытия бесплатного окна void. Бронирование, прошедшее у источника, пока ваша система записала сбой, — это место, которое удержали и потом автоматически сняли, и клиент, уверенный, что он забронирован. Перевозчик, которого вы показали, но не смогли выписать, — это возврат, извинения и клиент, который не вернётся. ADM за тарифное правило, нарушенное каналом поставщика, падает на того, кому принадлежит билет, — заранее выясните, не вы ли это.

И есть цена смены поставщика. Каждая особенность поставщика, которую вы поглощаете, — статус с двумя значениями, поле, которое иногда строка, — оседает в вашей модели данных. Через два года выбор API уже не интеграция, которую можно заменить за спринт; это форма вашей таблицы бронирований. Вот настоящая причина сравнивать внимательно сейчас.

Где в этой схеме наш собственный API

Мы предоставляем API для авиа и отелей. Доступ начинается с разговора, а не с ключа самообслуживания; некоторым разработчикам это кажется медленным. Причина в том, что именно в этом разговоре вопросы выше задаются в обе стороны: какие направления и города вам нужны, какой контент вы действительно сможете выписать или подтвердить, кто за что отвечает после бронирования. Если вы проводите сравнение, принесите этот список с собой. Страница travel API — место, где этот разговор начинается.

Что бы вы ни выбрали, выбирайте по журналу тестов, а не по презентации. Презентация говорит, кем поставщик хочет быть. Пути ошибок говорят, кто он есть.

Редакция Tekravel

Отдел travel-технологий

Отдел travel-технологий Tekravel пишет для профессионалов рынка: владельцев агентств, консолидаторов и разработчиков, которые их интегрируют. Каждая статья проверяется на той самой платформе, которую описывает, до публикации.