最適な航空券予約API:まず何を作るのかを決める

依頼は一行です。最適な航空券予約APIを探してほしい。そこで比較ページを三つ開くと、どれも同じ数社を違う順番で並べ、チェックマークだらけの機能表を添えています。三つ目のページあたりで、どのページも聞いていない問いに気づきます。検索結果が返ってきた後、その顧客には何が起きるのか。
その抜けた問いこそが答えです。訪問者を航空会社のサイトへ送るページにとっての最適な航空券予約APIは、予約とカード決済を自分で受けるサイトには不向きです。旅行会社のスタッフが一日中使う社内ツールには、どちらも合いません。検索、価格確認、予約は、どのリファレンスでも同じように見えます。違いはその下にあり、どの違いが痛手になるかは製品次第です。
どれも「航空券予約サイト」と呼ばれる三つの製品
一つ目は比較サイトや旅のアイデアを見せるページです。運賃を表示し、外部へリンクし、航空券そのものには触れません。ここでのAPIはほぼ検索だけです。結果の幅と鮮度、そして表示価格が遷移先で訪問者が見る価格と十分近いかが大事です。システムが無効化も払い戻しも再発行もしないのですから、その分野でのプロバイダーの強みは活きません。
二つ目は販売します。訪問者があなたに支払い、あなたが予約し、その瞬間から予約のライフサイクル全体を抱えます。課金前の価格確定、応答の遅い航空会社への対処、当日の無効化、後日の払い戻し、顧客が日付を変えたときの再発行。この製品では検索エンドポイントは簡単な部分です。選択を決める性質はその後ろにあります。
三つ目は旅行会社自身のツールで、すでに仕入れ先との関係を持つスタッフが使います。生の検索は要点ではありません。大切なのは、自社で交渉したコンテンツが出てくること、サブエージェントに与信限度をかけられること、誰かが価格を見る前にマークアップが適用されること、そして月末にレポートがあることです。二つ目の製品に優れたAPIでも、ここでは間違った土台になりえます。
はっきり書いておきます。同じAPIが三つすべてで最適ということはありえません。そう主張するランキングは、二つ目の製品に出会ったことがないのです。
比べる価値のある性質と、それに頼るのは誰か
機能表を、開発者が本当に意見の分かれる行だけに削ってみてください。製品ごとに頼る行が違い、残りは気にしなくて構いません。
| 性質 | 送客ページ | 販売と決済 | 旅行会社スタッフ用ツール |
|---|---|---|---|
| 表示価格が確定までにどれだけ古くてよいか | 少し重要 | 決定的:その価格で課金する | 重要:スタッフがその価格で見積もる |
| 航空会社が遅いとき予約は何を返すか | 該当なし | 決定的 | 重要 |
| 誰が無効化・払い戻しでき、どう依頼するか | 該当なし | 決定的 | 決定的 |
| 結果不明の予約をどう解決するか | 該当なし | 決定的:カードはすでに課金済みかもしれない | 重要 |
| 旅行会社自身のコンテンツと与信ルールが適用されるか | 該当なし | 場合による | 決定的 |
| テスト環境の挙動が本番とどれだけ違うか | 低い | 高い | 高い |
自分の列だけを読み、ほかは無視してください。お金がかかる失敗は、評価しやすいからと送客ページの列を読み、二つ目の製品を作ってしまうことです。
表示した価格は、まだ請求する価格ではない
二つ目の製品で、運賃を一つ最後まで追ってみます。検索が価格を返します。訪問者はそれを見て、考え、別のタブを開き、戻ってきます。しばらくしてボタンを押します。検索とボタンの間、その運賃はあなたのシステムの中に置かれていました。どのAPIについても、正直な問いはただ一つ。その瞬間にもう一度尋ねたら、何と答えるのか。
プロバイダーの答えは三通りです。表示した価格を確定する。新しい価格を返し、差額を課金するか、顧客に聞くか、止めるかをあなたのコードが決める。あるいは、その運賃はもうないと言う。一つ目の答えしか想定していないサイトは、どのデモでも動き、その後の数週間で失敗します。しかもエラーを出すのではなく、お金を失う形で。
ですから設計上の問いは、APIに価格確認のステップがあるかではありません。ほぼすべてにあります。問うべきは、三つの結果それぞれで応答がどんな形か、そしてあなたのコードが推測なしにそれらを区別できるかです。それぞれの例を求めてください。二つ目と三つ目をドキュメントで示せるプロバイダーは、あなたの製品について考えたことがあります。一つ目しか示さないプロバイダーは、デモについて考えたのです。
どんな機能表にも代えられない半日のテスト
候補が誰であれ、各社に同じ短いテストを、わざと失敗を混ぜて行ってください。何かを予約し、発券後に予約オブジェクトが何を保持しているかを見る。同じ旅程の価格を数分おいて二回確認し、二回目の答えが一回目とどう関係するかを見る。キャンセルし、続けて払い戻しを依頼し、誰が手を動かす必要があるかを記録する。そしてプロバイダーに書面で二つ質問します。予約の途中で航空会社がタイムアウトしたらシステムは何を返すのか、そして実際に何が起きたかをどうやって知るのか。
書面の回答はデモより価値があります。結果不明の状態について明確な手順を持つプロバイダーは、その問題に以前ぶつかっています。機能名で答えるプロバイダーは、ぶつかっていません。
テスト計画そのものの組み方は、サンドボックスのテスト計画で、サンドボックスが見せてくれないものを順に扱っています。API そのものではなく、その背後にあるものでプロバイダーを比べているなら、それは別の問いで、別の記事があります。この記事は製品の話にとどまります。
エンドポイント一覧で選んだときに払う代償
失敗は静かです。サイトの価格確定が遅ければ、表示運賃と実際の運賃の差が予約一件ごとにマージンから出ていきます。顧客のカードがすでに課金されたまま予約が結果不明で残れば、誰かが手作業で片づけることになります。たいていメールで、たいてい週末に。検索専用コンテンツの上に作ったツールは、スタッフが発券できないものだと分かり、プロジェクトは別のコンテンツを軸に作り直されます。
どれもチェックマークの表には現れません。どれも、コードを一行書く前に、上の表の最初の列に現れていました。
私たち自身の立場は、ランキングが言わせてくれるより狭いものです。Tekravelは航空券とホテルのAPIを提供し、利用はセルフサービスのキーではなく相談から始まり、サービスはテナントごとに有効化され、仕入れ先のコンテンツはサプライヤーグループを通じてテナントに届きます。これは二つ目と三つ目の製品に向いています。一つ目を作っているなら、私たちはまったく必要ないかもしれません。ほかの二つのどちらかを作っているなら、APIのページから相談を始めてください。