Rapid API の利用を開始する

Rapid APIを自社でセットアップするか、認定されたthird-partyパートナーと連携して、カスタマイズされた旅行サイトを立ち上げてください

Rapid APIの実装を設定してください

他のAPIと同様、Rapid APIをご利用になるには、事前にいくつかの準備作業を行う必要があります。

ステップ1：パートナーになる

Rapid API, と連携するには、Expediaのパートナーである必要があります。

>> パートナーへのご応募

ステップ2：該当する立ち上げ要件を確認する

実装を予定しているAPIの起動要件をご確認ください。これらは、どの要件に対してフロントエンドのユーザーインターフェース開発が必要になるかを理解する手助けとなり、プロジェクト計画にそれを織り込むことができます。

>> 立ち上げ要件を確認してください

ステップ3：環境の準備

Rapidを使用するための環境を整えるため、実装を予定している各APIのドキュメントをご確認ください。

• 宿泊API
• Car API
• フライトAPI
• Activities API

手順4：認証情報を取得し、認証設定を行う

パートナーとなり、Rapid API, との連携が承認されたら、APIキーを取得する必要があります。これを行うには、ポータルにログインし、左側のメニューバーにある「の接続」 をクリックしてください。次に、オプションから API キーを選択します。また、共有秘密鍵も必要となります。これは、ポータルにアクセスし、「APIキー」ページに移動することで確認できます。APIキーは、サイトの審査が完了し、本番環境への公開が承認されるまでは、制限付きの開発モードのままとなります。

テストかプロダクションかを問わず API サービスにリクエストする際は、HTTP 認証ヘッダーを使用して各リクエストの API キーと SHA-512 シグネチャハッシュを送信します。SHA-512 ハッシュは、共有シークレット、API キー、現在の UNIX タイムスタンプで構成されています。Rapid APIの認証ヘッダーは、常に以下の形式を使用します：

Authorization: EAN APIKey=yourAPIKey,Signature=sha512Hash,timestamp=yourUNIXTimestamp

ステップ5：リクエストのテストを開始します

認証情報を取得し、認証の設定が完了しましたら、当社のテスト用エンドポイントに対してリクエストを送信できるようになりますhttps://test.ean.com/。https://test.ean.com/ に対して予約をリクエストしても、実際の宿泊施設予約やクレジットカードの請求は実行されません。各APIのドキュメントに記載されているテストヘッダーから選択することで、表示したいレスポンスの種類を指定することができます。booking-relatedへのリクエストでテストヘッダーを省略した場合、テストサーバーが自動的に追加してくれます。

OpenAPI仕様にあるservers.url の値を使用して、URLを構築してください。検証テストではtest.ean.com を使用し、本番環境のエンドポイントはapi.ean.com となります。エンドポイント間を切り替えるときにプロトコルとパスを保持します。

https://test.ean.com/v3/itineraries?…
https://api.ean.com/v3/properties/22135/payment-options?token=U1dFC0JHTW

servers.url 値はダウンロード可能な OpenAPI 仕様ファイルの先頭にあり、特定の API サービスのバージョン番号に常に対応しています。

Rapid Lodging APIに関する注意事項： 安定した維持管理のしやすいサービスを提供するため、レート制限を設けております。システムは異常な API トラフィックを監視し、システム自体を保護するためのアクションを自動的に実行します。APIの呼び出し動作について計画的な変更を行う前、またはAPIアクセスに関するパフォーマンステストを実施する前に、必ずRapid APIのコンサルタントと計画内容についてご確認ください。

>> レート制限について詳しくはこちら

ステップ6：サイトの審査を依頼する

統合が完了し、該当する起動要件が満たされていることを確認したら、ビジネスディベロップメントマネージャーにサイトの審査を依頼します。プロダクションへの移行が許可されると、ビジネスディベロップメントマネージャーが API キーを有効にし、プロダクションで使用できるようになります。その後、リクエストのエンドポイントをhttps://test.ean.com/ からhttps://api.ean.com に変更し、引き続きリクエストを行ってください。追加のコード変更は必要ありません。

当社の認定技術パートナーのいずれかとご協力ください

Rapid Lodging APIの開発は、外部委託をご希望ですか？当社の「エリート」および「プリファード」テクノロジーパートナーのいずれかと連携いただくことで、パートナーがお客様のシステム連携の設計、構築、最適化を行い、社内での開発負担を軽減しつつ、より迅速に本番運用を開始できるようになります。

>> 認定テクノロジーパートナープログラムの詳細をご覧ください