Rapid API の利用を開始する

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

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

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

ステップ 1 : パートナー登録

Rapid API, と統合するには、まだパートナーでない場合は、 パートナーになることを申請する必要があります。

ステップ 2. お客様のウェブサイトに適用されるローンチ要件をご確認ください。

立ち上げ要件を見直して、どの要件にフロントエンドのユーザーインターフェイス開発が必要かを判断し、プロジェクト計画に反映させます。

宿泊API

• B2B 宿泊単体
• B2C 宿泊単体
• Vrbo

カーAPI

• B2BまたはB2C

ステップ 3. 環境設定の準備

以下のリソースを参考にしながら、Rapid を使用するための環境を用意します。

• 宿泊APIの概要
• 自動車APIの概要
• 予約リクエストの処理
• 宿泊キャンセルポリシーの構築

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

パートナーになり、Rapid API, との統合が承認されたら、APIキーを取得する必要があります。これを行うには、Portal にログインし、左側のメニューバーでConnectivity をクリックします。次に、オプションから API キーを選択します。ポータルには、現在のAPIキーの詳細が表示されます。

APIキーは、署名認証に必要な2つのキー認証情報のうちの1つです。また、共有秘密 も必要です。Portal にアクセスし、API Keysページに移動します。サイトのレビュー後、本番環境へのリリースが承認されるまで、API キーは制限された開発モードになります。

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

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

詳細は署名認証ページ をご覧ください。シグネチャ生成ツールを使用して、統合テストのための SHA-512 ハッシュ値を生成できます。

ステップ 5. リクエストのテストを開始する

認証情報を受け取り、認証を設定したら、テスト用のエンドポイントhttps://test.ean.com/ に対してリクエストを開始できます。https://test.ean.com/ に対して予約をリクエストしても、実際の宿泊施設予約やクレジットカードの請求は実行されません。Booking API 用に記載されたテストヘッダーを選択して、表示する応答タイプを指定できます。予約関連のリクエストからテストヘッダーを省略した場合は、テストサーバーによって自動的にヘッダーが追加されます。

重要: 安定して維持可能なサービスを提供するため、料金制限 が適用されます。システムは異常な API トラフィックを監視し、システム自体を保護するためのアクションを自動的に実行します。API 呼び出しの動作に計画的な変更を加える前、または API アクセスを使用してパフォーマンステストを実施する前に、Rapid コンサルタントと計画を確認してください。

API バージョンの指定

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 サービスのバージョン番号に常に対応しています。

例 : OpenAPI 仕様

openapi: 3.0.1
info:
  title: Rapid
  description: EPS Rapid V3
  version: v3
servers:
  - url: https://test.ean.com/v3

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

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

認定技術パートナーとの連携

Rapid Lodging API開発のアウトソーシングをご希望ですか？エリートおよびプリファード・テクノロジー・パートナーは、統合の設計、構築、最適化を行うことができます。

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