中国航信酒店平台接口开发指南

1、文档来源为：从网络收集整理.word版本可编辑.欢迎下载支持 中国航信酒店平台接口开发指南 V1.0.0 TraveiSkv 中国民航信息网络股份有限公司 2010年1月 i 文档来源为：从网络收集整理.word版本可编辑.欢迎下载支持 变更记录 Date Versio n Descriptio n Author 2010/06 1.0.0 版本发布 杨同波 2011/01 1.0.1 更新参考文档 刘剑 2 文档来源为 :从网络收集整理 .word 版本可编辑 .欢迎下载支持 目录 变更记录 错误 !未定义书签。 1 概述 错误 ! 未定义书签。 2 开发步骤 错误 ! 未定义书签。 2.1

2、申请使用接口的帐号： 错误!未定义书签。 2.2 对酒店接口进行开发的步骤： 错误!未定义书签。 ,熟悉酒店的相关业务知识 错误 !未定义书签。 ，缓存酒店的信息 错误 !未定义书签。 2.2.3 接收 hotelce 的酒店消息通知 错误!未定义书签。 2.2.4 查询通知消息 错误 !未定义书签。 3 技术支持 错误 ! 未定义书签。 4 参考文档 错误 ! 未定义书签。 3 文档来源为：从网络收集整理.word版本可编辑.欢迎下载支持 1概述 HotelBE接口是中国航信TRAVELHU酒店分销平台的下游接口，分销商可以 通过此接口进行二次开发，将travelHUB平台上不同供应商的酒店

3、引入到分销商 呼叫中心系统、直客网站、差旅管理系统、后台管理系统当中，为分销商提供数 据下载及同步、酒店查询、预定等功能，是可以为分销商提供无缝数据支持的先 进技术接口。 该文档描述了中航信平台酒店接口开发步骤和方法，内容涉及平台相关的多 个系统，具体的指令格式，请参见HotelBE和HotelCE开发文档。平台接口后台 应用通过MQ服务提供，UTF-8编码格式。客户通过DirectLink统一访问地址，可 以访问平台酒店的多个应用接口。 每条指令都包括两部分：请求和返回，都有统 一的XML格式，请求指令以vOTRequest为根节点，返回指令以vOTResponse为 根节点。指令的具体格式

4、请参照不同应用的相关接口文档。 外网测试服务地址：.49:9090/directli nk/tbeC on troller.do 生产服务地址：/sen d.do 提交指令均以httpPost请求的方式，参数名为request，即将请求XML串 放到request参数中。UTF-8编码格式。 每个应用的接口指令通过其中的applicati on 元素区分该指令所要访问的平 台应用，每条指令的即plication 必须填写正确，否则请求的指令不能被相应的 应用所处理，application 区分大小写。本文涉及两个应用： hotelbe :提供给平台渠道查询预定酒店 hotelce :提供给酒店

5、发送相关信息给平台，同时平台会将酒店相关信息发 给特定的渠道 2开发步骤 您可以通过以下步骤使用中航信的酒店平台接口： 2.1申请使用接口的帐号: 您需要向丹迪分支申请使用接口，获得申请接口的认证信息。 (1) 申请成为TravelHub平台渠道 航旅通的Office已经默认作为平台的渠道。渠道 code等同于officeCode (2) 申请接口认证信息 申请认证信息需要说明： 开通测试还是生产系统 申请流程: 航信各分支机构处填写 ，分支机构业 务负责人签字后发送传真至010 ,。总部收到传真领导签字审核通过后三个工 作日内开通接口，并将接口认证信息发送到申请单中的负责人邮箱。 (3) 认

6、证信息的格式 接口的认证信息放在指令的videntitylnfo 元素中.如下： videntityInfo R 理 Office 号 g户名 vPassword：用户密码 ft 色 v/lde ntity Info 该认证信息要放在接口指令中，directLi nk会对每一条请求指令进行权限验证。 2.2对酒店接口进行开发的步骤： ,熟悉酒店的相关业务知识 接口技术文档中着重讲了指令的格式和调用方式，技术实现上相对简单。开 发接口前了解指令中每个元素的含义，熟悉酒店预订相关的业务知识是非常必要 的。参考文档:vvHotelBE接口文档 ，缓存酒店的信息 由于酒店的信息量大，不仅包括酒店的静态

7、信息，例如名称、地址、描述、 电话、邮编、传真、行政区域、地标、房型描述等，而且包含动态信息，例如房 型价格、配额、担保政策、预订政策等。因此接口客户必须对酒店的信息进行本 地缓存，以提高客人的查询的速度和效率。 客户需在熟悉业务的基础上，结合接 口文档设计本地的表结构，缓存酒店的所有信息。 本地化缓存后，客户可以自己本地设置酒店的促销级别，灵活地展现客人查 询后酒店的展示顺序和必要的信息。利用 hotelbe的多酒店查询、单酒店查询指 令，客户可以把查到的酒店信息缓存在本地数据库中。 建立酒店缓存时，请参考文档中国航信 HotelBE数据缓存接口描述。 2.2.3接收hotelce的酒店消息

8、通知 本地话缓存数据后，客人在客户网站的酒店查询操作都是查询本地的数据 库。当酒店的信息发生变化时，酒店会发消息给平台，平台会给特定的渠道发送 消息通知。客户在收到消息通知后，解析收到的XML,并对本地的数据进行更新。 我们这里发送的形式是：渠道提供的消息接收地址？messageXML=（消息 XML串） &msglD=（消息 ID） 例如： 房型可用性通知：酒店可能会对关闭某些房型，或者上线销售新的房型。 房价通知：酒店可能调整房型的价格。 政策通知：酒店可能调整预订或者担保等政策。 消息通知的类型和具体格式含义，请参照 HotelCE相关文档。 2.2.4查询通知消息 某些情况下，可能导致

9、客户没有收到必要的信息，而导致本地数据没有及时更新， 例如： 客户的消息处理服务中断不可用 网络原因导致消息丢失或者不可到达 因此，客户可以调用指令查询某个时间段或符合一定条件的消息， 由于消息 的数量较大，我们可能对查询的条件进行限制，以减小对系统的压力，提高传输 效率。 代理可发送消息查询指令查询某个时间段的所有通知消息，这样可以避免有 些消息没有收到导致的数据同步不一致的问题。 代理通过发送httpPost请求，把查询的指令放到名为 request的参数中。调 用方法等同于调用HBE主动查询指令的方法。 生产请求地址格式：/se nd.do?request =. ?request=. 测

10、试请求地址：.49:9090/directli nk/tbeCo ntroller.do 通过该指令查询一段时间内的通知消息的ID 示例： QueryNotifyMsglDRQ 固定值，必填 notify，固定值，必填 v/Application/Header 接口认证信息 office 号 userid password v/Ide ntity lnfo vQueryNotifyMsgIDRQI nfo Begi nTime起始时间， YYYYMMDDTTMM 例如 0800 E ndTime终止时间， YYYYMMDDTTMM 例如 2459 ?肖息名称 v/QueryNotifyMsgI

11、DRQI nfo v/OTRequest 返回消息格式： vOTResp on se QueryNotifyMsglDRS 20000 success 消息ID,可重复元素 vApplicati onno tifyv/Applicati on 为必填项 QueryNotifyMsgIDRS/Tra nsactio nN am为 必填项 查询限制：起始时间必须是同一天。 通过该指令查询一段时间内的通知消息 示例： QueryNotifyMsgRQ no tifyv/Applicati on/Header 接口认证信息 office 号 userid password v/Ide ntity ln

12、fo vQueryNotifyMsgRQI nfo 消息 ID 起始时间，格式 YYYYMMDDTTMM 终止时间，格式 YYYYMMDDTTMM vMsgNameT肖息名称 MessageType 消息类型 v/QueryNotifyMsgRQI nfo v/OTRequest vApplicati onno tifyv/Applicati on 为必填项 若MsgId不为空，则按照消息ID查询消息，其他查询条件无效 MSGI是消息的ID，是唯一区分消息的标识。 Hotelce的消息ID:日期（8位，YYYYMMDD服务编号（6位数字）_CEJ数 字序号（6位数字）。例如_202124_CE

13、_00869（表示2010年7月30日服务 号为202124的通知服务生成的第8690条hotelce消息。同一天可能有 多个服务号，一般为2个服务，同一个服务每天发送的消息数字序号从 000001开始递增排列。 时间跨度为10分钟，即查询时间段为10分钟。查询时间的分钟位只能是10 的倍数，例如查询2010年月30日11点10分到2010年月30日11点20分 的消息。Beg in Time 为 1110, En dTime 为 1120 MsgName要查询的通知消息类别名称，可取值及表示含义如下： ? TransactionName为指令名称，例如 SP_HotelOrderStatus

14、NotifRQ 当 取值为OldICSMessage寸查询老HBE的房价类通知消息 ? MessageType消息类型该元素查询老 HBE的通 知消息时用到；查询hotelce通知消息时取值为空。 返回消息格式： vOTResp on se QueryNotifyMsgRS 20000 vDescripti on successv/Descripti on 消息 ID 消息时间 |息名称，例如 OldlCSMessage vMsgContentffi息内容 v/MsgContentx/Msglnfo v/Msgl nfos v/OTResp on se 返回示例： QueryNotifyMsg

15、RS vCodeZOOOOv/CodexDescripti on successv/Descripti on 135527_ notify_ 135527 OldlCSMessage vMsgCo nte nt vHotelAvailNotifyRQxHotelAvailMessagevPropertylD1EAJQv/PropertylDvRo omTypeCodeDB003v/Begi nDatev/E ndD atevAvailability-3v/AvailabilityvRemarkv/RemarkHAv/Message Typev/HotelAvailMessagev/HotelA

16、vailNotifyRQv/MsgCo nten t 135528_notify_5581345 135528 OldlCSMessage vMsgCo nte nt vPropertylD1EAJQv/PropertylDvRo omTypeCodeDB003v/Begi nDatev/E ndD ate-3v/AvailabilityvRemarkv/RemarkHAv/Message Type v/MsgCo ntent v/Msgl nfo vMsgl nfo vMsgld135530_ notify_v/Msgld 135530 OldlCSMessage vMsgCo nte nt

17、 1EAJQv/PropertylDxRo omTypeCodeDB001-3v/AvailabilityvRemarkv/RemarkvMessageTypeHAv/Message Typex/HotelAvailMessagex/HotelAvailNotifyRQx/MsgCo ntent 相关的业务问题请致电航旅通客服电话 400-810-9191。 hotelbe接口技术支持以电子邮件为主，电话只处理紧急问题，比如下单全 部失败，接口无法访问等紧急严重问题， 其他问题请转邮件咨询。我们承诺邮件 技术支持三个工作日内给回复。咨询邮件请参照下述的格式，以提高问题解决的 效率。邮件发送至；

18、 邮件技术咨询问题描述参照以下格式： 1：使用hotelbe接口的用户认证信息 2：问题描述（文字性说明） 3:出现问题的接口访问地址，请求XML串和返回XML串 一个技术咨询邮件示例： 1:使用接口的用户认证信息： NATEST NATEST 00C 123 v/lde ntity lnfo 2:问题描述：调用单酒店查询接口查不到酒店信息 3:出现问题的请求XML串和返回XML串： 访问地址：/send.do 请求串： vSessio nIDx/Sessio nlD vApplicatio nhotelbe vHotelRef HotelCode=SOHOTO0014/ vRatePla nCan didates vRatePla nCan didate Checkl nDate=2010-07-13 vVe ndor Ve ndorCode=SOHOTO/ v/Ve ndors In cluded v/RatePla nCan didate v/RatePla nCan didates vStayDateRa nge CheckOutDate=2O1O-O7-18/ v/HotelAvailCriteria