酒店列表
酒店基础数据，请求方式：http，返回json格式。
特殊可选参数不能同时为空
时间格式请求时注意转译URLEncoder.encod(updateTime, "UTF-8")
接口地址
| 名称 | 请求格式 | 测试地址 |
|---|---|---|
| 酒店列表 | GET | http://58.250.56.5:8158/api/hotel/queryHotelList.json?reqData=xxx |
系统输入参数
| 名称 | 编码 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|
| 客户编号 | appKey | String | SZ28276 | 捷旅提供 |
| 时间戳 | timestamp | String | 1516816895000 | Unix时间戳 |
| 数字签名 | sign | String | 063cae11a00896187f80eecbf922364a | 签名方法：md5(md5(secretKey+appKey)+timestamp)md5采用32位小写。 |
| 版本 | version | String | 3.0.1 | 版本信息，请参考版本说明 |
系统输出参数
| 名称 | 编码 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|
| 结果代码 | code | Integer | 0 | 0表示请求成功；非0表示存在业务异常。 |
| 结果描述 | errorMsg | String | 错误描述 | |
| 版本 | version | String | 3.0.1 | |
| 结果对象 | result | String | 不同的请求是不同的对象，错误的请求一般返回为空 | |
| 响应码 | respId | String | 单次响应的唯一编码，业务问题排查请提供编码 |
输入参数
| 名称 | 编码 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 国家编号 | countryId | Integer | 特殊可选 | 70007 | 70007中国大陆、港澳台70008,70009,70555 1.未带updatetime（修改时间）请求的，必须传入省份或者城市 2.带了updatetime（修改时间）请求的，不受该限制 3.updatetime（修改时间）最大查询2个月内数据 |
| 省份编号 | stateId | Integer | 特殊可选 | 70017 | 无 |
| 城市编号 | cityId | Integer | 特殊可选 | 70002 | 无 |
| 页码 | pageIndex | Integer | 是 | 1 | |
| 每页数量 | pageSize | Integer | 是 | 最大1000条记录 | |
| 修改时间 | updateTime | String | 特殊可选 | yyyy-MM-dd hh:mm:ss | |
| 是否即时确认 | isConfirm | Integer | 否 | 0:全部、1:即时确认、2:待查 |
输入示例
{"head":{"appKey":"SZ28276","timestamp":"1516816895000","sign":"063cae11a00896187f80eecbf922364a","version":"3.0.1"},"data":{"countryId":"70007","pageIndex":0,"pageSize":2}}
返回参数
| 名称 | 编码 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|
| 酒店总数 | count | Integer | 300 | |
| 页码 | pageIndex | Integer | 无 | 1 |
| 每页数量 | pageSize | Integer | 无 | 10 |
| 酒店数组 | hotels | HotelInfo[] | 无 | HotelInfo定义见下表 |
HotelInfo
对象包括酒店信息。
属性
| 名称 | 编码 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|
| 酒店编号 | hotelId | Integer | 无 | |
| 国家编号 | countryId | Integer | 70007 | |
| 省份编号 | stateId | Integer | 70017 | |
| 城市编号 | cityId | Integer | 70002 | |
| 酒店星级 | star | Integer | 无 | |
| 酒店中文名 | hotelNameCn | String | 捷旅IT测试酒店 | |
| 酒店英文名 | hotelNameEn | String | JetourITTestHotel | |
| 中文地址 | addressCn | String | 中兴路105号儒骏大厦 | |
| 英文地址 | addressEn | String | 无 | |
| 酒店总机 | phone | String | 0755123456789 | |
| 经度 | longitude | String | 119.8636 | |
| 纬度 | latitude | String | 31.4368 | |
| 是否即时确认 | instantConfirmation | Integer | 无 | 0:全部、1:即时确认、2:待查 |
| 是否热销酒店 | sellType | Integer | 无 | |
| 修改时间 | updateTime | String | 无 | yyyy-MM-dd hh:mm:ss |
返回示例
{"respId":"160b8746-a895-44af-b63b-b30f46ba4151","code":0,"errorMsg":"","result":{"count":300,"pageIndex":0,"pageSize":2,"hotels":[{"hotelId":1,"countryId":70007,"stateId":70017,"cityId":70002,"star":45,"hotelNameCn":"捷旅IT测试酒店","hotelNameEn":"JetourITTestHotel","addressCn":"中兴路105号儒骏大厦哈哈","addressEn":"ZhongxingRoad105RujunBuilding","phone":"0755123456789","longitude":"119.8636","latitude":"31.4368","sellType":0,"updateTime":"2018-01-0103:15:03"},{"hotelId":42,"countryId":70007,"stateId":70017,"cityId":30000961,"star":55,"hotelNameCn":"汕尾巴黎半岛酒店","hotelNameEn":"ShanweiParispeninsulahotel","addressCn":"汕尾市城区城区汕尾大道中段","addressEn":".","phone":"0660-3216888","longitude":"","latitude":"","sellType":0,"updateTime":"2018-01-0103:14:52"}]}}