酒店信息

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

请求方式#

POST

uri: /hotel

Content-Type:application/json


请求参数说明#

RequestHeader#

公共请求头[引用]

RequestBody#

参数类型是否必填最大长度示例描述
hotelIdStringY3212**567华住酒店ID

响应参数说明#

公共响应参数[引用]

响应码-code[引用]

content#

参数类型是否必填最大长度示例描述
hotelIdStringY3212**567华住酒店ID
hotelNameStringY500酒店名称(中文)
hotelNameEnStringN500酒店名称(英文)
brandCodeIntegerY50酒店品牌Code
brandNameStringY50酒店品牌Name
provinceNoStringY16省份Code
provinceNameStringY64省份Name
cityNoStringY16城市Code
cityNameStringY64城市Name
countyNoStringY16区县code
countyNameStringY64区县名称
hotelAddressStringN500地址(中文)
hotelAddressEnStringN500地址(英文)
hotelAddressTipStringN500地址提示
telephoneStringN200电话
phoneCodeStringN16区号
faxStringN50传真
zipCodeStringN50邮编
roomNumIntegerN-客房数
hotelWordIntroduceStringN2000酒店介绍
longitudeStringN50经度
latitudeStringN50纬度
openingDateDateN-正式营业日期,格式:yyyy-MM-dd
firstOpeningDateDateN-首次开业日期, 格式:yyyy-MM-dd
overhaulTimeDateN-最近装修时间,格式:yyyy-MM-dd
trialOpeningDateDateN-酒店试营业日期, 格式:yyyy-MM-dd
operateScopeIdIntegerN-经营范围,取值码表经营范围
contactPositionString--职务 (该字段已废弃)
contactNameString--姓名 (该字段已废弃)
emailStringN100邮箱,联系酒店邮箱
internationalBooleanY-是否为国际酒店, 取值码表是否国际化
tradeCurrencyStringN20币种,参考国际标准: ISO-4217
invoiceTypeIntegerN-发票类型,取值码表发票类型
scaleOfTaxpayerIntegerN-纳税人规模,取值码表发票类型
cleanLevelIntegerN-干净级别,取值码表干净级别
hotelRoomTypeListList<HotelRoomType>N-酒店房型信息
hotelServiceListList<HotelService>N-酒店服务设施
hotelPhotoListList<HotelPhoto>N-酒店图片信息
hotelTrafficListList<HotelTraffic>N-酒店交通信息
HotelRoomType#
参数类型是否必填最大长度示例描述
roomTypeCodeStringY64房型Code
roomTypeNameStringY200房型名称
roomNumIntegerN-房型数量
summaryStringN500房型简介
hotelAreaIntegerN-面积,单位:平方米
floorPlaceStringN200楼层,如 1:代表1楼
bedWidthStringN200床宽,单位:米
isADSLStringN50是否可宽带上网, 取值码表宽度上网
isADSLWifiStringN50是否客房WIFI覆盖, 取值码表客房wifi覆盖
isHasWindowStringN50是否有窗, 取值码表是否有窗
isCanAddBedStringN50能否加床, 取值码表能否加床
hasSmokeFreeStringN50无烟, 取值码表是否有烟房
maxOccupancyIntegerN-最多入住人数
maxAdultIntegerN-最大成人数
maxChildIntegerN-最大儿童数
statusIntegerN-状态,房型的状态 1-启用 0-禁用
bedTypeListList<BedType>Y-床型
BedType#
参数类型是否必填最大长度示例描述
bedTypeCodeStringY20床型code
bedSpecNoStringY50床型规格业务编号(-1则为集团默认规格)
bedTypeNameStringN100床型名称
bedSpecStringN50床型规格名称
HotelService#
参数类型是否必填最大长度示例描述
childClassNameStringN50设施Name
childClassCodeIntegerN50设施Code, 取值码表typeMappingCode
childClassNameDescStringN200设施描述
HotelPhoto#
参数类型是否必填最大长度示例描述
fileNameStringN200文件名
fileTitleStringN100图片标题
fileFormatStringN20文件格式
fileSizeDoubleN1510文件大小
typeCodeStringN20文件类型, 取值码表typeCode
typeMappingCodeStringN50类型对应的具体code, 取值码表typeMappingCode
descriptStringN500文件说明
sortIdIntegerN-排序值,数字越小,图片越靠前
fileUrlStringN200图片URL
statusIntegerN-状态 1-启用 0-禁用
HotelTraffic#
参数类型是否必填最大长度示例描述
destinationTypeStringN10目的地类型, 取值码表目的地类型
destinationTypeNameStringN256目的地类型名称
destinationNameStringN256目的地名称
destinationDistanceStringN50目的地距离
trafficTipsStringN512交通提示

响应码#

异常码异常类型说明
1000Success
3201Invalid hotel Id酒店Id不存在
3202Hotel is closed酒店停业
3203No hotel detail can be found没有查询到酒店详情
3204The 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"
}