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

В трёх вкладках открыты три презентации поставщиков. В каждой — слайд с длинным списком авиакомпаний, слайд с количеством отелей, песочница, 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 другого слоя, добавляет наценку и не владеет ни договором с поставщиком, ни операционным отделом. Когда что-то ломается, ответ должен пройти через две компании вверх и вернуться обратно.
Пять вопросов быстро это выявляют:
- Кто поставщик этого бронирования по договору? На чьём договоре с авиакомпанией или отелем оно держится?
- Под чьим номером IATA и через какой BSP выписывается билет? Если ответ — «партнёра», спросите, кому приходит ADM, когда нарушено тарифное правило.
- Что происходит у вас, когда я вызываю отмену? Автоматический вызов поставщику или очередь, которую разбирает человек?
- Могу ли я увидеть исходную ошибку? Тонкий слой обычно сводит любую ошибку к одному коду, потому что не до конца понимает ошибки, которые получает.
- Кому я звоню по зависшему реальному бронированию и кому звонит он? Посчитайте звенья.
Ни один из этих ответов сам по себе не исключает поставщика. Номер IATA партнёра может быть нормой, если в договоре ясно сказано, кто несёт дебет-ноту. Важно, чтобы поставщик отвечал точно и быстро. Размытые ответы здесь — это те же ответы, которые вы получите потом, в продакшене, в худший час.
Во что обходится неверный выбор
Интеграция — дешёвая часть. Дорогие части приходят позже и не попадают ни в одну оценку.
Ошибка двойного бронирования — это клиент, с которого списали дважды, и PNR, который надо найти и отменить вручную, возможно, уже после закрытия бесплатного окна void. Бронирование, прошедшее у источника, пока ваша система записала сбой, — это место, которое удержали и потом автоматически сняли, и клиент, уверенный, что он забронирован. Перевозчик, которого вы показали, но не смогли выписать, — это возврат, извинения и клиент, который не вернётся. ADM за тарифное правило, нарушенное каналом поставщика, падает на того, кому принадлежит билет, — заранее выясните, не вы ли это.
И есть цена смены поставщика. Каждая особенность поставщика, которую вы поглощаете, — статус с двумя значениями, поле, которое иногда строка, — оседает в вашей модели данных. Через два года выбор API уже не интеграция, которую можно заменить за спринт; это форма вашей таблицы бронирований. Вот настоящая причина сравнивать внимательно сейчас.
Где в этой схеме наш собственный API
Мы предоставляем API для авиа и отелей. Доступ начинается с разговора, а не с ключа самообслуживания; некоторым разработчикам это кажется медленным. Причина в том, что именно в этом разговоре вопросы выше задаются в обе стороны: какие направления и города вам нужны, какой контент вы действительно сможете выписать или подтвердить, кто за что отвечает после бронирования. Если вы проводите сравнение, принесите этот список с собой. Страница travel API — место, где этот разговор начинается.
Что бы вы ни выбрали, выбирайте по журналу тестов, а не по презентации. Презентация говорит, кем поставщик хочет быть. Пути ошибок говорят, кто он есть.