HotelBE数据缓存接口文档资料.docx
- 文档编号:11585214
- 上传时间:2023-03-19
- 格式:DOCX
- 页数:61
- 大小:45.02KB
HotelBE数据缓存接口文档资料.docx
《HotelBE数据缓存接口文档资料.docx》由会员分享,可在线阅读,更多相关《HotelBE数据缓存接口文档资料.docx(61页珍藏版)》请在冰豆网上搜索。
HotelBE数据缓存接口文档资料
中国航信HotelBE数据缓存接口描述
V1.5.1
中国民航信息网络股份有限公司
2012年3月
变更记录
Date
Version
Description
Author
2010/12
1.0.0
版本发布
王贽
2010.12.14
1.0.1
1.城市信息查询,countycode=”ALL”,查询所有国家
2.酒店静态信息查询接口说明修改
3.酒店数据缓存查询接口说明修改
4.地标行政区域查询接口说明修改
范云满
2010.12.28
1.0.2
1.删除订单状态说明
2.增加酒店缓存策略说明
王贽
2011/2/18
增加访问地址说明,各指令示例。
杨同波
2011/2/21
修改地标查询输入中类别、城市编码的说明
王贽
2011/2/21
修改地标查询输入中类别的说明
王贽
2011/2/28
1.0.3
修改所有查询输入输出的
王贽
2011-3-3
1.1.0
酒店静态信息查询缓存:
增加返回标签
酒店数据缓存查询:
HotelCacheRS标签改为HotelAvailabilityCacheRS,RoomRates标签改为Rates,RoomRate标签改为Rate。
Rate标签中增加Payment、GuestType属性
新增酒店房型静态缓存查询
王贽
2011-3-8
1.1.1
酒店房型静态缓存查询增加返回
王贽
2011-3-9
1.1.2
酒店数据缓存查询增加返回
王贽
2011-3-16
1.1.3
酒店数据缓存查询返回:
Rate的子标签内容修改
王贽
2011-3-17
1.2.0
酒店数据缓存查询返回:
GuaranteePolicy的子标签内容修改;
增加新指令:
酒店价格计划控制缓存查询(TH_RATEPLANCONTROLCACHERQ/RS)
王贽
2011-3-23
1.2.1
TH_HotelStaticInfoCacheRQ/RS改名为多酒店静态信息查询;
TH_RoomTypeStaticInfoCacheRQ/RS改名为单酒店静态信息查询;
单酒店静态信息查询返回增加HotelVendors标签
王贽
2011-4-12
1.2.2
城市信息查询缓存(TH_CityDetailsSearchRQ/RS)输入项
酒店价格计划控制缓存查询(TH_RATEPLANCONTROLCACHERQ/RS)示例修正
王贽
2011-04-26
1.2.3
增加酒店价格计划佣金缓存查询(TH_RateplanCommCacheRQ/RS)
王贽
2011-05-03
1.2.4
单酒店静态信息查询TH_RoomTypeStaticInfoCacheRQ/RS返回增加
王贽
2011-05-09
1.2.5
酒店数据缓存查询TH_HotelAvailabilityCacheRQ/RS返回RoomQuotas标签更改为Quotas
RoomQuota标签更改为Quota
王贽
2011-5-25
1.2.6
单酒店静态信息查询TH_RoomTypeStaticInfoCacheRQ/RS返回增加
王贽
2011-7-21
1.2.7
酒店数据缓存查询TH_HotelAvailabilityCacheRQ/RS返回标签ServiceFee、FeePercent说明修改
王贽
2011-8-5
1.2.8
TH_RoomTypeStaticInfoCacheRS返回标签CardIssueName增加信用卡对应发卡银行列表
王贽
2011-9-6
1.3.0
根据业务要求,酒店价格计划佣金缓存查询(TH_RateplanCommCacheRQ/RS)暂停提供
王贽
2011-11-9
1.3.1
多酒店静态缓存返回TH_HotelStaticInfoCacheRS增加ShortDesc、BrandCode、ChainCode标签
王贽
2011-11-24
1.3.2
多酒店静态缓存返回TH_HotelStaticInfoCacheRS增加TotalNumber、PageNo标签;
多酒店静态缓存请求TH_HotelStaticInfoCacheRQ增加PageNo标签
王贽
2012-01-9
1.4.0
增加酒店缓存更新查询(TH_UPDATEHOTELSRQ/RS);
酒店数据缓存查询请求TH_HotelAvailabilityCacheRQ增加
价格计划控制缓存查询请求TH_RATEPLANCONTROLCACHERQ增加
酒店数据缓存查询返回TH_HotelAvailabilityCacheRS标签
价格计划控制缓存查询返回TH_RATEPLANCONTROLCACHERS增加标签
王贽
2012-3-1
1.4.1
TH_LandMarkSearchRQ中地标类别增加HOT:
热点地区
王贽
2012-3-22
1.5.0
增加TH_OfferHotelsRQ、TH_OfferRoomTypesRQ指令;
TH_UpdateHotelsRQ/RS指令请求、返回标签
“4.0酒店缓存查询策略”中增加新的说明,见标记为今天更细的部分内容;
3.8酒店缓存更新查询(TH_UpdateHotelsRQ/RS)增加如下说明:
“注意:
由于酒店更新信息涉及各个方面,缓存更新查询是以酒店为单位进行更新,可能更新查询会查到有变化的信息,但某些渠道在实际数据查询中未发现变化,这种情况属于正常”
王贽
2012-3-29
1.5.1
多酒店静态信息查询缓存(TH_HotelStaticInfoCacheRQ/RS)返回增加标签
王贽
目录
变更记录2
1概述5
2指令格式解析5
3通知型指令详析6
3.1城市信息查询缓存(TH_CityDetailsSearchRQ/RS)6
3.1.1请求指令:
6
3.1.2返回指令:
7
3.1.3示例XML8
3.2地标行政区查询缓存(TH_LandMarkSearchRQ/RS)9
3.2.1请求指令:
9
3.2.2返回指令:
10
3.2.3示例11
3.3多酒店静态信息查询缓存(TH_HotelStaticInfoCacheRQ/RS)12
3.3.1请求指令:
12
3.3.2返回指令:
13
3.3.3示例:
15
3.4酒店数据缓存查询(TH_HotelAvailabilityCacheRQ/RS)16
3.4.1请求指令:
16
.3.4.2返回指令:
17
3.4.3示例:
20
3.5单酒店静态信息查询(TH_RoomTypeStaticInfoCacheRQ/RS)21
3.5.1请求指令:
22
3.5.2返回指令:
22
3.5.3示例:
25
3.6酒店价格计划控制缓存查询(TH_RateplanControlCacheRQ/RS)26
3.6.1请求指令:
26
3.6.2返回指令:
27
3.6.3示例:
28
3.7(该指令因业务原因暂停)酒店价格计划佣金缓存查询(TH_RateplanCommCacheRQ/RS)29
3.7.1请求指令:
29
3.7.2返回指令:
30
3.7.3示例:
31
3.8酒店缓存更新查询(TH_UpdateHotelsRQ/RS)32
3.8.1请求指令:
32
3.8.2返回指令:
33
3.8.3示例:
35
3.9酒店上下线缓存更新查询(TH_OfferHotelsRQ/RS)35
3.9.1请求指令:
36
3.9.2返回指令:
37
3.9.3示例:
38
3.10房型上下线缓存更新查询(TH_OfferRoomTypesRQ/RS)38
3.10.1请求指令:
39
3.10.2返回指令:
39
3.10.3示例:
40
4.0酒店缓存查询策略41
5.0关于返回错误42
5.0.1业务级错误返回42
5.0.2系统级错误返回42
1概述
该文档描述了HotelBE数据缓存接口各个指令的含义、具体内容及应用情况。
本接口通过MQ服务提供,为UTF-8编码格式。
外部通过http请求的方式调用DirectLink服务,目前也遵循UTF-8编码,如有变更,请遵循DirectLink编码标准即可。
请求的指令为XML字符串,参数名为request。
DirectLink的访问地址:
生产地址:
测试地址:
http:
//202.106.139.49:
9090/directlink/send.do
2指令格式解析
每条指令都包括两部分:
请求和返回,都是XML格式,请求指令以
用户可以根据文档及示例程序对XML串进行解析,本文档将随系统升级而同步升级。
文档中,附有“★”标志的字段为不能为空字段。
未声明数据类型均为‘String’类型,未声明日期格式均为‘yyyy-MM-dd’,未声明时间格式均为‘HHMM(1800表示为下午六点,时分间没有冒号)’,结果为是或否的字段,取值均为是:
’Y’,否:
’N’,灰色区域以及未注释区域、字段均为保留扩展时使用。
指令中,IdentityInfo信息请务必填写完整,office信息务必填写,用户信息如无法确认具体操作人,可填写入office管理员信息。
3通知型指令详析
3.1城市信息查询缓存(TH_CityDetailsSearchRQ/RS)
用例:
城市信息查询指令
描述:
查询城市静态信息。
用于获取城市代码等信息列表。
该指令请求结构遵循TH_CityDetailsSearchRQ.xsd文件,返回结构遵循TH_CityDetailsSearchRS.xsd文件
3.1.1请求指令:
指令名称,String类型固定值“TH_CityDetailsSearchRQ”★
MM:
SSString类型
中国String类型;’ALL’查询所有国家;US:
美国★
HOTELBE)
3.1.2返回指令:
关于酒店图片:
请在返回的数据前添加服务器地址“,如请求返回了数据“/676/WJ/676WJ01.jpg”,此链接应为“
MM:
SS
HOTELBE)
3.1.3示例XML
3.2地标行政区查询缓存(TH_LandMarkSearchRQ/RS)
用例:
地标行政区查询指令
描述:
该指令用来查询地标行政区等信息。
该指令请求结构遵循TH_LandMarkSearchRQ.xsd文件,返回结构遵循TH_LandMarkSearchRS.xsd文件
3.2.1请求指令:
指令名称,String类型固定值“TH_LandMarkSearchRQ”★
MM:
SSString类型
POR:
地标信息,DST:
行政区信息;TRA:
交通信息;SGT:
周围景观;HOT:
热点地区。
String类型
HOTELBE)
3.2.2返回指令:
MM:
SS
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- HotelBE 数据 缓存 接口 文档 资料