中國航信酒店平臺接口開發(fā)指南

百度文庫 -讓每個人平等地提升自我中國航信酒店平臺接口開發(fā)指南中國民航信息網絡股份有限公司2010年1月1百度文庫 -讓每個人平等地提升自我變更記錄DateVersionDescriptionAuthor2010/061.0.0版本發(fā)布楊同波2011/01更新參考文檔劉劍2百度文庫 -讓每個人平等地提升自我目錄變更記錄 21概述 42開發(fā)步驟 4申請使用接口的帳號： 5對酒店接口進行開發(fā)的步驟： 5閱讀hotelbe接口文檔,熟悉酒店的相關業(yè)務知識 5設計本地表結構，緩存酒店的信息 6接收hotelce的酒店消息通知 6查詢通知消息 63技術支持 114參考文檔 133百度文庫 -讓每個人平等地提升自我概述HotelBE接口是中國航信 TRAVELHUB酒店分銷平臺的下游接口，分銷商可以通過此接口進行二次開發(fā)，將travelHUB平臺上不同供應商的酒店引入到分銷商呼叫中心系統(tǒng)、直客網站、差旅管理系統(tǒng)、后臺管理系統(tǒng)當中，為分銷商提供數(shù)據(jù)下載及同步、酒店查詢、預定等功能，是可以為分銷商提供無縫數(shù)據(jù)支持的先進技術接口。該文檔描述了中航信平臺酒店接口開發(fā)步驟和方法,內容涉及平臺相關的多個系統(tǒng)，具體的指令格式，請參見HotelBE和HotelCE開發(fā)文檔。平臺接口后臺應用通過MQ服務提供，UTF-8編碼格式。客戶通過DirectLink統(tǒng)一訪問地址，可以訪問平臺酒店的多個應用接口。每條指令都包括兩部分：請求和返回，都有統(tǒng)一的XML格式，請求指令以<OTRequest>為根節(jié)點，返回指令以<OTResponse>為根節(jié)點。指令的具體格式請參照不同應用的相關接口文檔。外網測試服務地址：生產服務地址：提交指令均以httpPost請求的方式，參數(shù)名為request，即將請求XML串放到request參數(shù)中。UTF-8編碼格式。每個應用的接口指令通過其中的 application 元素區(qū)分該指令所要訪問的平臺應用，每條指令的application 必須填寫正確，否則請求的指令不能被相應的應用所處理，application 區(qū)分大小寫。本文涉及兩個應用：hotelbe：提供給平臺渠道查詢預定酒店hotelce：提供給酒店發(fā)送相關信息給平臺，同時平臺會將酒店相關信息發(fā)給特定的渠道開發(fā)步驟您可以通過以下步驟使用中航信的酒店平臺接口：4百度文庫 -讓每個人平等地提升自我申請使用接口的帳號：您需要向丹迪分支申請使用接口，獲得申請接口的認證信息。1）申請成為TravelHub平臺渠道航旅通的Office已經默認作為平臺的渠道。渠道 code等同于officeCode2）申請接口認證信息申請認證信息需要說明：開通測試還是生產系統(tǒng)申請流程：航信各分支機構處填寫<<酒店預訂技術接口(hotelbe)申請單>>，分支機構業(yè)務負責人簽字后發(fā)送傳真至010，并發(fā)申請單電子版至?？偛渴盏絺髡骖I導簽字審核通過后三個工作日內開通接口，并將接口認證信息發(fā)送到申請單中的負責人郵箱。（3）認證信息的格式接口的認證信息放在指令的 <IdentityInfo>元素中.如下：<IdentityInfo><OfficeID>代理Office號</OfficeID><UserID>用戶名</UserID><Password>用戶密碼</Password><Role>角色</Role></IdentityInfo>該認證信息要放在接口指令中， directLink會對每一條請求指令進行權限驗證。對酒店接口進行開發(fā)的步驟：閱讀hotelbe接口文檔,熟悉酒店的相關業(yè)務知識接口技術文檔中著重講了指令的格式和調用方式，技術實現(xiàn)上相對簡單。開發(fā)接口前了解指令中每個元素的含義， 熟悉酒店預訂相關的業(yè)務知識是非常必要5百度文庫 -讓每個人平等地提升自我的。參考文檔:<<HotelBE接口文檔>>設計本地表結構，緩存酒店的信息由于酒店的信息量大，不僅包括酒店的靜態(tài)信息，例如名稱、地址、描述、電話、郵編、傳真、行政區(qū)域、地標、房型描述等，而且包含動態(tài)信息，例如房型價格、配額、擔保政策、預訂政策等。因此接口客戶必須對酒店的信息進行本地緩存，以提高客人的查詢的速度和效率。 客戶需在熟悉業(yè)務的基礎上， 結合接口文檔設計本地的表結構，緩存酒店的所有信息。本地化緩存后，客戶可以自己本地設置酒店的促銷級別，靈活地展現(xiàn)客人查詢后酒店的展示順序和必要的信息。利用 hotelbe的多酒店查詢、單酒店查詢指令，客戶可以把查到的酒店信息緩存在本地數(shù)據(jù)庫中。建立酒店緩存時，請參考文檔《中國航信 HotelBE數(shù)據(jù)緩存接口描述》。接收hotelce的酒店消息通知本地話緩存數(shù)據(jù)后，客人在客戶網站的酒店查詢操作都是查詢本地的數(shù)據(jù)庫。當酒店的信息發(fā)生變化時，酒店會發(fā)消息給平臺，平臺會給特定的渠道發(fā)送消息通知?？蛻粼谑盏较⑼ㄖ?，解析收到的XML，并對本地的數(shù)據(jù)進行更新。我們這里發(fā)送的形式是：渠道提供的消息接收地址?messageXML=（消息XML串）&msgID=（消息ID）例如：房型可用性通知：酒店可能會對關閉某些房型，或者上線銷售新的房型。房價通知：酒店可能調整房型的價格。政策通知：酒店可能調整預訂或者擔保等政策。消息通知的類型和具體格式含義，請參照 HotelCE相關文檔。查詢通知消息某些情況下，可能導致客戶沒有收到必要的信息，而導致本地數(shù)據(jù)沒有及時更新，例如：6百度文庫 -讓每個人平等地提升自我客戶的消息處理服務中斷不可用網絡原因導致消息丟失或者不可到達因此，客戶可以調用指令查詢某個時間段或符合一定條件的消息，由于消息的數(shù)量較大，我們可能對查詢的條件進行限制，以減小對系統(tǒng)的壓力，提高傳輸效率。代理可發(fā)送消息查詢指令查詢某個時間段的所有通知消息， 這樣可以避免有些消息沒有收到導致的數(shù)據(jù)同步不一致的問題。代理通過發(fā)送 httpPost請求，把查詢的指令放到名為 request的參數(shù)中。調用方法等同于調用 HBE主動查詢指令的方法。生產請求地址格式：測試請求地址：通知消息 ID查詢指令通過該指令查詢一段時間內的通知消息的 ID示例：<OTRequest><TransactionName>QueryNotifyMsgIDRQ，固定值，必填</TransactionName><Header><Application>notify，固定值，必填</Application></Header><IdentityInfo>接口認證信息<OfficeID>office號</OfficeID><UserID>userid</UserID><Password>password</Password></IdentityInfo><QueryNotifyMsgIDRQInfo><BeginTime>起始時間，YYYYMMDDTTMM，例如0800</BeginTime><EndTime>終止時間，YYYYMMDDTTMM，例如2459</EndTime><MsgName>消息名稱</MsgName>MessageType></MessageType></QueryNotifyMsgIDRQInfo>7百度文庫 -讓每個人平等地提升自我</OTRequest>返回消息格式：<OTResponse><TransactionName>QueryNotifyMsgIDRS</TransactionName><Header/><IdentityInfo/><Code>20000</Code><Description>success</Description><MsgInfosNumber="消息總數(shù)"><MsgId>消息ID,可重復元素</MsgId></MsgIDInfos></OTResponse><Application>notify</Application>為必填項<TransactionName>QueryNotifyMsgIDRS</TransactionName>為必填項查詢限制：起始時間必須是同一天。通知消息查詢指令通過該指令查詢一段時間內的通知消息示例：<OTRequest><TransactionName>QueryNotifyMsgRQ</TransactionName><Header><Application>notify</Application></Header><IdentityInfo>接口認證信息<OfficeID>office號</OfficeID><UserID>userid</UserID><Password>password</Password></IdentityInfo><QueryNotifyMsgRQInfo><MsgId>消息ID</MsgId><BeginTime>起始時間，格式 YYYYMMDDTTMM</BeginTime><EndTime>終止時間，格式 YYYYMMDDTTMM</EndTime>8百度文庫 -讓每個人平等地提升自我<MsgName>消息名稱</MsgName><MessageType>消息類型</MessageType></QueryNotifyMsgRQInfo></OTRequest><Application>notify</Application>為必填項若MsgId不為空,則按照消息ID查詢消息，其他查詢條件無效MSGID是消息的ID，是唯一區(qū)分消息的標識。Hotelce的消息ID:日期(8位，YYYYMMDD)服_務編號(6位數(shù)字)_CE_數(shù)字序號(6位數(shù)字)。例如_202124_CE_008690表示2010年7月30日服務號為202124的通知服務生成的第8690條hotelce消息。同一天可能有多個服務號，一般為2個服務，同一個服務每天發(fā)送的消息數(shù)字序號從000001開始遞增排列。時間跨度為10分鐘，即查詢時間段為10分鐘。查詢時間的分鐘位只能是10的倍數(shù)，例如查詢2010年月30日11點10分到2010年月30日11點20分的消息。BeginTime為1110，EndTime為1120MsgName要查詢的通知消息類別名稱，可取值及表示含義如下：TransactionName為指令名稱，例如SP_HotelOrderStatusNotifRQ；當取值為OldICSMessage時查詢老HBE的房價類通知消息<MessageType>消息類型</MessageType>，該元素查詢老HBE的通知消息時用到；查詢hotelce通知消息時取值為空。返回消息格式：<OTResponse><TransactionName>QueryNotifyMsgRS</TransactionName><Header/><IdentityInfo/><Code>20000</Code><Description>success</Description><MsgInfosNumber="消息總數(shù)"><MsgInfo><MsgId>消息ID</MsgId><Time>消息時間</Time><MsgTsName>消息名稱，例如 OldICSMessage</MsgTsName>9百度文庫 -讓每個人平等地提升自我<MsgContent>消息內容</MsgContent></MsgInfo></MsgInfos></OTResponse>返回示例：<OTResponse><TransactionName>QueryNotifyMsgRS</TransactionName><Header/><IdentityInfo/><Code>20000</Code><Description>success</Description><MsgInfosNumber="3"><MsgInfo><MsgId>20_notify_</MsgId><Time>20</Time><MsgTsName>OldICSMessage</MsgTsName><MsgContent><HotelAvailNotifyRQ><HotelAvailMessage><PropertyID>1EAJQ</PropertyID><RoomTypeCode>DB003</RoomTypeCode><BeginDate></BeginDate><EndDate></EndDate><Availability>-3</Availability><Remark></Remark><MessageType>HA</MessageType></HotelAvailMessage></HotelAvailNotifyRQ></MsgContent></MsgInfo><MsgInfo><MsgId>20_notify_5581345</MsgId><Time>20</Time><MsgTsName>OldICSMessage</MsgTsName><MsgContent><HotelAvailNotifyRQ><HotelAvailMessage><PropertyID>1EAJQ</PropertyID><RoomTypeCode>DB003</RoomTypeCode><BeginDate></BeginDate><EndDate></EndDate><Availability>-3</Availability><Remark></Remark><MessageType>HA</MessageType></HotelAvailMessage></HotelAvailNotifyRQ></MsgContent></MsgInfo><MsgInfo><MsgId>20_notify_</MsgId>10百度文庫 -讓每個人平等地提升自我<Time>20</Time><MsgTsName>OldICSMessage</MsgTsName><MsgContent><HotelAvailNotifyRQ><HotelAvailMessage><PropertyID>1EAJQ</PropertyID><RoomTypeCode>DB001</RoomTypeCode><BeginDate></BeginDate><EndDate></EndDate><Availability>-3</Availability><Remark></Remark><MessageType>HA</MessageType></HotelAvailMessage></HotelAvailNotifyRQ></MsgContent></MsgInfo></MsgInfos></OTResponse>技術支持相關的業(yè)務問題請致電航旅通客服電話 400-810-9191。hotelbe接口技術支持以電子郵件為主，電話只處理緊急問題，比如下單全部失敗，接口無法訪問等緊急嚴重問題， 其他問題請轉郵件咨詢。我們承諾郵件技術支持三個工作日內給回復。 咨詢郵件請參照下述的格式，以提高問題解決的效率。郵件發(fā)送至 ;郵件技術咨詢問題描述參照以下格式：１：使用hotelbe接口的用戶認證信息２：問題描述（文字性說明）３：出現(xiàn)問題的接口訪問地址，請求ＸＭＬ串和返回ＸＭＬ串一個技術咨詢郵件示例：１：使用接口的用戶認證信息：<IdentityInfo><OfficeID>NATEST</OfficeID><UserID>NATEST00C</UserID><Password>123</Password>11百度文庫 -讓每個人平等地提升自我</IdentityInfo>問題描述：調用單酒店查詢接口查不到酒店信息3：出現(xiàn)問題的請求ＸＭＬ串和返回ＸＭＬ串：訪問地址:請求串：<OTRequest><Header><SessionID></SessionID><Invoker></Invoker><Encoding></Encoding><Locale></Locale><SerialNo></SerialNo><TimeStamp></TimeStamp><Application>hotelbe</Application></Header><HotelAvailRQ><HotelAvailCriteria><HotelSearchCriteria><HotelRef