Amadeus Self Service APIの代替:1週間で移行する方法

気づくきっかけは、失敗したヘルスチェックか、あるいはユーザーからの連絡です。最初のプロトタイプからずっと呼び出してきた検索エンドポイントが見たことのないエラーを返し、キーを管理していたポータルはもう存在しません。いまAmadeus Self Service APIの代替を探しているなら、おそらくあなたはまさにその状況にいます。動いているプロダクトがあり、コードは一つのプロバイダーのリクエスト形式に合わせて組まれていて、検索が壊れていることにユーザーが気づくまでの猶予はわずかしかありません。
このベンダーについて述べる価値のある事実は一つだけで、述べるのもその一つだけです。Amadeusは2026年7月17日にSelf-Service APIポータルを終了し、新規の開発者は契約ベースで運営されるEnterpriseチャネルへ案内されるようになりました。この件について本稿が触れるのはそれだけです。本当に役に立つ問いは、何で置き換えるのか、そしてまだ動いている部分を作り直さずに、おおよそ1週間でどう移行するのか、です。
セルフサービスが実際に与えてくれていたもの
旧ポータルを「航空券のAPI」として記憶し、別の航空券APIを探しに行くのは簡単です。しかしそれでは、二人だけのスタートアップや週末のプロジェクトにとって何が便利だったのかを見落とします。主に三つです。
- 午後のうちに使えるテスト環境。登録して、キーを受け取り、検索を呼ぶ。会社が何をしているのか、誰も尋ねませんでした。
- 従量課金。呼び出した分だけ支払うので、ユーザーが百人のプロダクトには、ユーザー百人分のコストしかかかりませんでした。
- 営業プロセスがないこと。コードを書き始める前に、誰かの承認を得る必要がありませんでした。
エンタープライズ契約は、この三つをすべて逆転させます。アクセスは商談のあとに来て、価格は交渉で決まり、テスト環境は書類手続きが終わってから届きます。売り手の立場から見れば、どれも理不尽ではありません。航空会社のコンテンツを流通させることには、現実的な義務が伴うからです。しかし、それはあなたの計画を変えます。APIキーを別のものに差し替えるだけで済むと考えていたなら、正直に言えば、本格的な代替手段のほとんどはもうそういう仕組みではありません。このサイトが提供するものも含めてです。詳しくは後述します。
Amadeus Self Service APIの代替となる三つのルート
ベンダー名を取り払うと、代替手段は三種類しかありません。違いはJSONの形よりも、誰と契約し、最終的に誰が航空券を発券するのかにあります。
| ルート | 最初の実予約までの時間 | 期待できるコンテンツ | 発券資格を持つのは誰か |
|---|---|---|---|
| GDSとの直接契約 | 最も長い:商務審査、認証、そのあとで開発 | 幅広いGDSコンテンツ。NDCとLCCは結ぶ契約次第 | IATA認可を持っていればあなた自身。持っていなければ、資格を持つ誰かが必要 |
| アグリゲーターのAPI | 中間:オンボーディングは軽めだが、契約は前提 | GDS、NDC、LCCの組み合わせ。アグリゲーターがどの供給元とつないでいるか次第 | 通常はアグリゲーター、またはその発券パートナー |
| コンソリデーターのAPI | 発券済みの航空券までの最短ルートであることが多い。発券がすでに解決済みのため | コンソリデーターが販売しているもの全般:契約運賃やネット運賃、さらに仕入れ先が扱うもの | コンソリデーターが、自社の認可で発券 |
真ん中の列には異論があってもかまいませんし、自分のケースについては実際に検討すべきです。すでに認可を持ち、社内に商務担当者がいるチームなら、GDSルートが表で示すより速いと感じるかもしれません。しかし、セルフサービスのサンドボックスの上に構築した開発者の大半は、発券資格を持ったことがありません。そして最後の列が、移行後にプロダクトのどれだけがまだ動くかを決めます。
理由はこうです。検索と価格取得は読み取りの操作で、三つのルートのどれでも手に入ります。航空券の発券は金銭を伴う行為で、誰かの認可のもとで行われ、BSPやそれに相当する仕組みで精算されます。その誰かがあなたでないなら、その相手との合意が必要です。この問いを飛ばしたチームは、見栄えのよい検索ページと、誰も支払わない予約を作るだけの予約ボタンを手にすることになります。
もう一つ、ゆっくり読むべき列がコンテンツです。GDSのコンテンツとNDCのコンテンツは同じ運賃ではなく、LCCはそのどちらにも含まれないことがよくあります。ユーザーの多くがLCCの多い地域で短距離路線を利用しているなら、GDSのカバー率が優れたルートでも結果が乏しくなることがあります。この違いについてはNDC APIとGDS:連携する開発者にとって何が変わったかで詳しく説明しました。
このプラットフォームでのアクセス方法と、それがキーでもない理由
このプラットフォームは航空券とホテルのAPIを提供しています。アクセスはセルフサービスのキーではなく、対話から始まります。はっきり書いておくのは、今週あなたにとって最悪の結果が、昔と同じ体験を期待してどこかに登録し、4日目になって人による承認が間に挟まっていると知ることだからです。
その対話は、主に表にある問いをめぐるものです。何を作っているのか、ユーザーは誰か、発券が必要なのか、それとも検索と価格だけでよいのか、どの市場で販売するのか。これらの答えによって、利用できるコンテンツと予約の精算方法が決まります。始めたいなら、旅行API のページが入口です。
どこを選ぶにしても、最初のメールで同じことを尋ねてください。セルフサービスのテストキーはあるか、本番環境に入る前に何が必要か。明確な答えが返ってくれば、その後の連携についても良い兆しです。曖昧な答えもまた、何かを教えてくれます。
移行チェックリスト:壊れる順番に並べて
セルフサービスの連携の多くは同じ形をしていました。検索、価格確認、注文作成、発券、そして航空券が存在したあとに起こることへの対応です。新しいプロバイダーに対して、一度も書いたことがないつもりで各ステップを再テストしてください。リクエストの名前は違うでしょうが、痛い目にあうのはコードの中に埋もれた前提のほうです。
- 検索。クエリモデル(出発地、目的地、日付、旅客、キャビン)を新しいリクエストに対応づけます。子どもと幼児の年齢の渡し方、周遊が別の呼び出しになるか、そして結果が空のときにどう見えるかを確認してください。空のリストとエラーは別物ですが、あなたのUIはおそらく同じように扱っています。
- オファーの識別子。オファーIDがどれくらいの間有効で、ページを再読み込みしても残るのかを確認します。オファーをセッションに保存し、10分後に価格を確認するようなコードは、新しい形で失敗します。
- 価格確認。ほとんどのプロバイダーでは、予約前の再価格確認は省略できません。価格が変わった場合を処理し、そのときユーザーに何を見せるかを決めておいてください。
- 注文。旅客の氏名、旅券などの書類項目、連絡先。送信する前に自分の側で形式を検証してください。顧客が支払ったあとに注文が拒否されるのは、このリストで最も高くつくバグです。
- 発券。注文の呼び出しで発券まで行われるのか、それとも発券が独自の期限を持つ別のステップなのかを確認します。誰かからお金を受け取る前に、航空券が誰の資格で発券されるのかを把握しておいてください。
- 発券後の処理。取消、ボイド、払い戻し、スケジュール変更。プロトタイプでは一度も必要なかったのに、実際のプロダクトでは最初の1か月で必要になる呼び出しです。それがAPIにあるのか、サポート窓口経由なのかを尋ねてください。
何を模擬してよく、何を決して模擬してはいけないかを含む、より詳しいテスト計画は旅行APIのサンドボックス・テスト計画をご覧ください。連携の側から取り組むなら、航空券予約APIの連携が全体の流れを説明しています。
急いだ移行が招くコスト
魅力的に見えるのは、新しいプロバイダーを古いクライアントのインターフェースの裏に包み込み、検索が結果を返した時点でリリースするやり方です。検索は問題なく見えるでしょう。失敗するのは、デモで見せなかったすべてです。
検索から注文までの間に変わった価格が、生のエラーとしてユーザーに表示されれば、その予約は失われます。新しいプロバイダーが注文と発券を二つのステップに分けているのにコードがそうなっていなければ、発券されないまま注文が作られ、旅客は航空券を持っているつもりで実は持っていません。誰かがサポートに連絡するまで何もしない払い戻しの流れは、チャージバックに変わります。どれも一度なら乗り越えられます。しかしユーザー全体で繰り返されれば、小さな旅行プロダクトが頼りにしている信頼を失います。
もっと目立たないコストもあります。今週いちばん速かったという理由でルートを選び、それがユーザーの検索するコンテンツを扱っていなかったと分かれば、移行を二度することになります。コードを書く前に、コンテンツと発券の問いに1日を使うことが、この作業全体でいちばん安い保険です。
おおよその1週間
1日目は問いに使います。どのルートか、どのコンテンツか、誰の発券資格か。2日目と3日目は、新しいプロバイダーに対する検索と価格確認。4日目は注文と発券をエンドツーエンドで、失敗するケースも含めて。5日目は発券後の処理と、自分たちのログを読むことに充てます。プロバイダーとの対話に1日以上かかるなら、並行して先方のドキュメントに沿ってコードを書き始めてください。リクエストの形は、一度見てしまえばめったに変わりません。
最初のセルフサービスのキーを手に入れたあの午後のようには感じられないでしょう。そう感じる必要もありません。いま作っているものは、誰かが責任を持つ航空券を発券できなければならないのですから。