国内酒店预定

该接口所返回的所有图片链接将在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权限无效
在线咨询
4009988033
客服
微信
客服微信
商务
微信
商务微信
在线咨询
4009988033
客服
微信
客服微信
商务
微信
商务微信