コンテンツ

Content API を使用して、Rapid のすべての施設のコンテンツを表示できます。

施設コンテンツ

リクエストされた言語で、リクエストされたアクティブな施設の施設 ID またはすべての施設コンテンツのリストを返します。

この API を使用して、検索条件に基づいて施設 ID またはすべての施設コンテンツを取得します。たとえば、前の月曜日以降に追加された施設のリストを取得したり、特定の施設 ID のリストに対応した施設コンテンツを取得したりします。

公開停止中の施設

以前は予約可能だった施設が休業し、在庫内で公開停止になる場合があります。Inactive Property API を使用すると、指定された日付以降に公開停止になったすべての施設のリストをリクエストできます。これにより、コンテンツキャッシュまたはストレージを更新して、Rapid 内で販売/予約できない施設を除外できます。

以下の例では、パートナーが最後に Property Content API または Property Content File API を使用してコンテンツキャッシュまたはストレージを更新しようとしたのは 5 月 31 日でした。これにより、パートナーシステムから削除する必要がある、property_id が付いたオブジェクトの順不同のリストが表示されます。Property Content API エンドポイントの次のパラメーターの 1 つ以上と組み合わせてこのエンドポイントを使用することで、コンテンツキャッシュまたはストレージを段階的に更新できます : date_added_start、date_added_end、date_updated_start、または date_updated_end。

例 :

リクエスト :

https://test.ean.com/v3/properties/inactive?since=2023-06-01

応答 :

[
  {
    "property_id": "10003243"
  },
  {
    "property_id": "10012775"
  },
  {
    "property_id": "10013765"
  },
  {
    "property_id": "10017071"
  },
  {
    "property_id": "10041102"
  },
  {
    "property_id": "10042"
  },
  {
    "property_id": "10074774"
  },
  {
    "property_id": "10089905"
  },
  {
    "property_id": "10091055"
  },
  {
    "property_id": "10268276"
  },
  {
    "property_id": "1029882"
  },
  {
    "property_id": "103115"
  },
  {
    "property_id": "10349744"
  },
  {
    "property_id": "10373667"
  },
  {
    "property_id": "1037667"
  },
  {
    "property_id": "1039715"
  },
  {
    "property_id": "10401509"
  },
  {
    "property_id": "104201"
  },
  {
    "property_id": "10465614"
  },
  {
    "property_id": "10484434"
  },
  {
    "property_id": "10488054"
  },
  {
    "property_id": "10520425"
  }
]

施設カタログファイル

リクエストされた言語で Rapid のアクティブな施設のプライマリーリストをダウンロードできるリンクを返します。この応答には、各施設の詳細情報が含まれています。

このファイルを使用して施設の全リストを取得します。施設の詳細情報は、他のサプライヤーが提供する施設リストへのマッピングを行うときに役立ちます。

施設コンテンツファイル

Rapid のアクティブな施設すべてについて、リクエストされた言語ですべてのコンテンツをダウンロードできるリンクを返します。この応答には、施設レベル、客室レベル、料金レベルの情報が含まれます。

このファイルを使用して、すべての施設の全コンテンツを取得します。施設のサブセットのみが必要な場合は、代わりに Property Content API を使用します。

チェーンリファレンス

Rapid で認識されているチェーンの完全なコレクションを返します。

チェーンとは、複数のブランドを関連付けることができる親会社です。

ブランドは 1 つのチェーンにのみ関連付けることができます。たとえば、ヒルトンワールドワイドというチェーンには、ダブルツリー、ハンプトン・イン、エンバシー・スイーツなどの複数のブランドが関連付けられています。

その他の参考情報

ローカライズ

language パラメータでは、ハイフンでつながった一対の 2 桁の言語と国のコードのみを使用できます。コードを統合する前に、こちらですべてのサポート対象言語を確認してください。

星評価

Rapid Content API で返される星評価は、家具、サービス、アメニティの点でその施設に一般的に期待できることについてお客様に指針を提供します。星評価の仕組みの詳細については、こちらを参照してください。

リファレンスリスト

多くの場合、Rapid Content API で提供される施設情報は ID で表されます。これらの ID の意味については、リファレンスリストを参照してください。このリファレンスリストは英語のみで提供されていますが、API ではローカライズ済みの名前を返します。

登録番号

Rapid Content APIの registry_number パラメータは、単一または複数の登録詳細を返します。これらの詳細には、国ごとに必要な単語、文字、数字、特殊文字を含めることができます。当社では、法的および規制上の表示要件を遵守できるよう、これらの番号を提供しています。

**例 : **

"registry_number": "Property Registration Number 004071AAA-00004, IT005748GHFMUHG",
"registry_number": "IT00574-8GHFMUHG",

推奨施設

EPS ポータルの「推奨施設」ページには、Rapid API との統合に関連する、マッピングされていない宿泊施設のリストが表示されます。宿泊施設の供給は頻繁に変更されるため、定期的に確認して宿泊施設を追加したり、他のサプライヤーの宿泊施設にマッピングしたりする必要があります。こうすることで、ウェブサイトで旅行者に同じ宿泊施設が重複して表示されたり、旅行者が新しい宿泊施設を見逃したりすることがなくなります。

API の詳細

このページでコンテンツ関連のエンドポイント定義を調べてから、API Explorer または別のテストソフトウェアを使用して、例とスキーマ定義が実際の出力とどのように比較されるかを理解します。

その他のリソース

すべての Rapid API エンドポイントを試してみたい場合でも、OpenAPI 仕様や Postman コレクションをダウンロードしたい場合でも、必要なリソースが用意されています。

API Explorer に移動