内容 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)"
},
...
}
}
}