本文へスキップ
ブログ

旅行APIのサンドボックステスト:サンドボックスが見せてくれない本番の落とし穴

Tekravel 編集部
AI の支援を受けて執筆

その連携は、旅行APIのサンドボックス(sandbox)テストで投げられるものをすべてパスしました。検索はフライトを返し、ホテルの空室照会は部屋を返し、予約APIは毎回欠かさず確認番号を返しました。QAは木曜日に承認を出しました。翌週の火曜日、ある顧客はホテル代をある金額で支払ったのに、サプライヤーは別の金額で予約を確定しました。フライト予約が一件タイムアウトし、座席が押さえられているのかどうか誰にも答えられませんでした。サポート担当者は、同じ旅行を表す二つのレコードの突き合わせに午後をまるごと費やしました。どれもテストスイートが見逃したバグではありません。テストスイートには、そもそも見る手段がなかったシナリオです。サンドボックスは必要ですが、十分とはほど遠い。その差にこそ、旅行系の連携で起きる高くつくインシデントの大半が潜んでいます。

本記事は、その連携を担当する開発者のためのテスト計画です。サンドボックスで証明できること、構造上どうしても証明できないこと、そして会社のカードで本物の座席を予約せずにその差を埋める方法を整理します。

旅行APIのサンドボックステストを通ったコードが本番で壊れる理由

サンドボックスが約束するのはレスポンスの「形」であって、「振る舞い」ではありません。スキーマは本番と一致します。しかし振る舞いはほぼ一致しません。誰かの落ち度ではなく、事情があります。テスト環境ではライブ在庫を動かす余裕がないため、売り切れず、価格も変わらず、スケジュール変更も起きない固定の運賃と客室を返します。ほかに誰も使っていないので応答は速く、途中で失敗することもめったにありません。

本番では、そのすべてが毎日起きます。在庫はほかのすべての販売者と共有され、運賃は上流の誰かがキャッシュしていて古くなり、負荷のかかったサプライヤーのシステムは遅く応答するか、まったく応答しません。サンドボックスしか経験していないコードは、実質的に「サプライヤーが絶好調の日」に対してしかテストされていないのです。

ですから、サンドボックスは三層のうちの一層として扱いましょう。サンドボックスは、リクエストが正しい形式で、パーサーがスキーマを理解していることを証明します。記録したフィクスチャは、本番が実際に送ってくるレスポンスにコードが耐えられることを証明します。意図して絞り込んだ少数のライブチェックは、何かが変わった後も配線が正しいことを証明します。各層は、ほかの二層では捕まえられないものを捕まえます。

サンドボックスでは通常再現できないシナリオ

テストを一本書く前に、まずこれらを書き出してください。サンドボックスが特別なテスト値で一つか二つを模擬できることはありますが、ほとんどはそもそも用意されていません。

シナリオ本番で起きることカバーする方法
検索から予約までの間の価格変更予約APIが異なる合計金額で成功する、または価格変更エラーで失敗し、それをユーザーに提示する必要があるフィクスチャの組:検索レスポンスと、合計金額が異なる予約レスポンス。旅行者に再確認を求め、黙って課金しないことをアサートする
空室確認から予約までの間の売り切れ提示した客室や運賃クラスが、確保しようとした時点でなくなっているサプライヤーの実際の売り切れエラーのフィクスチャ。旅行者がエラーページではなく検索結果に戻されることをアサートする
予約APIのタイムアウトサプライヤー側で予約が作成されたかどうかわからないリクエスト送信後にタイムアウトを注入する。何かがリトライする前に予約ステータスを照会することをアサートする
二重送信ダブルクリックやクライアントのリトライで予約が二件できる同じidempotency key(冪等性キー)で同じ予約を二回送る。予約がちょうど一件だけ存在することをアサートする
発券後のスケジュール変更販売したフライトの出発時刻が変わる、または別の便名になる変更された旅程のフィクスチャ。その変更が顧客を担当する人まで届くことをアサートする
複数商品の予約での部分的成功フライトは確定し、ホテルは確定しない混在フィクスチャ。システムが確定した内容を正確に記録し、人にアラートを出すことをアサートする
高負荷時のスロットリングレート制限のレスポンスが返り、その後応答が遅くなる記録したスロットリングのレスポンスを再生する。バックオフすること、そして検索がエラーではなく段階的に縮退することをアサートする

右端の列は、自分のスタックでは違うと思うかもしれません。それで構いません。大事なのは、すべての行にオーナーとアサーションがあることです。どの行も、いずれ必ずあなたの身に起きるからです。

フィクスチャは想像ではなく実際のレスポンスから作る

旅行系の連携でいちばん役に立つ習慣は、驚かされたレスポンスを保存しておくことです。手書きのモックデータは、サプライヤーが送ってくるだろうとあなたが考えるものを反映します。記録したレスポンスは、実際に送られてきたものを反映します。ドキュメントでは空にならないとされているのに空のフィールド、頼んでいない通貨で返ってくる価格、成功ステータス付きで届くエラーまで含めてです。

うまく回る手順は次のとおりです。

  • 境界で記録する。サプライヤー呼び出しのリクエストとレスポンスの生のボディを、本番以外の環境でログに残します。プライバシー規定が許すなら、本番でもトラフィックの一部をサンプリングして記録します。
  • 保存する前にマスクする。乗客名、パスポート番号、メールアドレス、電話番号、決済の参照番号は、フィクスチャがリポジトリに入る前に取り除きます。一目で偽物とわかる値に置き換え、誰もフィクスチャを本物の予約と取り違えないようにします。
  • フィクスチャには振る舞いで名前を付ける。hotel-book-price-increased.jsonなら、次の開発者にそれが存在する理由が伝わります。response-17.jsonでは伝わりません。
  • 厄介なものは永久に残す。ある日曜日に検索をダウンさせた不正な形式のレスポンスは、あなたが持つ中で最も価値のあるファイルです。毎コミットで走るテストに入れておくべきです。

そのうえで、これらのフィクスチャに対してコントラクトテストを書きます。対象はパーサー、内部モデルへのマッピング、エラーの分類です。サプライヤーがフィールド名を変えてコントラクトテストが落ちれば、顧客からではなくCIで気づけます。分類の部分については、予約エンジンAPIのエラー処理に関する記事でさらに詳しく扱っています。

お金を使わずにお金の流れをテストする

ここはサンドボックスが最も役に立たない領域です。お金の流れこそ、テスト環境が本物と食い違う場所だからです。実際の発券、実際のカード決済の確定、実際のサプライヤー請求は、最も正しくしなければならない一方で、本番でリハーサルするのが最も難しいものです。

問題を分けましょう。価格計算は純粋なロジックなので、オフラインで網羅的にテストできます。記録した運賃にマークアップのルール、通貨換算、端数処理を適用し、旅行者に表示される合計金額をアサートします。厄介なケースでも試してください。ある通貨の運賃を別の通貨で販売する場合、ある商品ではパーセンテージ、別の商品では固定額のマークアップ、子ども運賃、表示時と課金時で異なる端数処理のステップなどです。数単位ずれた合計金額も間違いは間違いであり、しかもすべての予約で間違えることになります。

後半は、決済まわりの状態遷移です。見積済み、確保済み、支払済み、確定済み、発券済み、キャンセル済み、返金済みといった状態を明示的にモデル化し、すべての遷移の原因がちょうど一つであることをテストします。最も高くつくバグを捕まえるテストは、サプライヤーが確定していない予約に対して決済を確定できないこと、そして決済レコードのない確定済み予約が存在し得ないことをアサートするテストです。

最後に、テストの実行が本番の発券に到達することを不可能にしてください。「起こりにくい」ではなく「不可能」です。本番の認証情報が読み込まれているときにスイートの実行を拒否する起動時チェックは、一行で書けて、連携チームが迎えうる最悪の朝を防ぎます。

間違えたときに払うコスト

旅行系の連携で見落としたシナリオが、エラーとして表に出ることはまれです。一見問題のない予約として現れます。誰も頼んでいない重複発券で、期限前に誰かがvoidしなければならないもの。代理店が差額をかぶるしかない価格で確定したホテル。タイムアウトした予約をシステムがリトライした結果、サプライヤーが二部屋を押さえ、両方を請求してくるケース。代理店経由で販売した航空券なら、発券内容と販売内容の不一致が、その販売の利益をとうに使い切った後になってADMとして戻ってくることがあります。

こうしたコストを負うのは、旅行を販売した事業者であり、リトライのループを書いた開発者ではありません。サポートチケット一件ずつで学ぶのではなく、ローンチ前にテストすべき理由は、まさにそこにあります。

サプライヤー側の変更のたびに行うスモークテスト

サプライヤーは物事を変えます。新しいAPIバージョン、新しいエンドポイント、ローテーションされた認証情報、異なるコンテンツマッピングなどです。自分たちのコードはまったく変わっていないかもしれません。それでも、変更のあったサプライヤーと通信する環境で、次のリストを実行してください。

  1. そのサプライヤーから販売している商品ごとに、結果が返ることがわかっている路線や都市で検索を一回ずつ行う。
  2. すべての結果を、黙って落とすことなくパースする。件数を生のレスポンスに含まれる件数と比較する。
  3. 一件の結果をエンドツーエンドで価格計算し、表示された合計金額を、生の運賃から自分で計算した値と比較する。
  4. テスト環境で予約を作成し、そのステータスを読み戻して、保存しているすべてのフィールドを比較する。
  5. その予約をキャンセルし、キャンセルが自社の記録とサプライヤー側の両方で確認できることを確かめる。
  6. 保存しておいた厄介なフィクスチャを、新しいパーサーで再生する。
  7. タイムアウトとレート制限が、決めておいた振る舞いにまだ対応しているか確認する。新しいバージョンではこれらへの応答が変わっている可能性があるからです。応答時間が変わったなら、レイテンシに関する記事で、そのうちどこが自分で直せる部分かを説明しています。

毎回実行できるほど短いこと、それが肝心です。丸一日かかるせいで誰も実行しないスモークテストは、スモークテストではありません。

サンドボックスの正しい位置づけ

ここまでの話で、サンドボックスの価値が下がるわけではありません。むしろ正直な位置づけになります。スキーマを学び、リクエストが正しいことを確認する場所であり、そこから先の届かない部分はフィクスチャとライブチェックが引き継ぎます。このプラットフォームのフライトAPIとホテルAPIを評価しているなら、利用はセルフサービスのキー発行ではなく、対話から始まります。このテスト計画をその対話に持ち込み、上の表の各行がどのようにカバーされるのかを尋ねてください。その答えは、ドキュメント以上にそのAPIについて多くを教えてくれるはずです。

Tekravel 編集部

旅行テクノロジー担当

Tekravelの旅行テクノロジー担当は、業界の読者に向けて書いています。旅行会社の経営者、ホールセラー、そして両者をつなぐ開発者です。すべての記事は、公開前に記事が扱うプラットフォーム上で確認されます。