酒店详情接口
渠道方应提供酒店详情信息接口供珞瑾调用
通过该接口获取酒店详情数据
调用方式
珞瑾调用渠道方
接口地址
请求参数
StaticHotelInfoReq
| 参数名称 | 参数类型 | 是否可为空 | 说明 |
|---|---|---|---|
| hotelId | String | 否 | 渠道方酒店id |
返回参数
| 参数名称 | 数据类型 | 是否可为空 | 节点描述 |
|---|---|---|---|
| code | Integer | 否 | 返回code 非200为失败 |
| message | String | 是 | 错误信息 |
| result | StaticHotelInfoResp | 否 | 返回结果 |
StaticHotelInfoResp
| 参数名称 | 参数类型 | 是否可为空 | 说明 |
|---|---|---|---|
| detail | Detail | 否 | 酒店详情数据 参考Detail节点 |
| rooms | List<Rooms> | 否 | 酒店房间列表 参考Room节点 |
| images | List<Image> | 否 | 酒店图片列表 参考Image节点 |
Detail节点
| 参数名称 | 参数类型 | 是否可为空 | 说明 |
|---|---|---|---|
| hotelId | String | 否 | 渠道方酒店id |
| hotelName | String | 否 | 酒店名字 |
| hotelNameEn | String | 是 | 酒店英文名称 |
| shortName | String | 是 | 酒店中文简称 |
| shortNameEn | String | 是 | 酒店英文简称 |
| address | String | 否 | 酒店中文地址 |
| addressEn | String | 是 | 酒店英文地址 |
| postalCode | String | 是 | 邮编 |
| starRate | Integer | 是 | 挂牌星级 与category二选一 |
| category | Integer | 是 | 非挂牌星级 与starRate 二选一 |
| phone | String | 否 | 电话 |
| fax | String | 是 | 传真 |
| String | 是 | 酒店邮箱地址 | |
| timezone | String | 是 | 酒店时区 |
| licenses | List<String> | 是 | 营业执照 |
| establishmentDate | String | 是 | 开业时间 |
| renovationDate | String | 是 | 装修时间 |
| groupName | String | 是 | 集团中文名称 |
| groupNameEn | String | 是 | 集团英文名称 |
| brandName | String | 是 | 品牌中文名称 |
| brandNameEn | String | 是 | 品牌英文名称 |
| isEconomic | Integer | 是 | 默认值为0,1代表是经济型酒店 |
| isApartment | Integer | 是 | 默认值为0,1代表是酒店式公寓 |
| arrivalTime | String | 是 | 酒店入住的最早时间,例如14:00表示酒店在入住日当天14:00之后允许客人入住 |
| departureTime | String | 是 | 酒店离店的最晚时间,例如12:00表示客人必须在离店日当天12:00之前离店 |
| baiduLat | decimal | 否 | Baidu纬度 如果不是百度请自行转换 |
| baiduLon | decimal | 否 | Baidu经度 如果不是百度请自行转换 |
| cityName | String | 是 | 城市中文名 |
| cityNameEn | String | 是 | 城市英文名 |
| district | String | 否 | 行政区Id |
| districtName | String | 是 | 行政区中文名称 |
| districtNameEn | String | 是 | 行政区英文名称 |
| businessZoneName | String | 是 | 主商圈中文名称 |
| businessZoneNameEn | String | 是 | 主商圈英文名称 |
| businessZone2Name | String | 是 | 附属商圈中文名 |
| businessZone2NameEn | String | 是 | 附属商圈英文名 |
| creditCards | String | 是 | 酒店支持的信用卡 |
| creditCardsEn | String | 是 | 酒店支持的信用卡英文 |
| introEditor | String | 是 | 酒店中文简介 |
| introEditorEn | String | 是 | 英文简介 |
| description | String | 是 | 中文描述 |
| descriptionEn | String | 是 | 英文描述 |
| airportPickUpService | String | 是 | 中文接机服务 |
| airportPickUpServiceEn | String | 是 | 英文接机服务 |
| generalFacilities | List<Facility> | 是 | 酒店基础施列表. 参考Facility节点 |
| recreationFacilities | List<Facility> | 是 | 酒店休闲设施列表 参考Facility节点 |
| serviceFacilities | List<Facility> | 是 | 酒店服务设施列表 参考Facility节点 |
| roomTotalAmount | Integer | 是 | 客房总数量 |
| hotelTypes | List<HotelType> | 是 | 酒店类型Ids:679(酒店),680(公寓),681(客栈\民宿),682(农家乐),1303(特色住宿),1304(青年旅舍),1305(别墅),1306(客栈),1403(连锁酒店),1404(休闲度假),1405(住宿加早餐旅馆),1406(旅舍),1407(汽车旅馆),1408(特色小屋),1409(排屋),1410(日式旅店),1411(摩洛哥特色旅馆),1412(Safari/帐篷屋),1413(船屋),1414(游轮),1415(城堡),1416(宫殿),1417(树屋)等,参考[HotelType节点] |
| parkInfos | List<ParkInfo> | 是 | 停车信息。参考[ParkInfo节点] |
| telList | List<Tel> | 是 | 联系信息。参考[Tel节点] |
Facility节点
| 参数名称 | 参数类型 | 是否可为空 | 说明 |
|---|---|---|---|
| facilityId | String | 否 | 设施ID |
| facilityName | String | 是 | 设施中文名称 |
| facilityNameEn | String | 是 | 设施英文名称 |
HotelType节点
| 参数名称 | 参数类型 | 是否可为空 | 说明 |
|---|---|---|---|
| hotelTypeId | String | 否 | 酒店类型ID |
| hotelTypeName | String | 是 | 酒店类型中文名称 |
| hotelTypeNameEn | String | 是 | 酒店类型英文名称 |
Room节点
| 参数名称 | 参数类型 | 是否可为空 | 说明 |
|---|---|---|---|
| roomId | String | 否 | 渠道方的房型id |
| roomName | String | 否 | 房型中文名称 |
| roomNameEn | String | 是 | 房型英文名称 |
| area | String | 是 | 房型面积 |
| floor | String | 是 | 楼层 |
| broadnetAccess | Integer | 是 | 上网情况 0表示无宽带,1 表示有宽带, 2 表示有WIFI 国际酒店不存在、国内酒店存在 |
| broadnetFee | Integer | 是 | 上网费用 0表示免费,1 表示收费 国际酒店不存在、国内酒店存在 |
| bedType | Integer | 否 | 床型中文名称 **参考床型码表 ** |
| description | String | 是 | 包括床型、宽带等信息,可自行从Facilities中解析 |
| descriptionEn | String | 是 | 英文描述 |
| comments | String | 是 | 中文备注 |
| commentsEn | String | 是 | 英文备注 |
| capacity | Integer | 否 | 房间最大入住人数 |
| facilities | List<Facility> | 是 | 房间设施列表 参见Facility节点 |
Image 节点
| 参数名称 | 参数类型 | 是否可为空 | 说明 |
|---|---|---|---|
| imageId | String | 否 | 图片id (32位) |
| roomId | String | 是 | 渠道方房型ID 如果为空 就是酒店图片 |
| type | String | 是 | 酒店图片必传 房型图片不需要 图片类型 1 - 餐厅 (Restaurant)<br/>2 - 休闲 (Recreation Facilities)<br/>3 - 会议室 (Meeting/Conference)<br/>5 - 外观 (Exterior)<br/>6 - 大堂/接待台 (Lobby/ Reception)<br/>8 - 客房 (Guest Room)<br/>10 - 其他 (Other Facilities)<br/>11 - 公共区域 (Public Area)<br/>12 - 周边景点 (Nearby Attractions) |
| typeName | String | 是 | 图片类型中文名 |
| typeNameEn | String | 是 | 图片类型英文名 |
| authorType | String | 是 | 图片来源 由用户上传,或者酒店上传,Hotel - 酒店;User - 用户 |
| isCoverImage | Boolean | 是 | 是否是主图 当值为true的时候,表示这个图片是主图(封面图),可用于显示在列表中 |
| isRoomCoverImage | Boolean | 是 | 是否为房间主图 当值为true的时候,表示这个图片是房间主图,可用于显示在列表中 |
| locations | List<Location> | 是 | 图片地址列表 参考[Location节点] |
Location 节点
| 参数名称 | 参数类型 | 是否可为空 | 说明 |
|---|---|---|---|
| waterMark | Integer | 否 | 是否有水印 0-无,1-有。默认为有水印图片 |
| size | Integer | 是 | 尺寸类型 包含以下尺寸类型 1:375x200、2:350x350、3:640x960、4:800x600、5:1080x800、6:1140x640 |
| url | String | 否 | 图片地址 |
ParkInfo 节点
| 参数名称 | 参数类型 | 是否可为空 | 说明 |
|---|---|---|---|
| title | String | 是 | 名称 |
| desc | String | 是 | 描述 |
| type | String | 否 | 类型 |
Tel节点
| 参数名称 | 参数类型 | 是否可为空 | 说明 |
|---|---|---|---|
| nationCode | String | 是 | 国家码 中国 +86 |
| areaCode | String | 是 | 区域码 上海:021 |
| mainCode | String | 否 | 主机号 |
| extCode | String | 是 | 分机号 |
| type | String | 否 | 类型 1:座机 2:手机号 |
床型码表
| 床型code | 床型名称 |
|---|---|
| 1 | 双床 |
| 3 | 大床 |
| 4 | 通铺 |
| 5 | 一单一双 |
| 6 | 圆床 |
| 7 | 水床 |
| 8 | 榻榻米 |
| 9 | 大/双床 |
| 10 | 三床 |
| 11 | 上下铺 |
| 12 | 单人床 |
| 13 | 拼床 |
| 99 | 未知 |
示例请求数据:
{
"hotelId":""
}
示例返回数据:
{
"detail":{
"address":"",
"addressEn":"",
"airportPickUpService":"",
"airportPickUpServiceEn":"",
"arrivalTime":"",
"baiduLat":"",
"baiduLon":"",
"brandName":"",
"brandNameEn":"",
"businessZone2Name":"",
"businessZone2NameEn":"",
"businessZoneName":"",
"businessZoneNameEn":"",
"category":0,
"cityName":"",
"cityNameEn":"",
"creditCards":"",
"creditCardsEn":"",
"departureTime":"",
"description":"",
"descriptionEn":"",
"district":"",
"districtName":"",
"districtNameEn":"",
"email":"",
"establishmentDate":"",
"fax":"",
"generalFacilities":[
{
"facilityId":"",
"facilityName":"",
"facilityNameEn":""
}
],
"groupName":"",
"groupNameEn":"",
"hotelId":"",
"hotelName":"",
"hotelNameEn":"",
"hotelTypes":[
{
"hotelTypeId":"",
"hotelTypeName":"",
"hotelTypeNameEn":""
}
],
"id":0,
"introEditor":"",
"introEditorEn":"",
"isApartment":"",
"isEconomic":"",
"licenses":"",
"parkInfos":[
{
"desc":"",
"title":"",
"type":""
}
],
"phone":"",
"postalCode":"",
"recreationFacilities":[
{
"facilityId":"",
"facilityName":"",
"facilityNameEn":""
}
],
"renovationDate":"",
"roomTotalAmount":0,
"serviceFacilities":[
{
"facilityId":"",
"facilityName":"",
"facilityNameEn":""
}
],
"shortName":"",
"shortNameEn":"",
"starRate":0,
"telList":[
{
"areaCode":"",
"extCode":"",
"mainCode":"",
"nationCode":"",
"type":""
}
],
"timezone":""
},
"images":[
{
"authorType":"",
"channelId":"",
"hotelId":"",
"imageId":"",
"isCoverImage":false,
"isRoomCoverImage":false,
"locations":[
{
"size":0,
"url":"",
"waterMark":0
}
],
"roomId":"",
"type":"",
"typeName":"",
"typeNameEn":""
}
],
"rooms":[
{
"area":"",
"bedType":0,
"broadnetAccess":0,
"broadnetFee":0,
"capacity":0,
"comments":"",
"commentsEn":"",
"description":"",
"descriptionEn":"",
"facilities":"",
"floor":"",
"hotelId":"",
"id":0,
"roomId":"",
"roomName":"",
"roomNameEn":""
}
]
}