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

中国航信酒店平台接口开发指南 V1. 中国民航信息网络股份有限公司 2010年6月  变更记录 Date Version Description Author 2010/06 1.0.0 版本发布 杨同波 2010/06 1.0.1 概述中增加了业务建议；hotelBE接口参考文档扩展 房健 2011/04 1.0.2 增加了对缓存接口的补充描述 房健  目录 TOC \o 1-3 \h \z \u 变更记录 2 1概述 4 2开发步骤 5 2.1申请使用接口的帐号： 5 2.2对酒店接口进行开发的步骤： 6 2.2.1阅读hotelbe接口文档,熟悉酒店的相关业务知识 6 2.2.2设计本地表结构，缓存酒店的信息 6 2.2.3 接收hotelce的酒店消息通知 6 2.2.4 查询通知消息 7 3技术支持 11 4 参考文档 14  1概述 对于需根据自己业务规则调整数据的渠道，需采用缓存数据+动态查询预订的机制。首先，静态信息（如城市列表、酒店名称、ID等内容）和动态信息（如价格、房态等信息）通过缓存数据接口定期获得（如每周定时获取一次，更新到渠道本地数据库中）；其次，查询实时价格和预订等通过HotelBE接口完成；最后，异步的变价等通知信息需渠道建立通知监听服务接收HotelCE通知消息。 本文档描述了中航信平台酒店接口开发指南,内容涉及平台相关的多个系统。平台接口后台应用通过MQ服务提供，UTF-8编码格式。客户通过DirectLink统一访问地址，可以访问平台酒店的多个应用接口。每条指令都包括两部分：请求和返回，都有统一的XML格式，请求指令以OTRequest为根节点，返回指令以OTResponse为根节点。指令的具体格式请参照不同应用的相关接口文档。 外网测试服务地址：9:9090/directlink/tbeController.do 生产服务地址：/directlink/send.do 提交指令均以httpPost请求的方式，参数名为request，即将请求XML串放到request参数中。UTF-8编码格式。 每个应用的接口指令通过其中的application元素区分该指令所要访问的平台应用，每条指令的application必须填写正确，否则请求的指令不能被相应的应用所处理，application区分大小写。本文涉及三个应用： hotelcache:缓存接口，提供给平台渠道缓存酒店数据。 hotelbe：交易接口，提供给平台渠道查询预订酒店。 hotelce：通知接口，提供给酒店发送相关信息给平台，同时平台会将酒店相关信息发给特定的渠道。 另外，需要注意的是，由于业务可能会有扩展，在新接口的基础上会增加个别字段，而一些第三方插件在从xml到对象转换时，对新增加字段的解析有可能会出现问题，所以在开发时，对请求的返回结果的解析最好采用逐级逐节点的解析，尽量不要采用第三方插件把xml转换成对象，否则由此产生的问题，需要渠道端再次修改才能适用！ 2开发步骤 您可以通过以下步骤使用中航信的酒店平台接口： 2.1申请使用接口的帐号： 您需要向分支申请使用接口，获得申请接口的认证信息。 申请成为TravelHub平台渠道 航旅通的Office已经默认作为平台的渠道。渠道code等同于officeCode （2）申请接口认证信息 申请认证信息需要说明： 开通测试还是生产系统 申请流程： 航信各分支机构处填写酒店预订技术接口(hotelbe)申请单，分支机构业务负责人签字后发送传真至010并发申请单电子版至chenxing@ 。总部收到传真领导签字审核通过后三个工作日内开通接口，并将接口认证信息发送到申请单中的负责人邮箱。 （3）认证信息的格式 接口的认证信息放在指令的IdentityInfo 元素中.如下： IdentityInfo OfficeID代理Office号/OfficeID UserID用户名/UserID Password用户密码/Password Role角色/Role /IdentityInfo 该认证信息要放在接口指令中，directLink会对每一条请求指令进行权限验证。 2.2对酒店接口进行开发的步骤： 2.2.1阅读hotelbe、数据缓存等接口文档,熟悉酒店的相关业务知识 HotelBE是TravelHub平台面向下游渠道的实时交易接口，主要供渠道通过单酒店查询、预订等指令和平台就具体酒店动态数据、订单等信息进行交互。 HotelBE接口技术文档中着重讲了指令的格式和调用方式，技术实现上相对简单。开发接口前了解指令中每个元素的含义，熟悉酒店预订相关的业务知识是非常必