关于Amadeus v2酒店API使用报错及v3功能的技术咨询

v2 API可用性说明 #

Amadeus酒店API v2已正式弃用并下线，你遇到的错误{ "errors": [ { "code": 38196, "title": "Resource not found", "detail": "The targeted resource doesn't exist", "status": 404 } ] }，正是因为v2的接口资源已被移除，无法再继续使用该版本。

v3 API相关问题解答 #

1. 获取酒店及客房设施 #

通过v3的以下接口获取：

• 酒店设施：调用/v3/shopping/hotel-offers或/v3/reference-data/locations/hotels/{hotelId}接口，响应中hotel.facilities字段会返回酒店的公共设施（如泳池、健身房、免费WiFi等）。
• 客房设施：在/v3/shopping/hotel-offers的响应里，每个offer.room.facilities字段会列出对应房型的客房设施（如空调、迷你吧、保险箱等）。

2. 获取酒店联系信息 #

在/v3/shopping/hotel-offers或/v3/reference-data/locations/hotels/{hotelId}的响应中，hotel.contact节点包含酒店的联系电话、邮箱、详细地址等信息。

3. 是否支持取消预订 #

v3的Booking Management API支持取消预订，调用/v3/bookings/{bookingId}/cancel端点即可完成操作。注意：取消需符合酒店的取消政策，该政策会在预订成功后的响应policies.cancellation字段中明确说明（如取消截止时间、是否扣费等）。

4. 搜索时纳入儿童信息 #

v3酒店搜索接口（如/v3/shopping/hotel-offers）支持添加儿童信息，只需在请求参数中传入children数组，每个元素指定儿童年龄，示例参数如下：

{
  "children": [{"age": 4}, {"age": 7}],
  "adults": 2,
  "checkInDate": "2024-10-01",
  "checkOutDate": "2024-10-05",
  "destination": "PAR"
}

接口会根据儿童年龄返回符合条件的房型及对应价格。

内容的提问来源于stack exchange，提问作者Mudassar Iqbal