携程API接口系列涵盖了酒店预订、机票预订、旅游度假产品预订、景点门票预订等多个领域,其中酒店和景点详情请求是较为常用的功能。以下提供酒店和景点详情请求的示例参考:
一、酒店详情请求示例
-
接口名称:携程酒店信息查询API
-
请求方式:POST(application/json; utf-8)
-
请求URL:示例URL(具体URL需参考携程开放平台提供的API文档)
-
请求参数:
- Key:应用的API Key
- HotelId:酒店的唯一标识符
-
请求示例(JSON格式):
{ | |
"Key": "your_app_key", | |
"HotelId": "625" | |
} |
-
响应参数:
- HotelName:酒店名称
- Address:酒店地址
- ContactInfos:联系方式
- FacilityInfo:设施信息
- GuestRooms:房型信息
- HotelInfo:酒店其他信息(如建造时间、更新时间等)
-
响应示例(JSON格式,部分字段):
{ | |
"error_code": "200", | |
"reason": "请求成功", | |
"result": [ | |
{ | |
"HotelName": "上海华亭宾馆", | |
"Address": { | |
"AddressLine": "漕溪北路1200号", | |
"CityName": "上海", | |
"PostalCode": "200030" | |
}, | |
"FacilityInfo": { | |
// 设施信息字段 | |
}, | |
"GuestRooms": { | |
// 房型信息字段 | |
}, | |
// 其他酒店信息字段 | |
} | |
] | |
} |
二、景点详情请求示例
-
接口名称:携程获取景点详情API
-
请求方式:HTTP POST/GET
-
请求URL:示例URL
-
请求参数:
- key:应用的API Key
- secret:应用的API Secret
- num_iid:景点的唯一标识符
-
请求示例(URL编码):
https://api-gw.onebound.cn/xiecheng/item_get_scenic/?key=your_api_key&secret=your_api_secret&num_iid=138153 |
-
响应参数:
- item:景点详细信息,包括名称、地址、电话、开放时间、图片、评分等
- _ddf、error、reason、error_code等:用于表示请求状态及错误信息
-
响应示例(JSON格式,部分字段):
{ | |
"item": { | |
"title": "仙女湖", | |
"address": "新余市渝水区西南郊16公里处仙女湖风景区", | |
"telephone": "4009158099", | |
"open_time": "3/1-10/31 08:00-17:30开放;11/1-2/28 08:30-17:00开放", | |
"item_imgs": [ | |
{ | |
"url": "https://dimg04.c-ctrip.com/images/350t0r000000hagjkB897.jpg" | |
}, | |
// 其他图片URL | |
], | |
"level": "4A", | |
"score": 4.2, | |
"reviews_num": 950, | |
"detail_url": "https://you.ctrip.com/sight/xinyu878/138153.html", | |
// 其他景点信息字段 | |
}, | |
"_ddf": "curry", | |
"error": "", | |
"reason": "", | |
"error_code": "0000", | |
// 其他响应状态字段 | |
} |
注意事项
- 注册与授权:在使用携程API接口前,需要在携程开放平台注册成为开发者,并申请相应的API接口权限。获得权限后,将收到API Key和Secret,用于请求时的身份验证。
- API文档:具体的API使用方法、参数和返回值的详细说明,请参考最新的携程开放平台API文档。
- 测试与优化:在调用API接口时,建议进行充分的测试,确保接口的稳定性和可靠性。同时,注意API接口的调用频率和限制,避免因过度调用而被限制访问。
通过以上示例和注意事项,您可以更好地理解和使用携程API接口来获取酒店和景点的详细信息。