Rapid API の利用を開始する

Rapid APIをご自身で立ち上げるか、認定third-partyパートナーと協力してカスタマイズした旅行サイトを立ち上げてください。

Rapid APIの実装を設定します。

他のAPIと同様に、Rapid APIを使用する前にいくつかの準備作業が必要です。

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

Rapid API, と統合するには、以下が必要です。 パートナー申請 もしそうでないなら

ステップ2：適用される進水要件を確認

実装を計画しているAPIについて、起動要件 を確認し、どの要件にフロントエンドのユーザーインターフェイス開発が必要かを判断し、プロジェクト計画に反映できるようにします。

ステップ3: 環境の準備

実装予定の各APIのドキュメントを確認し、Rapidを使用する環境を準備します。

• 宿泊API
• カーAPI
• フライトAPI
• Activities API

ステップ4: 認証情報の取得と認証の設定

パートナーになり、Rapid API, との統合が承認されたら、APIキーを取得する必要があります。これは、ポータルにログインし、左側のメニュー・バーでConnectivity をクリックすることで行えます。次に、オプションから 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開発のアウトソーシングをご希望ですか？エリートおよびプリファード・テクノロジー・パートナーは、統合の設計、構築、最適化を行うことができます。

認定テクノロジーパートナープログラム