本文へスキップ
ブログ

航空券価格API:画面の数字がまだ運賃ではない理由

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

デモは問題なく動きます。開発者が航空券価格APIを最安日カレンダーにつなぎ、表が数字で埋まり、部屋の全員が満足します。ところが最初の実際のお客様が日付を選び、結果ページの金額が支払いページより低いことに気づき、スクリーンショットを添えてサポートに連絡してきます。壊れているものはありません。APIは頼まれたとおりに価格についての質問に答え、サイトがその答えを約束として扱っただけです。

価格は記憶の短い提案である

航空運賃は座席に貼られた固定のラベルではありません。座席が売れるにつれて開閉する運賃クラスであり、そこに付く金額は搭乗者の構成、正確な便、関係する空港の税金、見積もりに使う通貨によって変わります。価格レスポンスはそれらすべてのスナップショットで、ある一時点に、ある一組の入力に対して撮られたものです。過去の事実として扱えば正しいものが作れますが、現在の事実として扱えば、1か月を返金対応に費やすことになります。

ですから開発者にとって有益な問いは、単に価格がいくらかではありません。これはどんな種類の価格で、どれだけ古く、間違っていたときシステムは何をするのか、です。

すべて「価格」と呼ばれる3つの数字

ほとんどのプロバイダはドキュメントのどこかでこの3つすべてを返し、しかも同じフィールド名であることが少なくありません。初日から自社のデータモデルでは分けて持ってください。

状態出どころ鮮度販売できるか表示するもの
閲覧用価格キャッシュまたは集約された検索。速度と網羅性のために作られている古い可能性があり、お客様の搭乗者向けには計算されていない不可「から」という表現と変動しうるという注記
算出済みオファー正確な旅程・搭乗者タイプ・運賃に対するライブのリクエスト呼び出し時点で最新。有効期限または再計算のシグナル付き可、期限まで合計額、税の内訳、運賃ルール
発券金額注文時に航空会社または発券システムが実際に請求した額確定販売済み領収書。オファーと突き合わせる

閲覧用価格はカレンダーや「最安値から」のバッジを可能にするもので、作る価値は十分あります。ただ、2行目と同じ対象ではありません。間違いは、3つすべてが流れ込むpriceフィールドをひとつだけ置くことです。

実務では、フラグ付きの1つではなく、コード上に3つの別々の型またはテーブルを持つということです。閲覧用価格はクリックを促すだけなので、多少外れてもかまいません。算出済みオファーは自分の名前で行う約束なので、取得時刻、その値を生んだ入力、注文時にプロバイダが返却を求める識別子とともに保存します。発券金額は会計です。メールに書かれていた金額と違う額をお客様が支払った理由をサポートが尋ねるとき、答えは行と行の間の差にあり、3つすべてを保管していた場合にのみその差を読めます。

価格レスポンスに含まれているべきもの

裸の数字だけでは決済フローは作れません。プロバイダのサンプルレスポンスを読むときは次の点を探し、自由テキストで届くものは疑ってください。

  • 通貨:アカウントから推測せず、レスポンス自体に明記されていること。
  • 基本運賃と税の分離:内訳を表示でき、税の変更が運賃の変更に見えないようにするため。
  • 搭乗者タイプ:価格の計算対象。大人料金を3倍したものは家族運賃ではありません。
  • 運賃ルールと手荷物:構造化データとして。安い選択肢がお客様にとって本当に安いかを左右するからです。
  • 有効期限または再計算のシグナル:タイムスタンプ、または注文前に再計算が必要という明示的な記述。

最後の項目は見落とされがちです。レスポンスのどこにもオファーがどれだけ生きているかが書かれていなければ、推測していることになり、その推測は本番環境で行われます。

注文の後ではなく前に再計算する

最も安全なリズムにはルールが含まれています。閲覧のために検索します。お客様が旅程を選んだら、その旅程とその搭乗者に対するライブの算出済みオファーを求めます。その合計額をお客様に見せます。それから初めて注文を作成します。ライブの価格が結果ページと異なる場合は、支払い後ではなく支払い前に、分かりやすい言葉でお客様に伝えます。

中間の手順を飛ばせば、その差額を引き受けることになります。お客様が見た額より多く請求して支払いページで販売を失うか、低い数字を受け入れて差額を自社の利益から出すかのどちらかです。小さな代理店は数回なら吸収できますが、設計として吸収することはできません。

導入前に書面で尋ねること

ドキュメントは順調な経路を説明します。コストになる挙動は、短い質問リストへの回答の中にあり、その回答は通話よりメールで残しておくのが望ましいです。

  1. 検索レスポンスの価格はライブかキャッシュか。それはレスポンス自体に明記されているか。
  2. 正確な旅程に対する別個の価格算出呼び出しはあるか。注文前に必須か。
  3. 注文時に価格が動いていた場合どうなるか。拒否か、レスポンスに新価格か、新しい金額での静かな発券か。
  4. 税と運送会社の追加料金はどう内訳表示され、算出から発券までの間に変わりうるか。
  5. 価格はどの通貨で計算され、お客様が別の通貨を見る場合、換算はどこで行われるか。
  6. 算出済みオファーはどれだけ有効で、それをどう知ることができるか。

これらに正確に答えるプロバイダは、決済のことを考え抜いています。「常に最新です」と答えるプロバイダは、検証できることを何も語っていません。挙動を自分で試せないのであれば、それを前提に構築を約束する前にスタック全体を違う目で見直す理由になります。

間違えたときのコスト

大きな音を立てて失敗することはまれです。誰も価格のせいにしない決済ステップでのわずかな離脱として、「価格が変わりました」で始まるサポートチケットとして、結果ページを信じたのに今は信じないお客様として現れます。スタッフは発券前に運賃を手作業で再確認するようになります。やがて誰かが安全のために価格を切り上げるルールを提案し、サイトは人が比較する唯一の画面で高くなります。そのどれも、最初に正しく決めるのは安く済んだ判断にかかる税金のようなものです。

このプラットフォームの位置づけ

このプラットフォームは、テナントごとに有効化されるフライトとホテルのAPIを提供しています。アクセスはセルフサービスのキーではなく対話から始まるため、トークンとレート表を渡すサインアップフォームはありません。このページはレイテンシ、カバレッジ、運賃数を公表しません。試し方をお見せできない数字は掲載する価値がないからです。上の質問をその対話に持ち込み、検索だけでなく算出済みオファーのレスポンスを見せてほしいと依頼できます。その段階にいらっしゃるなら、トラベルAPIのページが出発点です。

Tekravel 編集部

旅行テクノロジー担当

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