連携ディレクトリ
Amadeus API連携:航空券コネクタをステップごとに設定
AmadeusモジュールはPHPTRAVELSの航空券検索をAmadeus Enterpriseに接続します。アプリを登録し、管理画面に3つの認証情報を貼り付け、開発モードでテストし、Amadeusがアカウントを承認したら本番に切り替えます。
- Enterpriseプランのコネクタ
- OAuth2 client credentials
- 開発と本番
- 公開済みの設定ガイド
コネクタ設定
Amadeusアプリからライブの航空券結果まで5ステップ
コネクタは既製のモジュールなので、標準的な設定ではコードを書く必要はありません。ご自身のAmadeusアカウントと商取引条件を用意すれば、モジュールがPHPTRAVELSの航空券モジュール内で認証、フライト検索、注文作成を処理します。
- Amadeusモジュールを含むEnterpriseプランから始める
- Amadeus for Developersに登録し、Flight Offers SearchとFlight Create Ordersを有効にしたアプリを作成
- 管理画面のモジュールでgrant type、client ID、client secretを入力し、Dev modeをオンにする
- サイトでフライトを検索し、「今すぐ予約」ボタンの下にAmadeusのロゴがあるか確認
- 本番キーを申請してsandboxキーと置き換え、Dev modeを本番に切り替える
- Dev mode
- 開発
- エンドポイント
- travel.api.amadeus.com/v2/
- c1 · grant_type
- client_credentials
- c2 · client_id
- ••••••••••7Kq2
- c3 · client_secret
- ••••••••••
コネクタの役割
検索にはAmadeusのオファー、管理画面には注文
モジュールは2つのAmadeus APIで動きます。1つは結果ページにフライトのオファーを返し、もう1つは旅行者が支払うと予約を作成します。
- APIロンドン発ニューヨーク行き · 直行エコノミー · 8時間05分 · 受託手荷物1個$486大人1名あたり
- v2ロンドン発ニューヨーク行き · 経由1回エコノミー · 11時間20分 ダブリン経由 · 受託手荷物1個$412大人1名あたり
- ロンドン発ニューヨーク行き · 直行ビジネス · 7時間55分 · 受託手荷物2個$2,140大人1名あたり
Flight Offers SearchとFlight Create Orders
Offers Searchが検索結果を埋め、Create Ordersが選ばれたオファーを予約にします。検索と予約にはAmadeusアプリで両方を有効にしてください。
OAuth2認証
モジュールは管理画面に入力したclient IDとsecretを使い、client_credentialsグラントでアクセストークンを取得します。
開発モードと本番モード
Dev modeという1つの設定で、リクエストがsandboxキーと承認済み本番キーのどちらを使うかが決まります。
Enterpriseエンドポイント
モジュールはtravel.api.amadeus.com/v2/を前提に作られています。地域によってエンドポイントが異なるため、キーを入力する前にご確認ください。
各結果に提供元を表示
「今すぐ予約」ボタンの下のAmadeusロゴで、どの運賃がAmadeus由来か一目で接続を確認できます。
よくあるエラーの原因
多くは認証情報の誤り、キーと一致しないモード、またはAmadeusダッシュボードで無効なままのAPIサービスが原因です。
リクエストの流れ
Amadeus検索のたびに起きること
開発と本番で同じ流れが動き、変わるのはキーとDev modeの設定だけです。
認証
client IDとsecretをアクセストークンに交換します。
検索
Flight Offers Searchがルート、日付、乗客に応じた運賃を返します。
表示
オファーはマークアップ込みで、他の接続済みサプライヤーの結果と並んで表示されます。
注文
Flight Create Ordersが旅行者情報で選択されたオファーを予約します。
記録
予約は管理画面に保存され、確認メールが送信されます。
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 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は宿泊サプライヤーとしても掲載されていますが、設定ガイドはまだ公開されていないため、ホテルの範囲は当社チームにお問い合わせください。
