酒店搜索
国内酒店预定
该接口所返回的所有图片链接将在12小时内自动销毁，若有需要这些图片的用户，请及时下载保存
会员资源包统一计费
12万+
累计调用
服务商: 昆明秀派科技有限公司
电话: 400-998-8033
QQ: 3007663665
邮箱: services@showapi.com
接入点说明:
每次最大返回30条接口地址:
http[s]://route.showapi.com/1653-1?showapi_appid=替换自己的值&showapi_sign=替换自己的值
查看密钥
返回格式:
json
更新频率:
同酒店关键词搜索
功能体验
请求参数
| 参数名称 | 类型 | 默认值 | 示例值 | 必须 | 描述 |
|---|---|---|---|---|---|
| page | String |
0
|
是 | 页码 | |
| cityName | String | 北京 |
成都
|
否 | 城市 |
| inDate | String | 否 | 入住时间，格式为：YYYY-MM-DD（默认2天后） | ||
| outDate | String | 否 | 离开时间，格式为：YYYY-MM-DD（默认3天后） | ||
| sortKey | String | recommend |
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 | 10 |
30
|
是 | 每页条数，最大30条 |
| keyWords | String | 否 | 搜索关键词 |
返回参数
| 参数名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| ret_code | Number |
0
|
|
| remark | String |
查询成功
|
|
| showapi_fee_code | Number |
0
|
|
| errorCode | Number |
231000
|
错误信息 |
| data | Object | ||
| - count | Number |
36097
|
酒店数量 |
| - hotelList | Object[] | ||
| - 0 | Object | ||
| - englishName | String | 酒店英文名 | |
| - picture | String |
http://m.tuniucdn.com/fb2/t1/G4/M00/6E/46/Cii_J11msD-IY5mCAAQQBhRifGsAAKSQwNvzjcABBAe359.jpg
|
图片 |
| - price | Number |
224
|
起价 |
| - chineseName | String |
维也纳酒店(成都春熙路李家沱地铁站店)
|
酒店中文名 |
| - starName | String |
舒适型
|
等级 |
| - address | String |
二环路北四段9号
|
地址 |
| - star | Number |
7
|
星级 |
| - longitude | Number |
104.1
|
经度 |
| - latitude | Number |
30.69
|
纬度 |
| - hotelId | Number |
656667
|
酒店ID |
| - facilities | String[] |
[3,7]
|
|
| - filter | Object[] | 设施 枚举如下： 1.免费wifi 2.餐厅 3.停车场 4.接机服务 5.免费洗漱用品 7.游泳池 8.健身房 9.会议室 10.SPA 12.24小时热水 | |
| - 0 | Object | ||
| - filterId | String |
area
|
过滤条件id |
| - filterName | String |
位置
|
条件过滤名称 |
| - pros | Object[] | 过滤条件的子信息 | |
| - 0 | Object | ||
| - poiKey | String |
DISTRICT
|
区域关键字 |
| - poiName | String |
行政区
|
关节字名称 |
| - filter | Object[] | ||
| - 0 | Object | ||
| - hotelCount | Number |
2401
|
区域内酒店数量 |
| - name | String |
锦江区
|
名称 |
| - longitude | Number |
104.07
|
大体经度 |
| - code | Number |
41871
|
代码 |
| - latitude | Number |
30.66
|
大体维度 |
| - heat | Number |
85
|
过滤器内数量 |
| - 1 | Object | ||
| - poiKey | String |
AIRPORT&TRAIN
|
|
| - poiName | String |
机场/火车
|
|
| - filter | Object[] | ||
| - 0 | Object | ||
| - hotelCount | Number |
763
|
|
| - name | String |
成都双流国际机场
|
|
| - longitude | Number |
103.95
|
|
| - code | Number |
1841626
|
|
| - latitude | Number |
30.57
|
|
| - heat | Number |
526
|
|
| - 2 | Object | ||
| - poiKey | String |
UNIVERSITY
|
|
| - poiName | String |
大学
|
|
| - filter | Object[] | ||
| - 0 | Object | ||
| - hotelCount | Number |
8570
|
|
| - name | String |
四川大学
|
|
| - longitude | Number |
104.08
|
|
| - code | Number |
2016853
|
|
| - latitude | Number |
30.63
|
|
| - heat | Number |
17
|
|
| - 3 | Object | ||
| - poiKey | String |
BUSINESS
|
|
| - poiName | String |
商圈
|
|
| - filter | Object[] | ||
| - 0 | Object | ||
| - hotelCount | Number |
12050
|
|
| - name | String |
春熙路商业区
|
|
| - longitude | Number |
104.08
|
|
| - code | Number |
46408
|
|
| - latitude | Number |
30.65
|
|
| - heat | Number |
728
|
|
| - 4 | Object | ||
| - poiKey | String |
SPOT
|
|
| - poiName | String |
景点
|
|
| - filter | Object[] | ||
| - 0 | Object | ||
| - hotelCount | Number |
0
|
|
| - name | String |
春熙路步行街
|
|
| - longitude | Number |
104.08
|
|
| - code | Number |
4082
|
|
| - latitude | Number |
30.66
|
|
| - heat | Number |
0
|
|
| - 1 | Object | ||
| - filterId | String |
brand
|
过滤条件id |
| - filterName | String |
品牌
|
条件过滤名称 |
| - pros | Object[] | ||
| - 0 | Object | ||
| - hotelCount | Number |
25
|
|
| - name | String |
全季
|
|
| - code | Number |
520
|
|
| - 2 | Object | ||
| - filterId | String |
feature
|
过滤条件id |
| - filterName | String |
特色
|
条件过滤名称 |
| - pros | Object[] | ||
| - 0 | Object | ||
| - hotelCount | Number |
10389
|
|
| - name | String |
特价频道
|
|
| - code | Number |
8434
|
|
| - 3 | Object | ||
| - filterId | String |
facility
|
过滤条件id |
| - filterName | String |
设施
|
条件过滤名称 |
| - pros | Object[] | ||
| - 0 | Object | ||
| - hotelCount | Number |
10
|
|
| - name | String |
棋牌室
|
|
| - code | Number |
24
|
|
| msg | String |
success
|
错误信息 |
| success | Boolean |
true
|
是否成功 |
返回示例
{
"showapi_res_error": "",
"showapi_res_id": "4456a49c86f54819b1cb560589a79661",
"showapi_res_code": 0,
"showapi_res_body": {
"ret_code": 0,
"remark": "查询成功",
"showapi_fee_code": 0,
"errorCode": 231000,
"data": {
"count": 36097,
"hotelList": [
{
"englishName": "",
"picture": "http://m.tuniucdn.com/fb2/t1/G4/M00/6E/46/Cii_J11msD-IY5mCAAQQBhRifGsAAKSQwNvzjcABBAe359.jpg",
"price": 224,
"chineseName": "维也纳酒店(成都春熙路李家沱地铁站店)",
"starName": "舒适型",
"address": "二环路北四段9号",
"star": 7,
"longitude": 104.096032,
"latitude": 30.691886,
"hotelId": 656667,
"facilities": [
3,
7
]
}
],
"filter": [
{
"filterId": "area",
"filterName": "位置",
"pros": [
{
"poiKey": "DISTRICT",
"poiName": "行政区",
"filter": [
{
"hotelCount": 2401,
"name": "锦江区",
"longitude": 104.073489,
"code": 41871,
"latitude": 30.664058,
"heat": 85
}
]
},
{
"poiKey": "AIRPORT&TRAIN",
"poiName": "机场/火车",
"filter": [
{
"hotelCount": 763,
"name": "成都双流国际机场",
"longitude": 103.947105,
"code": 1841626,
"latitude": 30.567456,
"heat": 526
}
]
},
{
"poiKey": "UNIVERSITY",
"poiName": "大学",
"filter": [
{
"hotelCount": 8570,
"name": "四川大学",
"longitude": 104.082425,
"code": 2016853,
"latitude": 30.631183,
"heat": 17
}
]
},
{
"poiKey": "BUSINESS",
"poiName": "商圈",
"filter": [
{
"hotelCount": 12050,
"name": "春熙路商业区",
"longitude": 104.075,
"code": 46408,
"latitude": 30.65,
"heat": 728
}
]
},
{
"poiKey": "SPOT",
"poiName": "景点",
"filter": [
{
"hotelCount": 0,
"name": "春熙路步行街",
"longitude": 104.078433,
"code": 4082,
"latitude": 30.657308,
"heat": 0
}
]
}
]
},
{
"filterId": "brand",
"filterName": "品牌",
"pros": [
{
"hotelCount": 25,
"name": "全季",
"code": 520
}
]
},
{
"filterId": "feature",
"filterName": "特色",
"pros": [
{
"hotelCount": 10389,
"name": "特价频道",
"code": 8434
}
]
},
{
"filterId": "facility",
"filterName": "设施",
"pros": [
{
"hotelCount": 10,
"name": "棋牌室",
"code": 24
}
]
}
]
},
"msg": "success",
"success": true
}
}
1、系统级返回（所有接入点都会返回的参数）
| 参数名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| showapi_res_body | String | {"city":"昆明","prov":"云南"} | 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 |
| showapi_res_code | int | 0 | 查看错误码 |
| showapi_res_error | String | 用户输入有误! | 错误信息的展示 |
| showapi_res_id | String | ce135f6739294c63be0c021b76b6fbff | 本次请求id |
2、错误码 (showapi_res_code)
| 状态码 | 描述 |
|---|---|
| 0 | 成功 |
| -1 | 系统调用错误 |
| -2 | 可调用次数或金额为0 |
| -3 | 读取超时 |
| -4 | 服务端返回数据解析错误 |
| -5 | 后端服务器DNS解析错误 |
| -6 | 服务不存在或未上线 |
| -7 | API创建者的网关资源不足 |
| -3 | 读取超时 |
| -1000 | 系统维护 |
| -1002 | showapi_appid字段必传 |
| -1003 | showapi_sign字段必传 |
| -1004 | 签名sign验证有误 |
| -1005 | showapi_timestamp无效 |
| -1006 | app无权限调用接口 |
| -1007 | 没有订购套餐 |
| -1008 | 服务商关闭对您的调用权限 |
| -1009 | 调用频率受限 |
| -1010 | 找不到您的应用 |
| -1011 | 子授权app_child_id无效 |
| -1012 | 子授权已过期或失效 |
| -1013 | 子授权ip受限 |
| -1014 | token权限无效 |
