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

中国航信酒店平台接口开发指南 V1.0.0 中国民航信息网络股份有限公司 2010年1月  变更记录 Date Version Description Author 2010/06 1.0.0 版本发布 杨同波 2011/01 1.0.1 更新参考文档 刘剑  目录 变更记录 2 1概述 4 2开发步骤 4 2.1申请使用接口的帐号： 4 2.2对酒店接口进行开发的步骤： 5 2.2.1阅读hotelbe接口文档,熟悉酒店的相关业务知识 5 2.2.2设计本地表结构，缓存酒店的信息 5 2.2.3 接收hotelce的酒店消息通知 6 2.2.4 查询通知消息 6 3技术支持 11 4 参考文档 13  1概述 HotelBE接口是中国航信TRAVELHUB酒店分销平台的下游接口，分销商可以通过此接口进行二次开发，将travelHUB平台上不同供应商的酒店引入到分销商呼叫中心系统、直客网站、差旅管理系统、后台管理系统当中，为分销商提供数据下载及同步、酒店查询、预定等功能，是可以为分销商提供无缝数据支持的先进技术接口。 该文档描述了中航信平台酒店接口开发步骤和方法,内容涉及平台相关的多个系统，具体的指令格式，请参见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区分大小写。本文涉及两个应用： hotelbe：提供给平台渠道查询预定酒店 hotelce：提供给酒店发送相关信息给平台，同时平台会将酒店相关信息发给特定的渠道 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接口文档 2.2.2设计本地表结构，缓存酒店的信息 由于酒店的信息量大，不仅包括酒店的静态信息，例如名称、地址、描述、电话、邮编、传真、行政区域、地标、房型描述等，而且包含动态信息，例如房型价格、配额、担保政策、预订政策等。因此接口客户必须对酒店的信息进行本地缓存，以提高客人的查询的速度和效率。客户需在熟悉业务的基础上，结合接口文档设计本地的表结构，缓存酒店的所有信息。 本地化缓存后，客户可以自己本地设置酒店的促销级别，灵活地展现客人查询后酒店的展示顺序和必要的信息。利用hotelbe的多酒店查询、单酒店查询指令，客户可以把查到的酒店信息缓存在本地数据库中。 建立酒店缓存时，请参考文档《中国航信HotelB