预订宝/getHotelInfo
来自站长百科
getHotelInfo概述[ ]
- 接口地址:http://api.yudingbao.net/v1.0/hotel/hotelinfo.ashx?act=getHotelInfo
- 动作标识:getHotelInfo
- 参数:见参数说明
- 请求方式:GET
- 响应模式:JSON、JSONP、XML
注意:动作标识是大小写敏感的,请养成良好的编码习惯!
参数说明[ ]
数据格式[ ]
- 响应头:
- Status:0为正常,非0表示处理请求时发生异常,通常是参数校验错误;
- Messages:当Status为非0时该字段肯定包含一条或多条消息文本;
- 响应体:
酒店信息中可能出现以下几个置换符,调用数据时应当做相应处理:
替代符标签 | 说明 | |
---|---|---|
1 | {$Website.Domain$} | 应当替换为您自己网站的域名。 |
2 | {$Website.Name$} | 应当替换为您自己的网站名。 |
本接口返回的响应体表示一个酒店的详细信息,具体属性说明请参考下表。
序号 | 属性节点 | 数据类型 | 属性说明 | |
1 | Code | string | 酒店编号。 | |
2 | Name | string | 酒店名称。 | |
3 | Address | string | 酒店名称。 | |
4 | ZipCode | string | 酒店所在地的邮政编码。 | |
5 | Category | int | 酒店星级,可能出现的数字及含义如下: | |
0 —— 未评星 | ||||
1 —— 一星级 | ||||
2 —— 二星级 | ||||
3 —— 三星级 | ||||
4 —— 四星级 | ||||
5 —— 五星级 | ||||
6 | Typology | char | 酒店类型。目前该属性为常量“H”。 | |
7 | AvailPolicy | string | 酒店特殊提示信息,请在详情页显著位置展示。 | |
8 | Rating | int | 酒店在预订宝的评级。 | |
9 | Lng | double | 表示酒店地理位置的经度值。 | |
10 | Lat | double | 表示酒店地理位置的纬度值。 | |
11 | Country | string | 酒店所在国家,对于国内酒店,该属性为常量“中国”。 | |
12 | RegionCode | string | 酒店所在区域编号。 | |
13 | ProvinceCode | string | 酒店所在省份编号。 | |
14 | CityCode | string | 酒店所在城市编号。 | |
15 | DistrictCode | string | 酒店所在行政区编号。 | |
16 | BusinessZoneCode | string | 酒店所在商业区编号。 | |
17 | IntroEditor | string | 酒店详细介绍。 | |
18 | CCAccepted | string | 酒店支持的信用卡类型。 | |
19 | Description | string | 酒店描述。 | |
20 | AirportPickUpService | string | 酒店免费接机信息。 | |
21 | GeneralAmenities | string | 酒店服务设施信息。 | |
22 | RoomAmenities | string | 酒店房间服务设施信息。 | |
23 | RecreationAmenities | string | 酒店休闲服务设施信息。 | |
24 | FeatureInfo | string | 酒店特色信息。 | |
25 | ConferenceAmenities | string | 酒店会议服务设施信息。 | |
26 | DiningAmenities | string | 酒店餐饮服务设施信息。 | |
27 | TrafficAndAroundInformations | string | 酒店周边交通信息。 | |
28 | Landmarks | array | 酒店周边地标信息。这是一个键值对集合: | |
键名表示地标编号,键值表示地标名。 | ||||
29 | Rooms | array | 酒店房型。 | |
TypeId | string | 房型编号。 | ||
Name | string | 房型名称。 | ||
TypeNumber | int | 房型数量。举例:某酒店总计拥有xx个标准间。 | ||
Area | int | 房间面积。 | ||
Floor | string | 房间所在楼层。 | ||
Broadband | int | 宽带上网信息,可能出现的数字及含义如下: | ||
0 —— 无上网服务 | ||||
1 —— 收费。提供上网服务,但要收费。 | ||||
2 —— 免费。免费提供上网服务。 | ||||
BedDescription | string | 床型描述。 | ||
Note | string | 房型备注。 | ||
RatePlans | array | 房型价格排期。酒店基础信息中该属性总是为空数组。 | ||
30 | Images | array | 酒店图片。 | |
Url | string | 图片链接地址。 | ||
图片链接地址请使用此完整路径,该路径已经开通了CDN。 | ||||
Type | string | 图片类型。该属性当前无特定作用。 | ||
IsThumbnail | bool | 指示当前图片是否为缩略图。 | ||
Title | string | 图片标题。 | ||
31 | Thumbnail | string | 酒店默认缩略图地址(小图)。 | |
32 | Photo | string | 酒店默认照片地址(大图)。 | |
33 | Phone | string | 酒店联系电话。该属性当前为空。 | |
34 | Fax | string | 酒店传真。该属性当前为空。 | |
35 | OpeningDate | date | 酒店开店日期。 | |
36 | RenovationDate | date | 酒店最近的装修日期。 | |
37 | ChainBrandId | int | 酒店品牌。 | |
品牌详细定义可以通过getHotelChainBrands接口获取。 |
品牌详细定义可以通过getHotelChainBrands接口获取。
对于数据格式的理解,请参考下列示例代码中的XML响应演示,其中每个字段都标注了数据类型(日期类型在XML响应中统一使用GMT格式,但被标注为string,请开发者注意)。
示例代码[ ]
以下示例代码是通过HTML表单实现了该接口的部分操作,您在开发过程中应当使用自己的平台语言来模拟这些操作以捕获响应体,然后对响应体做出相应的操作。
请求示例
<!-- 这是该接口的请求示例,该接口的访问类同于如下表单的提交, 请注意:该表单使用控件的方法模拟了GET请求 --> <form id="myForm" method="get" action="http://api.yudingbao.net/v1.0/hotel/hotelinfo.ashx"> <p> <!--动作标识,注意动作标识是大小写敏感的--> <input id="act" name="act" value="getHotelInfo" type="text" /> </p> <p> <!--酒店编号--> <input id="hotelCode" name="hotelCode" value="h010t00101025" type="text" /> </p> <p> <!--指定响应格式为XML,这里以XML为例--> <input id="format" name="format" value="xml" type="text" /> <!--指定响应体应当是已格式化的,便于阅读代码,在生产环境中应当将该值设置为false--> <input id="indent" name="indent" value="true" type="text" /> <!--产品编号。在我的账户-分销产品的应用列表中可以找到该参数的值。--> <input id="aid" name="aid" value="78663" type="text" /> <!--接口密钥。在我的账户-分销产品的应用列表中可以找到该参数的值。--> <input id="key" name="key" value="0925ed633d24577eb3ffe13f00c55a4f9739f51a77eefb1dba29bb9568acddfd" type="text" /> <!--应用程序授权编号及公钥,这是可选的--> <input id="sid" name="sid" value="" type="text"> <input id="sKey" name="sKey" value="" type="text"> </p> <p> <input id="submit" name="submit" value="提交" type="submit"> </p> </form>
XML响应
<!--XML响应,响应体过大,已删节--> <?xml version="1.0" encoding="utf-8"?> <HttpResponse> <Status type="number">0</Status> <Messages type="array"> </Messages> <ResponseBody type="object"> <Code type="string">h010t00101025</Code> <Name type="string">北京博雅国际酒店</Name> <Address type="string">北京市朝阳区望京利泽中路1号</Address> <ZipCode type="string">100102</ZipCode> <Category type="number">5</Category> <Typology type="string">H</Typology> <AvailPolicy type="string"> </AvailPolicy> <Rating type="number">0</Rating> <Lng type="number">116.4697412</Lng> <Lat type="number">40.0139023</Lat> <Country type="string">中国</Country> <RegionCode type="string"> </RegionCode> <ProvinceCode type="string">0100</ProvinceCode> <CityCode type="string">0101</CityCode> <DistrictCode type="string">0003</DistrictCode> <BusinessZoneCode type="string">010138</BusinessZoneCode> <IntroEditor type="string">北京博雅国际酒店是一家高档商务酒店,位于望京高科技创业园区的博雅国际中心内。酒店拥有各类客房,内有豪华套间14套。酒店 地理位置极其优越,是名副其实的望京北大门,占据广顺北大街与东北五环交汇处。西邻奥运主会场,东接CBD商务中心区。出酒店大门直接驶入机场高速,驱车约25分钟便 可方便到达空港,是连接首都国际机场与亚奥商圈和燕莎商圈的枢纽,是京城又一座众人瞩目的商务新地标。 酒店的商务氛围浓厚,坐拥在博雅国际中心写字楼和公寓、叶青大厦与爱慕大厦外,与众多世界500强大公司为邻,诸如西门子、摩托罗拉、爱立信、安捷伦、松下电子 部品、三星电子等,一个"国际博雅、时尚博雅、舒适博雅"具有现代SOHO型国际品味的酒店,是商务客人理想的下榻之处。 酒店开业时间2007年12月6日,楼高26层,客房总数156间(套)。</IntroEditor> <CCAccepted type="string">Visacard,牡丹卡,金穗卡,长城卡,龙卡,太平洋卡,万事达卡,运通卡,大莱卡,JCBcard</CCAccepted> <Description type="string">酒店开业时间2007年12月6日,楼高26层,客房总数156间(套)。</Description> <AirportPickUpService type="string"> </AirportPickUpService> <GeneralAmenities type="string">送餐服务、洗衣服务、收费停车、叫醒服务、礼宾司服务、商务中心、会议服务、旅游服务、擦鞋服务、外币兑换</GeneralAmenities> <RoomAmenities type="string">中央空调、吹风机、拖鞋、单人床、浴衣、双人床、电热水壶、加大床、免费宽带、房间内可加床、小冰箱、淋浴/盆浴组合、房 内保险箱、写字台、免费瓶装水、熨斗/熨衣板、婴儿床</RoomAmenities> <RecreationAmenities type="string">桑拿按摩、健身房、室内游泳池</RecreationAmenities> <FeatureInfo type="string">酒店位于望京高科技创业园区内,紧邻爱立信、三星等世界500强公司,商务氛围浓厚。</FeatureInfo> <ConferenceAmenities type="string">25-26层会议室:提供白板、幕布、纸笔、MIC冰水、投影仪等会议用品。</ConferenceAmenities> <DiningAmenities type="string">中餐厅、西餐厅、咖啡厅</DiningAmenities> <TrafficAndAroundInformations type="string">酒店地处朝阳区广顺北大街与东北五环交汇处,方便去往首都机场,位置优越,出行便利。 - 至家乐福(望京北路)店,步行约5分钟; - 距离国家体育场(鸟巢、水立方)10公里,乘坐出租车约20分钟; - 距离天安门广场22公里,乘坐出租车约35分钟; - 距离北京首都国际机场19公里,乘坐出租车约25分钟; - 距离北京火车站19公里,乘坐出租车约25分钟; - 距离北京北站19公里,乘坐出租车约25分钟; - 距离北京西站27公里,乘坐出租车约40分钟。</TrafficAndAroundInformations> <Landmarks type="object"> <a:item xmlns:a="item" item="0425" type="string">望京科技园区</a:item> <a:item xmlns:a="item" item="0464" type="string">家乐福超市(望京店)</a:item> </Landmarks> <Rooms type="array"> <item type="object"> <TypeId type="string">1017</TypeId> <Name type="string">高级双人间</Name> <TypeNumber type="number">70</TypeNumber> <Area type="number">0</Area> <Floor type="string">22-26</Floor> <Broadband type="number">1</Broadband> <BedDescription type="string">免费上网,宽带,双床(130cm*200cm),</BedDescription> <Note type="string"> </Note> <RatePlans type="array"> </RatePlans> </item> <item type="object"> <TypeId type="string">1018</TypeId> <Name type="string">高级单人间</Name> <TypeNumber type="number">44</TypeNumber> <Area type="number">30</Area> <Floor type="string">22-26</Floor> <Broadband type="number">1</Broadband> <BedDescription type="string">免费上网,宽带,大床(180cm*200cm),</BedDescription> <Note type="string"> </Note> <RatePlans type="array"> </RatePlans> </item> <item type="object"> <TypeId type="string">1023</TypeId> <Name type="string">商务套间</Name> <TypeNumber type="number">9</TypeNumber> <Area type="number">0</Area> <Floor type="string">22-25</Floor> <Broadband type="number">1</Broadband> <BedDescription type="string">免费上网,宽带,大床(180cm*200cm),</BedDescription> <Note type="string">一室一厅</Note> <RatePlans type="array"> </RatePlans> </item> </Rooms> <Images type="array"> <item type="object"> <Url type="string">http://static.yudingbao.net/images/hotel/a/24/00101025_1_5_0_1.jpg</Url> <Type type="number">5</Type> <IsThumbnail type="boolean">true</IsThumbnail> <Title type="string">酒店外观</Title> </item> <item type="object"> <Url type="string">http://static.yudingbao.net/images/hotel/a/24/00101025_0_5_0_1.jpg</Url> <Type type="number">5</Type> <IsThumbnail type="boolean">false</IsThumbnail> <Title type="string">酒店外观</Title> </item> <item type="object"> <Url type="string">http://static.yudingbao.net/images/hotel/a/24/00101025_1_5_0_2.jpg</Url> <Type type="number">5</Type> <IsThumbnail type="boolean">true</IsThumbnail> <Title type="string">酒店外观</Title> </item> </Images> <Thumbnail type="string">http://static.yudingbao.net/images/hotel/a/24/00101025_1_5_0_1.jpg</Thumbnail> <Phone type="string"></Phone> <Fax type="string"> </Fax> <OpeningDate type="string">Wed, 01 Dec 0038 00:00:00 GMT</OpeningDate> <RenovationDate type="string">Wed, 01 Dec 0038 00:00:00 GMT</RenovationDate> </ResponseBody> </HttpResponse>
JSON响应
// Json响应,响应体过大,已删节 { "Status" : 0, "Messages" : [], "ResponseBody" : { "Code" : "h010t00101025", "Name" : "北京博雅国际酒店", "Address" : "北京市朝阳区望京利泽中路1号", "ZipCode" : "100102", "Category" : 5, "Typology" : "H", "AvailPolicy" : "", "Rating" : 0, "Lng" : 116.4697412, "Lat" : 40.0139023, "Country" : "中国", "RegionCode" : "", "ProvinceCode" : "0100", "CityCode" : "0101", "DistrictCode" : "0003", "BusinessZoneCode" : "010138", "IntroEditor" : "北京博雅国际酒店是一家高档商务酒店,位于望京高科技创业园区的博雅国际中心内。酒店拥有各类客房,内有豪华套间14套。酒店地理位置极 其优越,是名副其实的望京北大门,占据广顺北大街与东北五环交汇处。西邻奥运主会场,东接CBD商务中心区。出酒店大门直接驶入机场高速,驱车约25分钟便可方便到达 空港,是连接首都国际机场与亚奥商圈和燕莎商圈的枢纽,是京城又一座众人瞩目的商务新地标。 \n 酒店的商务氛围浓厚,坐拥在博雅国际中心写字楼和公寓、叶青大 厦与爱慕大厦外,与众多世界500强大公司为邻,诸如西门子、摩托罗拉、爱立信、安捷伦、松下电子部品、三星电子等,一个"国际博雅、时尚博雅、舒适博雅"具有现代 SOHO型国际品味的酒店,是商务客人理想的下榻之处。\n 酒店开业时间2007年12月6日,楼高26层,客房总数156间(套)。", "CCAccepted" : "Visacard,牡丹卡,金穗卡,长城卡,龙卡,太平洋卡,万事达卡,运通卡,大莱卡,JCBcard", "Description" : "酒店开业时间2007年12月6日,楼高26层,客房总数156间(套)。", "AirportPickUpService" : "", "GeneralAmenities" : "送餐服务、洗衣服务、收费停车、叫醒服务、礼宾司服务、商务中心、会议服务、旅游服务、擦鞋服务、外币兑换", "RoomAmenities" : "中央空调、吹风机、拖鞋、单人床、浴衣、双人床、电热水壶、加大床、免费宽带、房间内可加床、小冰箱、淋浴/盆浴组合、房内保险箱、 写字台、免费瓶装水、熨斗/熨衣板、婴儿床", "RecreationAmenities" : "桑拿按摩、健身房、室内游泳池", "FeatureInfo" : "酒店位于望京高科技创业园区内,紧邻爱立信、三星等世界500强公司,商务氛围浓厚。", "ConferenceAmenities" : "25-26层会议室:提供白板、幕布、纸笔、MIC冰水、投影仪等会议用品。", "DiningAmenities" : "中餐厅、西餐厅、咖啡厅", "TrafficAndAroundInformations" : "酒店地处朝阳区广顺北大街与东北五环交汇处,方便去往首都机场,位置优越,出行便利。\n- 至家乐福(望京北路)店, 步行约5分钟;\n- 距离国家体育场(鸟巢、水立方)10公里,乘坐出租车约20分钟;\n- 距离天安门广场22公里,乘坐出租车约35分钟;\n- 距离北京首都国际机场19公 里,乘坐出租车约25分钟;\n- 距离北京火车站19公里,乘坐出租车约25分钟; \n- 距离北京北站19公里,乘坐出租车约25分钟;\n- 距离北京西站27公里,乘坐出租车约 40分钟。", "Landmarks" : { "0425" : "望京科技园区", "0464" : "家乐福超市(望京店)" }, "Rooms" : [{ "TypeId" : "1017", "Name" : "高级双人间", "TypeNumber" : 70, "Area" : 0, "Floor" : "22-26", "Broadband" : 1, "BedDescription" : "免费上网,宽带,双床(130cm*200cm),", "Note" : "", "RatePlans" : [] }, { "TypeId" : "1018", "Name" : "高级单人间", "TypeNumber" : 44, "Area" : 30, "Floor" : "22-26", "Broadband" : 1, "BedDescription" : "免费上网,宽带,大床(180cm*200cm),", "Note" : "", "RatePlans" : [] }, { "TypeId" : "1023", "Name" : "商务套间", "TypeNumber" : 9, "Area" : 0, "Floor" : "22-25", "Broadband" : 1, "BedDescription" : "免费上网,宽带,大床(180cm*200cm),", "Note" : "一室一厅", "RatePlans" : [] }], "Images" : [{ "Url" : "http://static.yudingbao.net/images/hotel/a/24/00101025_1_5_0_1.jpg", "Type" : 5, "IsThumbnail" : true, "Title" : "酒店外观" }, { "Url" : "http://static.yudingbao.net/images/hotel/a/24/00101025_0_5_0_1.jpg", "Type" : 5, "IsThumbnail" : false, "Title" : "酒店外观" }, { "Url" : "http://static.yudingbao.net/images/hotel/a/24/00101025_1_5_0_2.jpg", "Type" : 5, "IsThumbnail" : true, "Title" : "酒店外观" }], "Thumbnail" : "http://static.yudingbao.net/images/hotel/a/24/00101025_1_5_0_1.jpg", "Phone" : "", "Fax" : "", "OpeningDate" : Date(1196467200000), "RenovationDate" : Date(1196467200000) } }
JSONP响应
// JsonP响应,响应体过大,已删节 jsoncallback({ "Status" : 0, "Messages" : [], "ResponseBody" : { "Code" : "h010t00101025", "Name" : "北京博雅国际酒店", "Address" : "北京市朝阳区望京利泽中路1号", "ZipCode" : "100102", "Category" : 5, "Typology" : "H", "AvailPolicy" : "", "Rating" : 0, "Lng" : 116.4697412, "Lat" : 40.0139023, "Country" : "中国", "RegionCode" : "", "ProvinceCode" : "0100", "CityCode" : "0101", "DistrictCode" : "0003", "BusinessZoneCode" : "010138", "IntroEditor" : "北京博雅国际酒店是一家高档商务酒店,位于望京高科技创业园区的博雅国际中心内。酒店拥有各类客房,内有豪华套间14套。酒店地理位置极 其优越,是名副其实的望京北大门,占据广顺北大街与东北五环交汇处。西邻奥运主会场,东接CBD商务中心区。出酒店大门直接驶入机场高速,驱车约25分钟便可方便到达 空港,是连接首都国际机场与亚奥商圈和燕莎商圈的枢纽,是京城又一座众人瞩目的商务新地标。 \n 酒店的商务氛围浓厚,坐拥在博雅国际中心写字楼和公寓、叶青大 厦与爱慕大厦外,与众多世界500强大公司为邻,诸如西门子、摩托罗拉、爱立信、安捷伦、松下电子部品、三星电子等,一个"国际博雅、时尚博雅、舒适博雅"具有现代 SOHO型国际品味的酒店,是商务客人理想的下榻之处。\n 酒店开业时间2007年12月6日,楼高26层,客房总数156间(套)。", "CCAccepted" : "Visacard,牡丹卡,金穗卡,长城卡,龙卡,太平洋卡,万事达卡,运通卡,大莱卡,JCBcard", "Description" : "酒店开业时间2007年12月6日,楼高26层,客房总数156间(套)。", "AirportPickUpService" : "", "GeneralAmenities" : "送餐服务、洗衣服务、收费停车、叫醒服务、礼宾司服务、商务中心、会议服务、旅游服务、擦鞋服务、外币兑换", "RoomAmenities" : "中央空调、吹风机、拖鞋、单人床、浴衣、双人床、电热水壶、加大床、免费宽带、房间内可加床、小冰箱、淋浴/盆浴组合、房内保险箱、 写字台、免费瓶装水、熨斗/熨衣板、婴儿床", "RecreationAmenities" : "桑拿按摩、健身房、室内游泳池", "FeatureInfo" : "酒店位于望京高科技创业园区内,紧邻爱立信、三星等世界500强公司,商务氛围浓厚。", "ConferenceAmenities" : "25-26层会议室:提供白板、幕布、纸笔、MIC冰水、投影仪等会议用品。", "DiningAmenities" : "中餐厅、西餐厅、咖啡厅", "TrafficAndAroundInformations" : "酒店地处朝阳区广顺北大街与东北五环交汇处,方便去往首都机场,位置优越,出行便利。\n- 至家乐福(望京北路)店, 步行约5分钟;\n- 距离国家体育场(鸟巢、水立方)10公里,乘坐出租车约20分钟;\n- 距离天安门广场22公里,乘坐出租车约35分钟;\n- 距离北京首都国际机场19公 里,乘坐出租车约25分钟;\n- 距离北京火车站19公里,乘坐出租车约25分钟; \n- 距离北京北站19公里,乘坐出租车约25分钟;\n- 距离北京西站27公里,乘坐出租车约 40分钟。", "Landmarks" : { "0425" : "望京科技园区", "0464" : "家乐福超市(望京店)" }, "Rooms" : [{ "TypeId" : "1017", "Name" : "高级双人间", "TypeNumber" : 70, "Area" : 0, "Floor" : "22-26", "Broadband" : 1, "BedDescription" : "免费上网,宽带,双床(130cm*200cm),", "Note" : "", "RatePlans" : [] }, { "TypeId" : "1018", "Name" : "高级单人间", "TypeNumber" : 44, "Area" : 30, "Floor" : "22-26", "Broadband" : 1, "BedDescription" : "免费上网,宽带,大床(180cm*200cm),", "Note" : "", "RatePlans" : [] }, { "TypeId" : "1023", "Name" : "商务套间", "TypeNumber" : 9, "Area" : 0, "Floor" : "22-25", "Broadband" : 1, "BedDescription" : "免费上网,宽带,大床(180cm*200cm),", "Note" : "一室一厅", "RatePlans" : [] }], "Images" : [{ "Url" : "http://static.yudingbao.net/images/hotel/a/24/00101025_1_5_0_1.jpg", "Type" : 5, "IsThumbnail" : true, "Title" : "酒店外观" }, { "Url" : "http://static.yudingbao.net/images/hotel/a/24/00101025_0_5_0_1.jpg", "Type" : 5, "IsThumbnail" : false, "Title" : "酒店外观" }, { "Url" : "http://static.yudingbao.net/images/hotel/a/24/00101025_1_5_0_2.jpg", "Type" : 5, "IsThumbnail" : true, "Title" : "酒店外观" }], "Thumbnail" : "http://static.yudingbao.net/images/hotel/a/24/00101025_1_5_0_1.jpg", "Phone" : "", "Fax" : "", "OpeningDate" : Date(1196467200000), "RenovationDate" : Date(1196467200000) } });