内容 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"

快速 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 请求示例：

在此示例中，我们在 name 参数中使用 amenities 和 include 值。

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"

快速 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)"
      },
      ...
    }
  }
}