内容 API 搜索和响应筛选

轻松搜索和筛选内容 API 响应，获得更有针对性的结果。

合作伙伴可以使用 Rapid 内容的搜索和筛选功能，控制他们在内容响应中收到的住宿信息。这样，合作伙伴就能通过 Rapid 精简数据，只获取他们需要为客户提供的信息，从而降低成本、提高灵活性。

搜索

搜索为住客提供特定服务设施或服务的住宿，例如，搜索提供增强的可持续发展特色的住宿。

Rapid 合作伙伴可以按住宿级元素进行搜索，包括：

category_id - 类别
all_inclusive - 全包服务
attribute_id - 属性
amenity_id - 住宿级服务设施
spoken_language_id - 使用的语言

**注：**此功能不包括特定的客房或房价计划元素。

Rapid 3 请求示例：在此示例中，我们使用新的 amenity_id 搜索参数来限制返回的住宿。

curl -X GET "https://test.ean.com/v3/properties/content\
?language=en-US\
&supply_source=expedia\
&amenity_id=115\
&include=property_id\
&property_id=1337\
&property_id=1" \
 -H "accept: application/json, application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
 -H "user-agent: TravelNow/3.30.112"

Rapid 3 响应示例：在此响应中，我们可以看到只返回了住宿 1337，因为住宿 1 没有服务设施 id 115。

{
  "1337": {
    "property_id": "1337"
  }
}

有关可用属性、服务设施、使用的语言和类别的完整列表，请参阅内容参考列表。

筛选

请求 Rapid 内容响应的一部分，而不接收完整的住宿详细信息。合作伙伴只能请求所需的内容 API 响应的概要部分。这可以通过 include 参数请求，并且结果将只包括每个住宿的 property_id 和所请求的部分。

目前可用于筛选的部分包括以下内容。

**注：**此列表不应被视为详尽无遗，因为筛选功能也将适用于未来添加的任何新的概要部分。

property_id
name
address
ratings
location
phone
fax
category
rank
business_model
checkin
checkout
fees
policies
attributes
amenities
images
onsite_payments
rooms
rates
dates
descriptions
statistics
airports
themes
all_inclusive
tax_id
chain
brand
spoken_languages
multi_unit
payment_registration_recommended
supply_source
vacation_rental_details

Rapid 3 请求示例：在此示例中，我们在 include 参数中使用了 name 和 amenities 的新值。

curl -X GET "https://test.ean.com/v3/properties/content\
?language=en-US\
&supply_source=expedia\
&include=name\
&include=amenities\
&property_id=1337" \
 -H "accept: application/json, application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
 -H "user-agent: TravelNow/3.30.112"

Rapid 3 响应示例：在此响应中，我们可以看到 property_id、name 和amenities 都包含在响应中。 property_id 始终包含在响应中，无需指定为 include 请求参数，除非它是响应中唯一需要的字段。(注：为使示例简明扼要，服务设施清单有所删减）

{
  "1337": {
    "property_id": "1337",
    "name": "Hyatt Regency Paris Etoile",
    "amenities": {
      "8": {
        "id": "8",
        "name": "Elevator"
      },
      "43": {
        "id": "43",
        "name": "Concierge services"
      },
      "115": {
        "id": "115",
        "name": "Bicycle rentals nearby"
      },
      "361": {
        "id": "361",
        "name": "Breakfast available (surcharge)"
      },
      ...
    }
  }
}

内容 API 搜索和响应筛选

轻松搜索和筛选内容 API 响应，获得更有针对性的结果。

搜索

筛选

另请参阅

EPS 通知服务测试器

新冠疫情 Rapid 更新

住客点评

签名生成器