一、接口基础说明
item_get_app 是携程用于获取酒店详情原数据的专用API接口，可返回酒店全量原始信息，是对接携程酒店数据的核心接口之一。
二、公共请求参数
调用该接口需传入以下必填公共参数：
表格
名称 类型 必须 描述
key String 是 调用密钥，需在携程开放平台申请获取
secret String 是 接口调用专属密钥
api_name String 是 固定填写为 item_get_app
num_iid String 是 目标酒店的唯一ID，可通过酒店搜索接口提前获取
非必填参数还支持自定义返回格式、语言、缓存策略等配置。
三、调用方式与示例
请求地址：标准格式为 https://api-gw.cn/xiecheng/item_get_app
Python调用示例：
python
import requests
url = "https://api-gw.cn/xiecheng/item_get_app"
params = {
"key": "你的申请的API Key",
"secret": "你的申请的Secret",
"api_name": "item_get_app",
"num_iid": "目标酒店ID"
}
response = requests.post(url, json=params)
data = response.json()
print(data)
调用成功后，接口会返回包含酒店名称、地址、房型、价格、设施、用户评分等全量原始详情数据。
四、注意事项
接口有调用频率限制，通常为每秒最多5次请求，建议用Redis缓存重复请求的酒店数据，避免触发限流。
需严格遵守携程开放平台的数据使用条款，禁止违规存储、泄露用户敏感信息。
调用前需先在携程开放平台完成开发者账号注册、应用创建和接口权限审核，获取合法的Key和Secret后才可正常调用。
需要我为你提供该接口的完整可运行Python代码示例，帮你快速调试对接吗？
