連携ディレクトリ

Amadeus API連携:航空券コネクタをステップごとに設定

AmadeusモジュールはPHPTRAVELSの航空券検索をAmadeus Enterpriseに接続します。アプリを登録し、管理画面に3つの認証情報を貼り付け、開発モードでテストし、Amadeusがアカウントを承認したら本番に切り替えます。

  • Enterpriseプランのコネクタ
  • OAuth2 client credentials
  • 開発と本番
  • 公開済みの設定ガイド

コネクタ設定

Amadeusアプリからライブの航空券結果まで5ステップ

コネクタは既製のモジュールなので、標準的な設定ではコードを書く必要はありません。ご自身のAmadeusアカウントと商取引条件を用意すれば、モジュールがPHPTRAVELSの航空券モジュール内で認証、フライト検索、注文作成を処理します。

  1. Amadeusモジュールを含むEnterpriseプランから始める
  2. Amadeus for Developersに登録し、Flight Offers SearchとFlight Create Ordersを有効にしたアプリを作成
  3. 管理画面のモジュールでgrant type、client ID、client secretを入力し、Dev modeをオンにする
  4. サイトでフライトを検索し、「今すぐ予約」ボタンの下にAmadeusのロゴがあるか確認
  5. 本番キーを申請してsandboxキーと置き換え、Dev modeを本番に切り替える
Dev mode
開発
エンドポイント
travel.api.amadeus.com/v2/
c1 · grant_type
client_credentials
c2 · client_id
••••••••••7Kq2
c3 · client_secret
••••••••••
設定ガイドを読む

リクエストの流れ

Amadeus検索のたびに起きること

開発と本番で同じ流れが動き、変わるのはキーとDev modeの設定だけです。

  1. 認証

    client IDとsecretをアクセストークンに交換します。

  2. 検索

    Flight Offers Searchがルート、日付、乗客に応じた運賃を返します。

  3. 表示

    オファーはマークアップ込みで、他の接続済みサプライヤーの結果と並んで表示されます。

  4. 注文

    Flight Create Ordersが旅行者情報で選択されたオファーを予約します。

  5. 記録

    予約は管理画面に保存され、確認メールが送信されます。

Amadeusの位置づけ

自社のAmadeusアカウント、他の航空券API、カスタム開発

Amadeusモジュールは複数ある航空券コネクタの1つで、それぞれが独自の認証情報で同じ検索内で動作します。

  • 自社のAmadeus Enterpriseアカウント

    Amadeusは利用目的、会社登記、ウェブサイトを審査したうえで本番キーを発行し、お客様はその商取引条件に同意します。

  • 他の航空券コネクタ

    連携ディレクトリからDuffel、Kiwiなどの航空券サプライヤーを追加し、1つの結果リストで運賃を比較できます。

  • 他のエンドポイントとAPI

    地域別のAmadeusエンドポイントや、モジュールがまだ使っていないAPIはカスタム開発として追加できます。

接続できる航空券サプライヤー:

  • Seeru
  • Amadeus
  • Duffel
  • Google Flights
  • Kayak
  • Kiwi
  • Mystifly
  • PKfare
  • Sabre
  • TBO Holidays
  • Travelport
すべての連携を見る

バックオフィス

同じ管理画面でAmadeusの予約を運用

キーを入力すれば、Amadeusの運賃も他の航空券サプライヤーと同じルールに従います。

  • 航空券のマークアップ

    定額または割合のマークアップで、Amadeusの運賃に販売価格を表示します。

  • 予約一覧

    Amadeusの予約は旅行者情報とステータスとともに航空券予約画面に並びます。

  • B2B代理店

    代理店はエージェントポータルで独自の料金でAmadeusの運賃を検索・予約します。

  • 決済

    旅行者は有効化した決済ゲートウェイで、代理店はウォレットから支払います。

  • キーは自社サーバーに

    認証情報は共有プラットフォームではなく、セルフホストの自社管理画面に保存されます。

  • サポートチケット

    接続や予約で支援が必要な場合は、app.phptravels.comでチケットを作成してください。

比較

Amadeusへの自社開発とPHPTRAVELSモジュール

どちらも同じAmadeusアカウントを使います。違いは、その周りをチームがどれだけ書いて保守するかです。

作業API直接開発PHPTRAVELS
認証API直接開発トークン取得と更新を開発者が実装PHPTRAVELS管理画面の3項目からモジュールが処理
検索結果API直接開発オファーデータを自社の結果ページに対応付けPHPTRAVELS既存の航空券検索にオファーを表示
予約API直接開発旅行者フォームと注文呼び出しを一から構築PHPTRAVELSCreate Ordersをチェックアウトと決済に接続済み
テストと本番API直接開発環境ごとに個別の設定PHPTRAVELSDev modeスイッチ1つ
マークアップと予約API直接開発設計・構築が必要なバックオフィスPHPTRAVELS航空券の管理画面に搭載
設定手順API直接開発チームが作成し更新し続けるPHPTRAVELSdocs.phptravels.comで公開済みのガイド

活用例

Amadeusモジュールを使うのは

  • オンライン旅行会社

    Amadeusコンテンツによる一般向け航空券検索を、自社のマークアップとチェックアウトで。

  • B2B代理店ネットワーク

    サブエージェントがあなたのポータルから、あなたの料金でAmadeusの運賃を予約。

  • 出張管理会社

    法人の予約担当者が、あなたがホストし管理するプラットフォームでAmadeusの運賃を検索。

PHPTRAVELSを選ぶ理由

読めて、変えられて、自社でホストできるコネクタ

  • ソースコード付属

    商用ライセンスでセルフホストするため、開発者がAmadeusモジュールを拡張できます。

  • 文書化された設定

    すべての手順、項目、エラー原因がdocs.phptravels.comに記載されています。

  • 24言語

    右から左に書く言語を含め、各市場の言語でAmadeusの運賃を表示できます。

  • B2CとB2B

    公開サイトとエージェントポータルを1つのインストールで。

よくある質問

Amadeusコネクタに関する質問

Amadeusモジュールを設定するチームからよく寄せられる質問です。

営業に相談

既製の航空券モジュールです。Amadeus for Developersでアプリを作成し、その認証情報を管理画面に入力すると、Amadeusのオファーが航空券検索に表示され、予約はFlight Create Ordersで作成されます。

AmadeusモジュールはEnterpriseプランで利用でき、料金ページに記載のとおり一括払い$9999です。Amadeusのアカウントと商取引条件は別途Amadeusと取り決めます。

client_credentialsのgrant type、client ID、client secretです。アプリ作成時にAmadeusがsandboxキーを発行し、本番申請が承認されると本番キーが発行されます。

モジュールはtravel.api.amadeus.com/v2/を使用します。地域によってエンドポイントやパラメータが異なるため、まずアカウントをご確認ください。他のエンドポイントはカスタム開発で追加できます。

Amadeusアプリで有効にしたAPIに応じて両方可能です。Flight Offers Searchが結果を返し、予約にはFlight Create Ordersの有効化が必要です。

文書化されたコネクタは航空券用です。Amadeusは宿泊サプライヤーとしても掲載されていますが、設定ガイドはまだ公開されていないため、ホテルの範囲は当社チームにお問い合わせください。