酒店信息

获取指定开业酒店的详细信息

请求方式

POST

uri: /hotel

Content-Type:application/json

---

请求参数说明

RequestHeader

公共请求头[引用]

RequestBody

参数	类型	是否必填	最大长度	示例	描述
hotelId	String	Y	32	12**567	华住酒店ID

---

响应参数说明

公共响应参数[引用]

响应码-code[引用]

content

参数	类型	是否必填	最大长度	示例	描述
hotelId	String	Y	32	12**567	华住酒店ID
hotelName	String	Y	500		酒店名称（中文）
hotelNameEn	String	N	500		酒店名称（英文）
brandCode	Integer	Y	50		酒店品牌Code
brandName	String	Y	50		酒店品牌Name
provinceNo	String	Y	16		省份Code
provinceName	String	Y	64		省份Name
cityNo	String	Y	16		城市Code
cityName	String	Y	64		城市Name
countyNo	String	Y	16		区县code
countyName	String	Y	64		区县名称
hotelAddress	String	N	500		地址（中文）
hotelAddressEn	String	N	500		地址（英文）
hotelAddressTip	String	N	500		地址提示
telephone	String	N	200		电话
phoneCode	String	N	16		区号
fax	String	N	50		传真
zipCode	String	N	50		邮编
roomNum	Integer	N	-		客房数
hotelWordIntroduce	String	N	2000		酒店介绍
longitude	String	N	50		经度
latitude	String	N	50		维度
openingDate	Date	N	-		正式营业日期，格式：yyyy-MM-dd
firstOpeningDate	Date	N	-		首次开业日期， 格式：yyyy-MM-dd
overhaulTime	Date	N	-		最近装修时间，格式：yyyy-MM-dd
trialOpeningDate	Date	N	-		酒店试营业日期, 格式：yyyy-MM-dd
operateScopeId	Integer	N	-		经营范围，取值码表经营范围
contactPosition	String	-	-		职务 (该字段已废弃)
contactName	String	-	-		姓名 （该字段已废弃）
email	String	N	100		邮箱，联系酒店邮箱
international	Integer	Y	-		是否为国际酒店， 取值码表是否国际化
tradeCurrency	String	N	20		币种，参考国际标准： ISO-4217
invoiceType	Integer	N	-		发票类型，取值码表发票类型
scaleOfTaxpayer	Integer	N	-		纳税人规模，取值码表发票类型
cleanLevel	Integer	N	-		干净级别，取值码表干净级别
hotelRoomTypeList	List<HotelRoomType>	Y	-		酒店房型信息
hotelServiceList	List<HotelService>	N	-		酒店服务设施
hotelPhotoList	List<HotelPhoto>	N	-		酒店图片信息
hotelTrafficList	List<HotelTraffic>	N	-		酒店交通信息

HotelRoomType

参数	类型	是否必填	最大长度	示例	描述
roomTypeCode	String	Y	64		房型Code
roomTypeName	String	Y	200		房型名称
roomNum	Integer	N	-		房型数量
summary	String	N	500		房型简介
hotelArea	Integer	N	-		面积，单位：平方米
floorPlace	String	N	200		楼层，如 1：代表1楼
bedWidth	String	N	200		床宽，单位：米
isADSL	String	N	50		是否可宽带上网， 取值码表宽度上网
isADSLWifi	String	N	50		是否客房WIFI覆盖， 取值码表客房wifi覆盖
isHasWindow	String	N	50		是否有窗， 取值码表是否有窗
isCanAddBed	String	N	50		能否加床， 取值码表能否加床
hasSmokeFree	String	N	50		无烟， 取值码表是否有烟房
maxOccupancy	Integer	N	-		最多入住人数
maxAdult	Integer	N	-		最大成人数
maxChild	Integer	N	-		最大儿童数
status	Integer	N	-		状态，房型的状态 1-启用 0-禁用
bedTypeList	List<BedType>	Y	-		床型

BedType

参数	类型	是否必填	最大长度	示例	描述
bedTypeCode	String	Y	20		床型code
bedSpecNo	String	Y	50		床型规格业务编号（-1则为集团默认规格）
bedTypeName	String	N	100		床型名称
bedSpec	String	N	50		床型规格名称

HotelService

参数	类型	是否必填	最大长度	示例	描述
childClassName	String	N	50		设施Name
childClassCode	Integer	N	50		设施Code， 取值码表typeMappingCode
childClassNameDesc	String	N	200		设施描述

HotelPhoto

参数	类型	是否必填	最大长度	示例	描述
fileName	String	N	200		文件名
fileTitle	String	N	100		图片标题
fileFormat	String	N	20		文件格式
fileSize	Double	N	1510		文件大小
typeCode	String	N	20		文件类型， 取值码表typeCode
typeMappingCode	String	N	50		类型对应的具体code， 取值码表typeMappingCode
descript	String	N	500		文件说明
sortId	Integer	N	-		排序值，数字越小，图片越靠前
fileUrl	String	N	200		图片URL
status	Integer	N	-		状态 1-启用 0-禁用

HotelTraffic

参数	类型	是否必填	最大长度	示例	描述
destinationType	String	N	10		目的地类型， 取值码表目的地类型
destinationTypeName	String	N	256		目的地类型名称
destinationName	String	N	256		目的地名称
destinationDistance	String	N	50		目的地距离
trafficTips	String	N	512		交通提示

响应码

异常码	异常类型	说明
1000	Success
3201	Invalid hotel Id	酒店Id不存在
3202	Hotel is closed	酒店停业
3203	No hotel detail can be found	没有查询到酒店详情
3204	The number of requests exceed the daily limit	请求次数超过每日限制
其他	全局异常码	全局异常[引用]

---

报文示例

Case1: 查询某家酒店详情

请求示例

{    "hotelId":"12**567"}

响应成功示例

{    "code":1000,    "content":{        "brandCode":2,        "brandName":"**庭",        "cityName":"上海市",        "cityNo":"310100",        "cleanLevel":"0",        "countyName":"黄浦区",        "countyNo":"310101",        "email":"xxx.huazhu.com",        "firstOpeningDate":1356883200000,        "fax":"63232217",        "hotelAddress":"上海**3**号",        "hotelAddressEn":"** Yan'an East Road, Huangpu District, Shanghai",        "hotelAddressTip":"近浙**食街",        "hotelName":"汉**酒店",        "hotelNameEn":"** Hotel Shanghai People's Square",        "hotelId":"12**567",        "hotelPhotoList":[            {                "descript":"",                "fileFormat":"jpg",                "fileName":"会议室",                "fileTitle":"会议室",                "fileUrl":"http://ws-p.**.com/f/k/1lz18g.jpg",                "sortId":10100,                "typeCode":"1",                "typeMappingCode":"3"            }        ],        "hotelRoomTypeList":[            {                "bedTypeList":[                    {                        "bedSpec":"1.8m*1.8m",                        "bedSpecNo":"-1",                        "bedTypeCode":"A",                        "bedTypeName":"大床"                    }                ],                "floorPlace":"",                "hasSmokeFree":"1",                "hotelArea":20,                "isCanAddBed":"1",                "isHasWindow":"1",                "maxOccupancy":999,                "maxChild":1,                "maxAdult":1,                "roomNum":1,                "roomTypeCode":"AAA",                "roomTypeName":"5A级大床海景房",                "status":1,                "summary":"描述"            }        ],        "hotelServiceList":[            {                "childClassCode":41,                "childClassName":"衣柜",                "childClassNameDesc":""            },            {                "childClassCode":49,                "childClassName":"中餐厅"            }        ],        "hotelTrafficList":[            {                "destinationDistance":"25km",                "destinationName":"飞机场",                "destinationType":"1",                "destinationTypeName":"飞机场",                "trafficTips":"请开车"            },            {                "destinationDistance":"35km",                "destinationName":"轮船",                "destinationType":"3",                "destinationTypeName":"轮船",                "trafficTips":"开船"            }        ],        "hotelWordIntroduce":"**酒店（**国际会展中心店）",        "invoiceType":1,        "international":false,        "latitude":"*1.2300*68507687",        "longitude":"1*.481*60034847",        "openingDate":1356883200000,        "operateScope":"1",        "provinceName":"上海市",        "provinceNo":"310000",        "roomNum":670,        "scaleOfTaxpayer":"123",        "phoneCode":"021",        "telephone":"632**814",        "tradeCurrency":"CNY",        "trialOpeningDate":1356883200000,        "zipCode":"200001"    }}

响应失败示例

{  "code": 3201,  "message": "Invalid hotel Id"}