酒店搜索
实名核验
高质量实名验证身份证、银行卡API接口。直连官方实时核验，毫秒级响应，零缓存，信息验证100%可靠。准确 • 高效 • 稳定！对银行卡2、3、4要素及身份证消息进行实名验证，广泛应用于信贷、网络实名、远程身份核查和安防等行业的实名认证场景。
国内酒店预定
该接口所返回的所有图片链接将在12小时内自动销毁，若有需要这些图片的用户，请及时下载保存
会员资源包统一计费
27万+
累计调用
服务商: 昆明秀派科技有限公司
电话: 400-998-8033
QQ: 4009988033
邮箱: services@showapi.com
全国快递查询
支持顺丰！支持国内外1500+快递物流公司订单查询，自动识别单号，覆盖范围广，接口稳定，实时更新！支持按单与按次查询、物流轨迹查询、同步/异步查询等方式，以满足企业对快递物流查询多维度的需求。【快递新用户请使用：全国快递物流查询-V2，V2与V1的区别请<a href='https://www.showapi.com/images/apiGateway/kd_v1VSv2.png' target='_blank'>点击查看</a>】
天气预报
通过坐标区域、IP、地名、景点名称、电话区号或邮编等有效信息可查询天气情况（天气状况、湿度、天气图标、实时温度、风向、风级、紫外线、穿衣指南、空气指数）。可查询到当前天气、未来24小时、7天、15天、40天内天气预报和过往的历史天气情况等数据。
股票数据分析查询
查询历史数据的分析统计。本接口数据仅用于学习分析，不得用于对外展示！根据股票代码、日期获取股票历史数据及相关分析，返回日期、开盘价、收盘价、最高价、最低价、成交量、成交额、换手率、涨跌幅等，可绘制相应日线图及走势分析 。
车辆违章查询
【全国车辆违章查询，包括大小车、新能源车、货车、客车违章记录、违章信息查询】查询全国车辆违章记录，查询车辆违章记录、违章时间、违章行为、罚款金额，计分等数据。
三网手机号实名认证
支持移动、联通、电信三网合一的手机号实名验证。使用身份证、姓名、手机号校验信息是否真实一致，验证一致时会返回验证的手机归属地、运营商名称、籍贯、性别、生日等信息，数据实时更新、高质量接口，准确率高达99.99%。
条码查询接口
根据条码信息，返回此条码对应商品的名称、价格、厂家、图片等资料。能够实现来源可查、去向可追、责任可究，从而有效控制产品质量安全风险，保障消费者权益。极大的降低运营成本，提升数据质量，避免人工出错的可能。
三网短信通知类（需要模板）
支持三大运营商和虚拟运营商的通知类短信发送。首次使用时，请先创建模板，待模板审核通过后（审核需一个工作日）才能发送短信。【注意细则，请<a href='https://www.showapi.com/images/apiGateway/premise_text.png' target='_blank'>点击查看</a>】
银行卡归属地查询
支持全国500+银行卡卡片查询，银行卡归属地查询-银行卡开户行查询，支持中国银行、农行、建行、邮政、交通银行、招商银行、浦发银行、兴业银行、华夏银行、民生银行、光大银行等在内的500多家卡种归属地查询。基本资料查询（银行名称、卡类型（是借记卡还是信用卡）， 没有查到归属地不扣次数。
接入点说明:
每次最大返回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_fee_num | int | 1 | 计费次数标识。为0时表示不计费。大于0时代表计费几次。比如发送长短信时可能会多次计费。 通常此字段值为1，代表计费1次。 |
| 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权限无效 |
