酒店详情接口
渠道方应提供酒店详情信息接口供珞瑾调用
通过该接口获取酒店详情数据
调用方式
珞瑾调用渠道方
接口地址
请求参数
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":""
}
]
}