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

Тестирование travel API в песочнице: чего sandbox не покажет

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

Интеграция прошла всё, что могло ей предложить тестирование travel API в песочнице. Поиск возвращал рейсы, запрос доступности отелей возвращал номера, вызов бронирования каждый раз отдавал номер подтверждения, и QA подписал релиз в четверг. Во вторник клиент оплатил отель по одной цене, а поставщик подтвердил его по другой; бронирование рейса упало по таймауту, и никто не мог сказать, держится ли место; сотрудник поддержки потратил полдня, сводя две записи об одной и той же поездке. Ничто из этого не было багом, который пропустили тесты. Это были сценарии, которые тестам просто негде было увидеть. Песочница необходима, но её далеко не достаточно, и именно в зазоре между этими двумя словами живёт большинство дорогих инцидентов в интеграции с туристическими поставщиками.

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

Почему код, прошедший песочницу, ломается в продакшне

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

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

Поэтому считайте песочницу одним слоем из трёх. Она доказывает, что запросы корректны и парсер понимает схему. Записанные фикстуры доказывают, что код выдерживает ответы, которые продакшн присылает на самом деле. Небольшой осознанный набор живых проверок доказывает, что всё правильно соединено после любого изменения. Каждый слой ловит то, что пропускают два других.

Сценарии, которых в песочнице обычно нет

Запишите их до того, как напишете первый тест. Песочница может сымитировать один-два из них специальным тестовым значением; большинства в ней просто нет.

СценарийЧто делает продакшнКак покрыть
Цена изменилась между поиском и бронированиемБронирование проходит с другой суммой или падает с ошибкой изменения цены, которую нужно показатьПара фикстур: ответ поиска и ответ бронирования с другой суммой; проверить, что путешественника спрашивают заново, а не списывают молча
Распродано между доступностью и бронированиемПредложенного номера или тарифного класса уже нет в момент блокировкиФикстура настоящей ошибки «нет мест» от поставщика; проверить, что путешественник возвращается к результатам, а не на страницу ошибки
Таймаут на вызове бронированияПоставщик мог создать бронь, а мог и не создатьВнедрить таймаут после отправки запроса; проверить, что статус брони запрашивается до любого повтора
Повторная отправкаДвойной клик или повтор на клиенте создаёт две брониОтправить одну и ту же бронь дважды с одним idempotency key; проверить, что существует ровно одна
Смена расписания после выпискиПроданный рейс вылетает в другое время или под другим номеромФикстура изменённого маршрута; проверить, что изменение доходит до того, кто ведёт клиента
Частичный успех составного бронированияПерелёт подтверждён, отель нетСмешанная фикстура; проверить, что система фиксирует ровно то, что подтверждено, и поднимает тревогу для человека
Ограничение частоты под нагрузкойОтветы rate limit, затем медленные ответыПроиграть записанный ответ троттлинга; проверить backoff и то, что поиск деградирует, а не падает

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

Фикстуры из настоящих ответов, а не придуманных

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

Рабочий порядок:

  • Записывайте на границе. Логируйте сырые тела запросов и ответов к поставщикам вне продакшна, а в продакшне — для выборки трафика, если это позволяют ваши правила о персональных данных.
  • Чистите перед сохранением. Имена пассажиров, номера паспортов, e-mail, телефоны и платёжные ссылки удаляются до того, как фикстура попадёт в репозиторий. Замените их явно фальшивыми значениями, чтобы никто не принял фикстуру за настоящую бронь.
  • Называйте по поведению. hotel-book-price-increased.json объясняет следующему разработчику, зачем файл существует; response-17.json — нет.
  • Уродливые храните вечно. Битый ответ, который однажды в воскресенье уронил поиск, — самый ценный файл, что у вас есть. Его место в тесте, который запускается на каждый commit.

Затем пишите контрактные тесты на эти фикстуры: парсер, маппинг во внутренние модели, классификацию ошибок. Если поставщик переименует поле и контрактный тест упадёт, вы узнаете об этом в CI, а не от клиента. Классификацию ошибок мы подробнее разобрали в статье об обработке ошибок API движка бронирования.

Тестирование денежных путей без трат

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

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

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

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

Во что обходится ошибка

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

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

Smoke-тест после каждого изменения у поставщика

Поставщики меняют всё подряд: новая версия API, новый эндпоинт, обновлённые учётные данные, другой маппинг контента. Ваш собственный код мог не измениться вовсе. Всё равно пройдите этот список в среде, которая общается с изменившимся поставщиком:

  1. Один поиск по каждому продукту, который вы продаёте через этого поставщика, на направлении или городе, где точно есть результаты, например Москва–Дубай.
  2. Распарсить все результаты, ничего не отбрасывая молча; сравнить количество с сырым ответом.
  3. Оценить один результат от начала до конца и сравнить показанную сумму со своим расчётом от сырого тарифа.
  4. Сделать бронь в тестовой среде, прочитать её статус и сравнить каждое сохраняемое поле.
  5. Отменить её и убедиться, что отмена видна и у вас, и на стороне поставщика.
  6. Прогнать сохранённые уродливые фикстуры через новый парсер.
  7. Проверить, что таймауты и rate limit по-прежнему ведут к поведению, которое вы выбрали: новая версия может отвечать на них иначе. Если сдвинулось время ответа, статья о задержках объясняет, какая часть этого в ваших руках.

Достаточно коротко, чтобы запускать каждый раз, — в этом и смысл. Smoke-тест, который никто не запускает, потому что он занимает день, smoke-тестом не является.

Где место песочницы

Ничто из сказанного не делает песочницу менее полезной. Это делает её честной: местом, где вы изучаете схему и убеждаетесь, что запросы верны, прежде чем фикстуры и живые проверки возьмут на себя то, куда она не дотягивается. Если вы оцениваете API перелётов и отелей платформы, доступ начинается с разговора, а не с ключа самообслуживания, — принесите этот план тестирования на этот разговор и спросите, как будет покрыта каждая строка таблицы выше. Ответы расскажут об API больше, чем его документация.

Редакция Tekravel

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

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