接入点列表:
post方式请求时,enctype应为application/x-www-form-urlencoded
上传文件二进制数据流方式,enctype必须为multipart/form-data
参数url、base64中有特殊字符时,建议对值urlencode编码后传递
名称 | 类型 | 必须 | 示例值/默认值 | 说明 |
---|---|---|---|---|
ak | string | 是 | 您自己的APIKEY(注册账号后获得) | API密钥 |
page | String | 是 | 0 | 页码 |
cityName | String | 否 | 成都 | 城市 |
inDate | String | 否 | 入住时间,格式为:YYYY-MM-DD(默认2天后) | |
outDate | String | 否 | 离开时间,格式为:YYYY-MM-DD(默认3天后) | |
sortKey | String | 否 | recommend | 排序规则(默认recommend.推荐值排序)recommend:推荐值降序satisfaction:口碑price-asc:起价升序price-desc:起价降序 |
star | String | 否 | 星级TWO:二星级,THREE:三星级,FOUR:四星级,FIVE:五星级,BUDGET:经济型,CONFORT:舒适型,HIGHEND:高档型,LUXURY:豪华型【多个以逗号:‘,’分隔】 | |
minPrice | String | 否 | 房价最低价 | |
maxPrice | String | 否 | 房价最高价 | |
poiKey | String | 否 | 区域关键字可以使用关键字搜索中的displayName(poiKey、poiCode、longitude、latitude四个值需结合使用) | |
poiCode | Number | 否 | 经纬度对应的编号poi类型值:1-城市,2-行政区,3-商圈,4-景点,7-酒店,12-机场,13-地铁,14-火车站(poiKey、poiCode、longitude、latitude四个值需结合使用)) | |
longitude | Number | 否 | 经度(poiKey、poiCode、longitude、latitude四个值需结合使用)) | |
latitude | String | 否 | 维度(poiKey、poiCode、longitude、latitude四个值需结合使用)) | |
limit | Number | 是 | 30 | 每页条数,最大30条 |
keyWords | String | 否 | 搜索关键词 |
用户等级 | 免费接口数 | 每日可用次数 | 会员价格 | 说明 |
---|---|---|---|---|
普通会员 | 无限 | 50次 | 免费 | 每个免费接口最高50次/天 |
高级会员 | 无限 | 100次 | 9.9元/月、99.9元/年 | 每个免费接口最高100次/天 |
黄金会员 | 无限 | 150次 | 14.9元/月、149.9元/年 | 每个免费接口最高150次/天 |
砖石会员 | 无限 | 200次 | 19.9元/月、199.9元/年 | 每个免费接口最高200次/天 |
本接口为会员免费类接口,如业务有更高需求可点此升级会员获得更高每日请求配额(年付限时优惠) |
错误信息可能会有所调整,请根据错误状态码(code)进行流程判断
错误状态码 | 错误信息 | 解释帮助 |
---|---|---|
100 | 缺少调用凭证 | 请检查是否传递了ak参数 |
101 | 当前API已下线 | 接口已下线无法使用,可关注相关通知 |
103 | API可用次数不足 | 计次类接口余额不足 |
104 | 当日免费次数已用完 | 免费类接口次数不足 |
106 | IP请求来源受限 | 请求来源IP在黑名单内 |
107 | 在用户黑名单里 | 通常为账号无效,此状态无法恢复 |
201 | 参数值不符合要求 | 参数值不符合基本格式要求 |
错误码1开头的是系统级错误,2开头的是用户级错误,其中200表示请求成功处理并计费。 |
此处代码仅演示关键请求片段,实际使用请根据具体环境修改
post方式请求时,enctype应为application/x-www-form-urlencoded
上传文件二进制数据流方式,enctype必须为multipart/form-data
参数url、base64中有特殊字符时,建议对值urlencode编码后传递
名称 | 类型 | 必须 | 示例值/默认值 | 说明 |
---|---|---|---|---|
ak | string | 是 | 您自己的APIKEY(注册账号后获得) | API密钥 |
用户等级 | 免费接口数 | 每日可用次数 | 会员价格 | 说明 |
---|---|---|---|---|
普通会员 | 无限 | 50次 | 免费 | 每个免费接口最高50次/天 |
高级会员 | 无限 | 100次 | 9.9元/月、99.9元/年 | 每个免费接口最高100次/天 |
黄金会员 | 无限 | 150次 | 14.9元/月、149.9元/年 | 每个免费接口最高150次/天 |
砖石会员 | 无限 | 200次 | 19.9元/月、199.9元/年 | 每个免费接口最高200次/天 |
本接口为会员免费类接口,如业务有更高需求可点此升级会员获得更高每日请求配额(年付限时优惠) |
错误信息可能会有所调整,请根据错误状态码(code)进行流程判断
错误状态码 | 错误信息 | 解释帮助 |
---|---|---|
100 | 缺少调用凭证 | 请检查是否传递了ak参数 |
101 | 当前API已下线 | 接口已下线无法使用,可关注相关通知 |
103 | API可用次数不足 | 计次类接口余额不足 |
104 | 当日免费次数已用完 | 免费类接口次数不足 |
106 | IP请求来源受限 | 请求来源IP在黑名单内 |
107 | 在用户黑名单里 | 通常为账号无效,此状态无法恢复 |
201 | 参数值不符合要求 | 参数值不符合基本格式要求 |
错误码1开头的是系统级错误,2开头的是用户级错误,其中200表示请求成功处理并计费。 |
此处代码仅演示关键请求片段,实际使用请根据具体环境修改
post方式请求时,enctype应为application/x-www-form-urlencoded
上传文件二进制数据流方式,enctype必须为multipart/form-data
参数url、base64中有特殊字符时,建议对值urlencode编码后传递
名称 | 类型 | 必须 | 示例值/默认值 | 说明 |
---|---|---|---|---|
ak | string | 是 | 您自己的APIKEY(注册账号后获得) | API密钥 |
hotelId | String | 是 | 474138 | 酒店id |
用户等级 | 免费接口数 | 每日可用次数 | 会员价格 | 说明 |
---|---|---|---|---|
普通会员 | 无限 | 50次 | 免费 | 每个免费接口最高50次/天 |
高级会员 | 无限 | 100次 | 9.9元/月、99.9元/年 | 每个免费接口最高100次/天 |
黄金会员 | 无限 | 150次 | 14.9元/月、149.9元/年 | 每个免费接口最高150次/天 |
砖石会员 | 无限 | 200次 | 19.9元/月、199.9元/年 | 每个免费接口最高200次/天 |
本接口为会员免费类接口,如业务有更高需求可点此升级会员获得更高每日请求配额(年付限时优惠) |
错误信息可能会有所调整,请根据错误状态码(code)进行流程判断
错误状态码 | 错误信息 | 解释帮助 |
---|---|---|
100 | 缺少调用凭证 | 请检查是否传递了ak参数 |
101 | 当前API已下线 | 接口已下线无法使用,可关注相关通知 |
103 | API可用次数不足 | 计次类接口余额不足 |
104 | 当日免费次数已用完 | 免费类接口次数不足 |
106 | IP请求来源受限 | 请求来源IP在黑名单内 |
107 | 在用户黑名单里 | 通常为账号无效,此状态无法恢复 |
201 | 参数值不符合要求 | 参数值不符合基本格式要求 |
错误码1开头的是系统级错误,2开头的是用户级错误,其中200表示请求成功处理并计费。 |
此处代码仅演示关键请求片段,实际使用请根据具体环境修改
post方式请求时,enctype应为application/x-www-form-urlencoded
上传文件二进制数据流方式,enctype必须为multipart/form-data
参数url、base64中有特殊字符时,建议对值urlencode编码后传递
名称 | 类型 | 必须 | 示例值/默认值 | 说明 |
---|---|---|---|---|
ak | string | 是 | 您自己的APIKEY(注册账号后获得) | API密钥 |
hotelId | String | 是 | 540562 | 酒店id |
inDate | String | 否 | 入住时间,格式为:YYYY-MM-DD(默认2天后) | |
outDate | String | 否 | 离开时间,格式为:YYYY-MM-DD(默认3天后) | |
excludeOta | Boolean | 否 | false | 排除禁止OTA裸售的数据,默认true |
用户等级 | 免费接口数 | 每日可用次数 | 会员价格 | 说明 |
---|---|---|---|---|
普通会员 | 无限 | 50次 | 免费 | 每个免费接口最高50次/天 |
高级会员 | 无限 | 100次 | 9.9元/月、99.9元/年 | 每个免费接口最高100次/天 |
黄金会员 | 无限 | 150次 | 14.9元/月、149.9元/年 | 每个免费接口最高150次/天 |
砖石会员 | 无限 | 200次 | 19.9元/月、199.9元/年 | 每个免费接口最高200次/天 |
本接口为会员免费类接口,如业务有更高需求可点此升级会员获得更高每日请求配额(年付限时优惠) |
错误信息可能会有所调整,请根据错误状态码(code)进行流程判断
错误状态码 | 错误信息 | 解释帮助 |
---|---|---|
100 | 缺少调用凭证 | 请检查是否传递了ak参数 |
101 | 当前API已下线 | 接口已下线无法使用,可关注相关通知 |
103 | API可用次数不足 | 计次类接口余额不足 |
104 | 当日免费次数已用完 | 免费类接口次数不足 |
106 | IP请求来源受限 | 请求来源IP在黑名单内 |
107 | 在用户黑名单里 | 通常为账号无效,此状态无法恢复 |
201 | 参数值不符合要求 | 参数值不符合基本格式要求 |
错误码1开头的是系统级错误,2开头的是用户级错误,其中200表示请求成功处理并计费。 |
此处代码仅演示关键请求片段,实际使用请根据具体环境修改
post方式请求时,enctype应为application/x-www-form-urlencoded
上传文件二进制数据流方式,enctype必须为multipart/form-data
参数url、base64中有特殊字符时,建议对值urlencode编码后传递
名称 | 类型 | 必须 | 示例值/默认值 | 说明 |
---|---|---|---|---|
ak | string | 是 | 您自己的APIKEY(注册账号后获得) | API密钥 |
hotelId | String | 是 | 5966251 | 酒店ID |
roomId | String | 是 | 1_5966251_2802_221802723_69221_3_154707940 | 价格计划id |
numberOfRooms | Number | 是 | 1 | 预订房间数 |
inDate | String | 是 | 2019-09-26 | 入店时间 |
outDate | String | 是 | 2019-09-27 | 离店时间 |
child | Number | 是 | 2 | 入住儿童数 |
man | Number | 是 | 1 | 成人数 |
childAges | String | 否 | 3,4 | 入住儿童的年龄数,注意如果有多名儿童的年龄请用,分隔 |
用户等级 | 免费接口数 | 每日可用次数 | 会员价格 | 说明 |
---|---|---|---|---|
普通会员 | 无限 | 50次 | 免费 | 每个免费接口最高50次/天 |
高级会员 | 无限 | 100次 | 9.9元/月、99.9元/年 | 每个免费接口最高100次/天 |
黄金会员 | 无限 | 150次 | 14.9元/月、149.9元/年 | 每个免费接口最高150次/天 |
砖石会员 | 无限 | 200次 | 19.9元/月、199.9元/年 | 每个免费接口最高200次/天 |
本接口为会员免费类接口,如业务有更高需求可点此升级会员获得更高每日请求配额(年付限时优惠) |
错误信息可能会有所调整,请根据错误状态码(code)进行流程判断
错误状态码 | 错误信息 | 解释帮助 |
---|---|---|
100 | 缺少调用凭证 | 请检查是否传递了ak参数 |
101 | 当前API已下线 | 接口已下线无法使用,可关注相关通知 |
103 | API可用次数不足 | 计次类接口余额不足 |
104 | 当日免费次数已用完 | 免费类接口次数不足 |
106 | IP请求来源受限 | 请求来源IP在黑名单内 |
107 | 在用户黑名单里 | 通常为账号无效,此状态无法恢复 |
201 | 参数值不符合要求 | 参数值不符合基本格式要求 |
错误码1开头的是系统级错误,2开头的是用户级错误,其中200表示请求成功处理并计费。 |
此处代码仅演示关键请求片段,实际使用请根据具体环境修改
post方式请求时,enctype应为application/x-www-form-urlencoded
上传文件二进制数据流方式,enctype必须为multipart/form-data
参数url、base64中有特殊字符时,建议对值urlencode编码后传递
名称 | 类型 | 必须 | 示例值/默认值 | 说明 |
---|---|---|---|---|
ak | string | 是 | 您自己的APIKEY(注册账号后获得) | API密钥 |
keywords | String | 是 | 火车站昆明 | 查询关键字,酒店名称、位置、品牌等 |
用户等级 | 免费接口数 | 每日可用次数 | 会员价格 | 说明 |
---|---|---|---|---|
普通会员 | 无限 | 50次 | 免费 | 每个免费接口最高50次/天 |
高级会员 | 无限 | 100次 | 9.9元/月、99.9元/年 | 每个免费接口最高100次/天 |
黄金会员 | 无限 | 150次 | 14.9元/月、149.9元/年 | 每个免费接口最高150次/天 |
砖石会员 | 无限 | 200次 | 19.9元/月、199.9元/年 | 每个免费接口最高200次/天 |
本接口为会员免费类接口,如业务有更高需求可点此升级会员获得更高每日请求配额(年付限时优惠) |
错误信息可能会有所调整,请根据错误状态码(code)进行流程判断
错误状态码 | 错误信息 | 解释帮助 |
---|---|---|
100 | 缺少调用凭证 | 请检查是否传递了ak参数 |
101 | 当前API已下线 | 接口已下线无法使用,可关注相关通知 |
103 | API可用次数不足 | 计次类接口余额不足 |
104 | 当日免费次数已用完 | 免费类接口次数不足 |
106 | IP请求来源受限 | 请求来源IP在黑名单内 |
107 | 在用户黑名单里 | 通常为账号无效,此状态无法恢复 |
201 | 参数值不符合要求 | 参数值不符合基本格式要求 |
错误码1开头的是系统级错误,2开头的是用户级错误,其中200表示请求成功处理并计费。 |
此处代码仅演示关键请求片段,实际使用请根据具体环境修改