This is an auto-generated translation

内容

Rapid Content API 使您能够访问 Rapid API 所有属性的内容。

属性内容 API

以请求的语言返回所请求的在售住宿的住宿编号或完整住宿内容列表。

使用此 API,可根据您的搜索条件检索住宿编号或完整的住宿内容。例如,检索自上周一以来添加的住宿列表,或者检索对应特定住宿编号列表的住宿内容。

内容文件 API

Rapid API 的一个功能是能够导出活动房产及其详细信息的列表。有两种文件 API 可供选择。

Warning

注意

内容文件 API 对扩展的全球库存支持有限,因此我们建议您改用内容 API。

了解更多关于扩展全球库存的信息

住宿目录文件

此 API 返回一个链接,用于下载所请求语言的活跃房源主要列表。响应包含有关每家住宿的概要信息。使用此文件可以获取住宿的完整列表。当映射到来自其他供应商的住宿列表时,住宿详细信息则非常有用。

住宿内容文件

此 API 返回一个链接,用于下载所请求语言的所有活跃房源的所有内容。响应包括住宿级别、客房级别以及房价级别的信息。使用此文件可以检索所有住宿的全部内容。如果您只需要住宿的子集,则换用住宿内容 API 即可。

非活性属性

有时,之前可以预订的住宿会停业,并在我们的库存中显示为已下线。可以使用“非活跃房产 API”请求自给定完整日期以来所有非活跃房产的列表,从而更新您的内容缓存或存储,以排除 Rapid API 中不可出售/不可预订的房产。

在下面的示例中,合作伙伴最后一次尝试使用住宿内容 API 或住宿内容文件 API 更新其内容缓存或存储是在 5 月 31 日。这将显示一个无序列表,其中包含应从其系统中删除的 property_id对象。此端点可与住宿内容 API 端点上的以下一个或多个参数结合使用,以增量更新您的内容缓存或存储:date_added_startdate_added_enddate_updated_startdate_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 API 识别的所有链的完整集合。连锁指的是一个有着多个关联品牌的母公司。

一个品牌只可与一个连锁相关联。例如,希尔顿全球酒店集团是一个连锁品牌,旗下拥有多个相关品牌,包括 DoubleTree、Hampton Inn 和 Embassy Suites。

加州度假租赁清洁任务

加州一项新法律要求度假租赁房产必须向旅行者披露必须完成的清洁工作。我们对 API 进行了更改,以便您可以显示清洁任务。使用 Rapid API 的每个合作伙伴都有责任确保清洁任务的展示方式符合法律规定。

有什么变化?

我们对 Rapid API 进行了增强,在 checkout对象中添加了一个新的说明字段,其中包含度假租赁经理提供的退房说明。

示例:

"checkout": {
"instructions": "<ul>  <li>The host requests you complete the following cleaning tasks before checking out:</li><li>Start the dishwasher</li><li>Strip any used beds and gather used towels</li><li>Remove personal items</li><li>Turn off the lights</li>  </ul>"
}

其他参考信息

本地化

language参数仅使用 two-digit 语言和国家代码的连字符对,在集成任何代码之前,请检查 支持的语言

星级

Rapid 内容 API 返回的星级为旅客提供了相应信息,可以帮助旅客大致了解住宿在家具、服务和服务设施方面的情况。了解更多关于星级评分运作方式的信息

参考列表

Rapid 内容 API 提供的住宿信息通常用各种 ID 表示。您可查看参考列表,了解这些 ID 的含义。参考列表仅提供英文版本,但 API 中返回的是经过本地化的名称。

注册编号

Rapid 内容 API 中的 registry_number 参数将返回单个或多个注册详细信息。这些详细信息可能包含单词、字母、数字和特殊字符,具体取决于各个国家/地区的要求。我们提供这些编号,旨在协助您遵守法律法规的展示要求。

示例:

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

库存机会

库存机会页面将为您提供与 Rapid API 集成相关的未映射属性列表。我们的住宿供应时常会有变化,您需要定期查看以添加住宿或将其映射到其他提供商的住宿,这样您的旅客就不会遇到重复的住宿或是错过您网站上的新住宿。

API 详情

查看此页面上与内容相关的端点定义,然后使用 API Explorer 或其他测试软件来了解示例和模式定义与实际输出的比较。


其他资源

无论您是想尝试所有 Rapid API 端点还是下载其 OpenAPI 规范或我们的 Postman 集合,我们都能满足您的需求。



您觉得这个页面有用吗?
我们该如何改进这些内容?
感谢您帮助我们改进!