藝龍酒店API接口文檔

1、藝龍網(wǎng)信息技術(shù)（北京）有限公司藝龍酒店api接口文檔文檔歷史：文檔整理文檔版本日 期說明李繼東1.1.02010-11-10在elong hotel組提供的文檔基礎(chǔ)上進(jìn)行了重新整理李繼東1.1.12011-1-081、增加了即時(shí)確認(rèn)信息接口（第五部分第3個(gè)的instantconfirm接口）2、酒店靜態(tài)文件中增加的酒店特殊信息提示（靜態(tài)文件hotel_cn.xml中的availpolicy字段）3、啟用了新的api測試環(huán)境地址4、酒店的部分含早產(chǎn)品在api接口中的展示（gethotellist接口和gethotelorderlist接口）李繼東1.1.22011-2-1修改了bookingru

2、le返回值說明李繼東1.1.32011-2-281、優(yōu)化靜態(tài)數(shù)據(jù)文件更新方式，提供新版的靜態(tài)文件更新方式（見第三部分靜態(tài)文件更新）2、增加了多訂單號(hào)查詢接口（見第五部分第6接口）趙春風(fēng)1.1.42011-03-071. 完善開發(fā)流程說明2. 修訂預(yù)訂規(guī)則，擔(dān)保規(guī)則，附加服務(wù)，促銷規(guī)則等規(guī)則描述一、概述3二、基本開發(fā)步驟3三、靜態(tài)數(shù)據(jù)31、通過hotelid調(diào)用酒店信息文件更新方式42、打包下載更新方式43、靜態(tài)文件字段說明5四、代理商登錄接口login11五、api動(dòng)態(tài)接口121. 酒店價(jià)格查詢接-gethotellist132. 提交訂單接口 submithotelorder243. 獲取訂

3、單及時(shí)確認(rèn)信息接口instantconfirm304訂單查詢接口 gethotelorderlist325. 根據(jù)orderid獲取訂單gethotelorderdetailbyorderid366、根據(jù)訂單號(hào)id獲得多個(gè)訂單信息447. 訂單取消接口 cancelhotelorderbyid49六、接口返回的錯(cuò)誤信息50七、api測試工具介紹51一、概述 api接口是藝龍?zhí)峁┙o合作方使用的酒店數(shù)據(jù)倉庫，接口提供兩部分?jǐn)?shù)據(jù)，一部分是api接口靜態(tài)數(shù)據(jù)，此數(shù)據(jù)主要包含酒店的基礎(chǔ)信息等內(nèi)容；另外一部分為動(dòng)態(tài)數(shù)據(jù)，主要包括藝龍酒店價(jià)格的實(shí)時(shí)查詢、訂單實(shí)時(shí)提交、酒店訂單查詢、訂單詳細(xì)信息查詢、訂單取消

4、功能。 注意：由于訂單變更涉及到太多組合條件，api接口暫時(shí)不提供訂單變更功能；如需要進(jìn)行酒店訂單變更，可以先取消原來訂單，然后再重新下取新單。 在使用藝龍api接口進(jìn)行接入前，建議先在本地建立酒店信息、地理位置信息等數(shù)據(jù)庫，把酒店靜態(tài)數(shù)據(jù)、地理位置靜態(tài)數(shù)據(jù)通過程序解析到本地?cái)?shù)據(jù)庫，然后通過各個(gè)酒店的cityid、hotelid（酒店id）、cityid等查詢條件來查看酒店的實(shí)時(shí)價(jià)格做訂單處理操作。 開發(fā)時(shí)需要注意如果某些節(jié)點(diǎn)沒有數(shù)據(jù)，生成請(qǐng)求xml時(shí)該節(jié)點(diǎn)也需要包含，不能省略，否則接口會(huì)返回錯(cuò)誤二、基本開發(fā)步驟1、 向藝龍銷售人員索取api測試環(huán)境賬號(hào)和說明文檔，做接口接入工作前的準(zhǔn)備，同時(shí)

5、提供上線后預(yù)期的搜索量和成單量，并發(fā)數(shù)等相關(guān)性能指標(biāo)， 藝龍會(huì)根據(jù)實(shí)際情況進(jìn)行上線前的系統(tǒng)準(zhǔn)備，準(zhǔn)備時(shí)間一般在2周左右2、 下載api接口文檔靜態(tài)數(shù)據(jù)（最好采用flashget、迅雷等下載工具下載），通過程序來解析數(shù)據(jù)格式，并把解析到的數(shù)據(jù)導(dǎo)入到本地（或服務(wù)器）上的數(shù)據(jù)庫中3、 確定開發(fā)語言及需要調(diào)用的動(dòng)態(tài)接口，并閱讀動(dòng)態(tài)接口文檔參數(shù)，對(duì)通過動(dòng)態(tài)接口調(diào)用到的數(shù)據(jù)規(guī)劃自己頁面的展示方式4、 通過藝龍api測試環(huán)境調(diào)試接口（僅使用部分接口就調(diào)試部分動(dòng)態(tài)接口），對(duì)所需要的接口爭取均能調(diào)試通過，需要重點(diǎn)測試各種場景下的擔(dān)保訂單(首晚/全額，日期擔(dān)保/房量擔(dān)保)， 不同預(yù)訂規(guī)則下的預(yù)訂場景，否則上線后可

6、能會(huì)產(chǎn)生問題，需要配合藝龍方進(jìn)行不同的場景測試，直至得到藝龍銷售人員驗(yàn)收通過5、 測試環(huán)境驗(yàn)證通過后，向藝龍銷售人員申請(qǐng)開通api正式環(huán)境賬號(hào)， 藝龍銷售人員確認(rèn)系統(tǒng)功能測試完畢，藝龍系統(tǒng)接入準(zhǔn)備完畢， 排定雙方的上線日期后開通生產(chǎn)環(huán)境帳戶6、 更改代碼中api正式環(huán)境http地址以及api賬號(hào)，把已開發(fā)好的系統(tǒng)切入到正式環(huán)境，在正式環(huán)境下一兩個(gè)訂單做簡單測試（測試訂單時(shí)請(qǐng)聯(lián)系相關(guān)銷售人員，測試場景需涵蓋主要擔(dān)保規(guī)則和預(yù)訂規(guī)則，訂單入住日期要在測試日期推后較長時(shí)間，以保證可以取消和不產(chǎn)生擔(dān)?？劭睿瑴y試完的訂單要及時(shí)進(jìn)行取消, 否則產(chǎn)生的賠款由代理商自己負(fù)責(zé)）7、 測試正常后，把自己網(wǎng)站或系統(tǒng)接

7、入正式api接口上線監(jiān)控2-3周，發(fā)現(xiàn)問題請(qǐng)及時(shí)和對(duì)口銷售或藝龍技術(shù)支持人員反饋三、靜態(tài)數(shù)據(jù)目前，靜態(tài)數(shù)據(jù)文件的初始化更新支持兩種方式，一種為通過hotelid調(diào)用酒店信息文件更新方式，一種為打包下載更新方式（此種方式將逐步放棄不用） 1、通過hotelid調(diào)用酒店信息文件更新方式（1）、api靜態(tài)數(shù)據(jù)文件包含以下： hotellist.xml 提供了藝龍所有酒店的hotelid、酒店中英文名稱、上線時(shí)間、到期時(shí)間等信息，具體字段定義見“靜態(tài)文件字段說明”，下載地址為：http:/114-/xml/hotellist.xml 每一家酒店均有一個(gè)xml文件（以hotel

8、id作為文件名） 提供了藝龍每一家酒店詳細(xì)的酒店基礎(chǔ)信息數(shù)據(jù)，包括酒店名稱、id、地址、介紹等內(nèi)容，具體字段定義同hotel_cn.xml文件中的字段定義，下載地址為：中文版本為：http:/114-/xml/perhotelcn/hotelid.xml英文版本為：http:/114-/xml/perhotelen/hotelid.xml 獲取指定酒店信息請(qǐng)?zhí)鎿Q上面鏈接中的hotelid其他靜態(tài)數(shù)據(jù)文件：包括geo_cn.xml(英文版對(duì)應(yīng)geo_en.xml)、hotelbaseinfocodes_cn.xml(英文版對(duì)應(yīng)hotelbase

9、infocodes_en.xml)同打包下載更新方式靜態(tài)文件（2）、靜態(tài)數(shù)據(jù)文件的初始化及更新 初始化：首先下載hotellist.xml文件到本地，通過hotellist文件解析出每家酒店的hotelid，然后通過調(diào)用每一家酒店的xml文件把酒店靜態(tài)信息解析到本地?cái)?shù)據(jù)庫 更新：首先下載hotellist.xml文件到本地，通過hotellist.xml文件解析出藝龍到期酒店的hotelid，然后刪除本地?cái)?shù)據(jù)庫此家酒店的基礎(chǔ)信息數(shù)據(jù)；再通過hotellist.xml文件解析出藝龍新簽酒店的hotelid，再調(diào)用每一家新簽酒店的xml文件把酒店靜態(tài)信息解析到本地?cái)?shù)據(jù)庫 （3）、數(shù)據(jù)更新頻率 本更

10、新頻率為hotellist.xml、各個(gè)酒店單獨(dú)的xml文件為每天更新一次；而geo_cn.xml、hotelbaseinfocodes_cn.xml則為每周更新一次（更新時(shí)間為每周六） 2、打包下載更新方式（1）、api靜態(tài)數(shù)據(jù)文件包含三個(gè)， 三個(gè)文件均以靜態(tài)xml文件方式來提供，其中hotel_cn.xml提供的每一家酒店的基礎(chǔ)信息，包括酒店名稱、id、地址、介紹等內(nèi)容geo_cn.xml提供了每一城市的地理位置信息，包括行政區(qū)、商業(yè)區(qū)等內(nèi)容hotelbaseinfocodes提供了接口中部分參數(shù)字典信息 三個(gè)靜態(tài)文件下載地址為：http:/114-/xml/文件

11、名中文版本文件名為 geo_cn.xml, hotel_cn.xml, hotelbaseinfocodes_cn.xml英文版本文件名為 geo_en.xml, hotel_en.xml, hotelbaseinfocodes_en.xml（2）、靜態(tài)數(shù)據(jù)文件的更新 由于靜態(tài)文件日常更新較慢，并且數(shù)據(jù)變化比較小；因此，藝龍系統(tǒng)將在每周六凌晨2點(diǎn)對(duì)此三個(gè)靜態(tài)文件進(jìn)行一次更新，更新方式為累積更新。 對(duì)于靜態(tài)文件的更新，藝龍建議合作方每一周或兩周更新一次，更新時(shí)可以先清空本地?cái)?shù)據(jù)庫，然后進(jìn)行插入操作。 由于這三個(gè)文件中，hotel_cn.xml比較大（160mb-200mb之間），建議先用下載工具

12、（迅雷、flashget）把此文件下載到本地，然后通過程序解析的方式把此文件解析到本地?cái)?shù)據(jù)庫。 3、靜態(tài)文件字段說明 、hotellist.xml文件名稱描述備注addtime此酒店簽約時(shí)間日期格式，帶時(shí)間deltime此酒店刪除作廢時(shí)間日期格式，帶時(shí)間hotel_id酒店id可據(jù)此去perhotelcn文件夾下取酒店信息（peihotelcn下文件命名方式：hotel_id+.xml）hotel_name酒店中文名hotel_name_en酒店英文名isreserve此酒店是否可用0表示可用，1、 2表示酒店已刪除modifytime此酒店最近一次修改時(shí)間暫時(shí)不生效 、hotel_cn.xm

13、l文件（示例文件見附件） 名稱描述備注id酒店id八位數(shù)字來表示dateupdated酒店最新更新時(shí)間name酒店名稱address酒店地址zip酒店郵編category酒店星級(jí)-1，0均代表經(jīng)濟(jì)型酒店typology酒店類別目前只有hroomnumber酒店總房間數(shù)量availpolicy酒店特殊信息提示activationdate暫時(shí)不用usersrating用戶評(píng)分,目前沒有賦值elongranking酒店在藝龍的排序，暫時(shí)不用templatetype暫時(shí)不用translations暫時(shí)不用doublepricemin暫時(shí)不用doublepricemax暫時(shí)不用currency暫時(shí)不用l

14、at酒店所在位置的緯度用于位置搜索lon酒店所在位置的經(jīng)度用于位置搜索country酒店所在國家region酒店區(qū)域暫時(shí)不用，空值province酒店所在省份id表示，省份名稱和geo中province關(guān)聯(lián)city酒店所在城市id表示，城市名稱和geo中cityid關(guān)聯(lián)businesszone酒店所在商業(yè)區(qū)id表示，商業(yè)區(qū)名稱和geo中commerciallocation關(guān)聯(lián)district酒店所在行政區(qū)id表示，城市名稱和geo中district關(guān)聯(lián)propertyurl酒店在網(wǎng)站中的詳細(xì)頁urlintroeditor酒店介紹信息對(duì)酒店的詳細(xì)介紹ccaccepted

15、可支持的信用卡支持的信用卡為：銀聯(lián)、jcb、mastercard、visadescription酒店描述對(duì)酒店的簡單描述images酒店圖片信息此為一節(jié)點(diǎn)，節(jié)點(diǎn)字段解釋見下表airportpickupservice酒店免費(fèi)接機(jī)信息此為一節(jié)點(diǎn)，節(jié)點(diǎn)字段解釋見下表generalamenities酒店服務(wù)設(shè)施信息此為一節(jié)點(diǎn)，節(jié)點(diǎn)字段解釋見下表roomamenities房間服務(wù)設(shè)施信息此為一節(jié)點(diǎn)，節(jié)點(diǎn)字段解釋見下表recreationamenities休閑服務(wù)設(shè)施信息此為一節(jié)點(diǎn)，節(jié)點(diǎn)字段解釋見下表conferenceamenities會(huì)議服務(wù)設(shè)施信息此為一節(jié)點(diǎn)，節(jié)點(diǎn)字段解釋見下表diningameni

16、ties餐飲服務(wù)設(shè)施信息此為一節(jié)點(diǎn)，節(jié)點(diǎn)字段解釋見下表trafficandaroundinformations周邊交通信息此為一節(jié)點(diǎn)，節(jié)點(diǎn)字段解釋見下表surroundingcommerces周邊商務(wù)信息此為一節(jié)點(diǎn)，節(jié)點(diǎn)字段解釋見下表surroundingrestaurants周邊餐飲信息此為一節(jié)點(diǎn)，節(jié)點(diǎn)字段解釋見下表surroundingattractions周邊景致信息此為一節(jié)點(diǎn)，節(jié)點(diǎn)字段解釋見下表surroundingshops周邊購物信息此為一節(jié)點(diǎn)，節(jié)點(diǎn)字段解釋見下表featureinfo酒店特色信息此為一節(jié)點(diǎn)，節(jié)點(diǎn)字段解釋見下表roominfo酒店房型信息此為一節(jié)點(diǎn)，節(jié)點(diǎn)字段解釋見下

17、表phone酒店電話(前臺(tái))fax酒店傳真(前臺(tái))openingdate酒店開業(yè)日期renovationdate酒店裝修日期landmarks酒店附近標(biāo)志物 id表示， 標(biāo)志物名稱對(duì)應(yīng)geo中l(wèi)andmarklocations列表節(jié)點(diǎn)包含多個(gè)子節(jié)點(diǎn)，節(jié)點(diǎn)對(duì)應(yīng)字段說明為：名稱描述備注imageurl圖片url地址imgtype圖片類型？title圖片標(biāo)題imgnum 節(jié)點(diǎn)下對(duì)應(yīng)字段說明為：名稱描述備注extensiondata暫時(shí)不用enddate免費(fèi)接機(jī)結(jié)束日期endtime接機(jī)每天結(jié)束時(shí)間startdate免費(fèi)接機(jī)開始日期starttime接機(jī)每天開始時(shí)間節(jié)點(diǎn)下對(duì)應(yīng)字段說明為：名稱描述備注e

18、xtensiondata暫時(shí)不用amenitysimplelist服務(wù)設(shè)施列表overview酒店服務(wù)設(shè)施概述節(jié)點(diǎn)下對(duì)應(yīng)字段說明為：名稱描述備注extensiondata暫時(shí)不用amenitysimplelist服務(wù)設(shè)施列表overview房間服務(wù)設(shè)施概述節(jié)點(diǎn)下對(duì)應(yīng)字段說明為：名稱描述備注extensiondata暫時(shí)不用amenitysimplelist服務(wù)設(shè)施列表overview休閑服務(wù)設(shè)施概述節(jié)點(diǎn)可能包含多個(gè)子節(jié)點(diǎn)，對(duì)應(yīng)字段說明為：名稱描述備注amenitylist會(huì)議室列表包含多個(gè)子節(jié)點(diǎn)overview酒店會(huì)議室設(shè)施概述子節(jié)點(diǎn)對(duì)應(yīng)字段說明為：名稱描述備注extensiondata暫時(shí)不

19、用amenitydetail會(huì)議室介紹amenityname會(huì)議室名稱節(jié)點(diǎn)節(jié)點(diǎn)可能包含多個(gè)子節(jié)點(diǎn)，對(duì)應(yīng)字段說明為：名稱描述備注amenitylist餐廳列表包含多個(gè)子節(jié)點(diǎn)overview酒店餐廳設(shè)施概述子節(jié)點(diǎn)對(duì)應(yīng)字段說明為：名稱描述備注extensiondata暫時(shí)不用amenitydetail餐廳介紹amenityname餐廳名稱節(jié)點(diǎn)對(duì)應(yīng)字段說明為：名稱描述備注extensiondata暫時(shí)不用overview周邊交通信息概述trafficandaroundinformationlist周邊交通信息列表的子節(jié)點(diǎn)可能包含多個(gè)節(jié)點(diǎn)，其對(duì)應(yīng)字段說明為：名稱描述備注extensiondata暫時(shí)不用

20、distances到酒店距離name周邊交通名稱note備注信息timetaken所用時(shí)間transportfee交通花費(fèi)費(fèi)用transportations乘坐的交通工具參見hotelbaseinfocodes_cn.xml信息節(jié)點(diǎn)包含多子節(jié)點(diǎn)，節(jié)點(diǎn)對(duì)應(yīng)字段說明為：名稱描述備注extensiondata暫時(shí)不用distances到酒店距離name周邊商業(yè)區(qū)名稱note備注信息timetaken所用時(shí)間transportfee交通花費(fèi)費(fèi)用transportations乘坐的交通工具參見hotelbaseinfocodes_cn.xml信息節(jié)點(diǎn)包含多子節(jié)點(diǎn)，節(jié)點(diǎn)對(duì)應(yīng)字段說明為：名稱描述備注exte

21、nsiondata暫時(shí)不用description餐廳描述distances到酒店距離name周邊餐廳名稱節(jié)點(diǎn)包含多子節(jié)點(diǎn)，節(jié)點(diǎn)對(duì)應(yīng)字段說明為：名稱描述備注extensiondata暫時(shí)不用distances到酒店距離name周邊餐廳名稱節(jié)點(diǎn)包含多子節(jié)點(diǎn)，節(jié)點(diǎn)對(duì)應(yīng)字段說明為：名稱描述備注extensiondata暫時(shí)不用description商業(yè)區(qū)描述distances到酒店距離name商業(yè)區(qū)名稱節(jié)點(diǎn)對(duì)應(yīng)字段說明為：名稱描述備注hotelid酒店iddrivingguide駕車指南propertyotherhightlights酒店其他特色propertyamenitieshightlights

22、服務(wù)設(shè)施特色locationhighlights地理位置特色overview酒店特色信息概述節(jié)點(diǎn)包含多個(gè)子節(jié)點(diǎn)，節(jié)點(diǎn)對(duì)應(yīng)字段說明為：名稱描述備注roomtypeid房型idroomname房型名稱roomtypenum房型數(shù)量area房間面積floor房型所在的樓層hasbroadband是否有寬帶0表示無寬帶，1 表示有寬帶hasbroadbandfee寬帶是否收費(fèi) 0表示免費(fèi)，1 表示收費(fèi)beddescription房間描述包括大床、雙床、寬帶等一類描述note備注節(jié)點(diǎn)包含多個(gè)子節(jié)點(diǎn)，節(jié)點(diǎn)對(duì)應(yīng)字段說明為：名稱描述備注extensiondata暫時(shí)不用hotelid酒店idlandmarki

23、d酒店附近標(biāo)志物idlandmarkname酒店附近標(biāo)志物名稱landmarknameen酒店附近標(biāo)志物英文名稱、geo_cn.xml文件說明名稱描述備注idgeoid,從1開始，依次加1country國家provincename省份名稱provinceid省份idcityname城市名稱citycode城市idproperties該城市下的有效酒店個(gè)數(shù) url該酒店在網(wǎng)站上的搜索列表urldistricts行政區(qū)節(jié)點(diǎn)location列表commerciallocations商業(yè)區(qū)節(jié)點(diǎn)location列表landmarklocations城市標(biāo)志物節(jié)點(diǎn)location

24、列表節(jié)點(diǎn)對(duì)應(yīng)字段說明：名稱描述ididname名稱、hotelbaseinfocodes_cn.xml文件說明 hotelbaseinfocodes_cn.xml包含以下字典信息： 星級(jí)代碼 擔(dān)保類別代碼（目前api接口只支持“不擔(dān)保”和“信用卡擔(dān)?！眱深悾?訂單狀態(tài)代碼 客人類別代碼 支付方式代碼（目前api接口只支持“前臺(tái)自付”方式） 貨幣代碼 確認(rèn)方式代碼 語言代碼 性別代碼 證件類型代碼 訂單取消原因代碼 交通工具 酒店類別（目前靜態(tài)文件中只有“h”類型） 房態(tài)類別代碼 增值服務(wù)代碼 預(yù)訂規(guī)則類別代碼 促銷規(guī)則代碼 取消規(guī)則類型代碼四、代理商登錄接口login 代理商登錄接口主要是為獲

25、取到數(shù)字憑證logintoken，logintoken是訪問其他api動(dòng)態(tài)接口的必需參數(shù)。 動(dòng)態(tài)接口的訪問地址為：正式環(huán)境:http:/114-/northboundservice/v1.1/northboundapiservice.asmx 測試環(huán)境：98/northboundservice/v1.1/northboundapiservice.asmx 此接口輸入?yún)?shù)為：字段類型描述是否可為空備注usernamestringapi登錄賬號(hào)名npasswordstringapi登錄密碼n 輸入?yún)?shù)后，生成的requestion.x

26、ml請(qǐng)求如下： 0 username /必須填寫 userpassword /必須填寫 此接口輸出參數(shù)為：字段類型描述可為空備注loginresult logintokenstring登錄憑證y輸出參數(shù)生成的response.xml如下： 0 /判斷請(qǐng)求是否成功標(biāo)志 2010-10-06t10:49:21.3432823+08:00 succeed /如果不成功，錯(cuò)誤信息將在此字段列出 e1f0b736-f798-47ce-a798-993620bac4b8 /獲取的logintoken數(shù)字憑證 2010-10-06t10:54:21.3432823+08:00/數(shù)字憑證logintoken的

27、有效時(shí)間 五、api動(dòng)態(tài)接口 在調(diào)用api接口中，所有發(fā)送的請(qǐng)求數(shù)據(jù)（request.xml）都需要包含節(jié)點(diǎn)，此節(jié)點(diǎn)作為接口的數(shù)字驗(yàn)證字段。所有接受的數(shù)據(jù)（response.xml）都需要包含節(jié)點(diǎn)，此節(jié)點(diǎn)作為接口返回?cái)?shù)據(jù)的狀態(tài)信息。requesthead字段說明參數(shù)類型說明備注可否為空logintoken string訪問憑證登錄接口除外nlanguagestring接口語言cn:中文、en:英文， 大寫字母nguidstring唯一標(biāo)識(shí)id在submithotelorder接口中必須填寫，并且不同的訂單對(duì)應(yīng)的guid不能相同， 否則不能正常成單。 如果成單出現(xiàn)超時(shí)再次提交相同請(qǐng)求，則guid

28、不需要改變，否則可能會(huì)出現(xiàn)生成重復(fù)訂單問題，nversionstring版本號(hào)可省略ytestmodeint測試開關(guān)0-正式，1-測試，默認(rèn)為0, 暫時(shí)不起作用yrequesthead節(jié)點(diǎn)內(nèi)容 e1f0b736-f798-47ce-a798-993620bac4b8 /調(diào)用login獲取的訪問憑證 cn /請(qǐng)求數(shù)據(jù)的語言，cn-中文，en-英文 /可以為空，但在提交訂單接口（submithotelorder）則需要填寫不同的值，以進(jìn)行不同訂單的區(qū)分。如果不填，則無論下幾張訂單，所返回的訂單號(hào)只有一個(gè)，且藝龍系統(tǒng)中下取成功的訂單頁只有一個(gè)。 /可以不填 0 /可以不填 responsehead字

29、段內(nèi)容為：參數(shù)類型說明描述可否為空resultcodestring結(jié)果編號(hào)0-成功,1-失敗nresultmessagestring結(jié)果信息錯(cuò)誤信息或提示信息ytimestampdatetime結(jié)果生成的時(shí)間yyyy-mm-ddthh:mm:ss例如: 2009-01-14t16:50:20nresponsehead節(jié)點(diǎn)內(nèi)容 0 /返回結(jié)果，0-請(qǐng)求成功 1-請(qǐng)求失敗 2010-10-08t10:36:36.6428603+08:00 注意：所有接口的節(jié)點(diǎn)字段中，即是有些參數(shù)你不需要填寫（比如），但在實(shí)例化中也需要保留此字段，并把此字段進(jìn)行默認(rèn)賦值(string類型為空，int類型為0，日期類

30、型為“0001-01-01 00:00:00”)1. 酒店價(jià)格查詢接-gethotellist輸入?yún)?shù)（gethotel condition）節(jié)點(diǎn)下字段說明為（紅色字體代表是個(gè)節(jié)點(diǎn)數(shù)組）：字段類型描述默認(rèn)值可為空備注gethotelcondition checkindatedatetime入住日期0001-01-01 00:00:00n日期有效，建議入住日期和離店日期不要超過20天 checkoutdatedatetime離店日期0001-01-01 00:00:00n日期有效，返回結(jié)果中不包含離店日期的價(jià)格信息，離店日期大于入住日期cityid string城市id空n1、酒店名稱可為酒店名

31、稱的一部分。2、城市id,酒店名稱，酒店id至少有一個(gè)不為空， 如果hotelname不為空，cityid也不能為空。3、酒店id為多個(gè)時(shí), id之間可用英文逗號(hào)分隔hotelnamestring酒店名稱空nhotelidstring酒店id 空nroomtypeidstring房型id空y通過此兩個(gè)字段可查詢某個(gè)酒店的詳細(xì)產(chǎn)品信息rateplanidintrateplanid0ystarcodestring星級(jí)代碼空y參見星級(jí)代碼信息starcodes，多個(gè)以英文逗號(hào)分隔highestrateint產(chǎn)品最高價(jià)格0y1、字段為0則不限價(jià) 2、如搜200元以下，則highestrate=200，

32、lowestrate=0 3、如搜600元以上，則highestrate=10000，lowestrate=600lowestrateint產(chǎn)品最低價(jià)格0ypositionmodecodestring位置查詢模式0y0：不按位置搜索； 1：按矩形方式； 2：按點(diǎn)-半徑方式startlongitudedecimal起始經(jīng)度0y1、此5個(gè)字段作為地圖搜索使用，在positionmodecode=2或3時(shí)，使用此字段2、radius字段的單位為：米startlatitudedecimal起始緯度0yendlongitudedecimal終止經(jīng)度0yendlatitudedecimal終止緯度0yra

33、diusint半徑0ydistrictidstring行政區(qū)id空y如果按照這3個(gè)查詢，則城市id必須輸入， id的具體數(shù)值從geo_cn.xml中獲取commerciallocationidstring商業(yè)區(qū)id空ylandmarklocationidstring標(biāo)志物id空yopeningdatedatetime開業(yè)日期0001-01-01 00:00:00y暫不支持，默認(rèn)填寫0001-01-01 00:00:00decorationdatedatetime裝修日期0001-01-01 00:00:00y暫不支持，默認(rèn)填寫0001-01-01 00:00:00roomamountint房間

34、數(shù)量0y默認(rèn)為1，暫不支持orderbycodestring排序標(biāo)準(zhǔn)空yelong：默認(rèn) star：按星級(jí) price：按價(jià)格distance：按距離ordertypecodestring排序類型空yasc :升序desc:降序pageindexint分頁頁數(shù)0y默認(rèn)從1開始maxrowsint最大返回記錄數(shù)0y0或空表示不限制如果超過elong默認(rèn)的最大記錄數(shù)，則以elong設(shè)置為準(zhǔn)，默認(rèn)最大為20currencycodestring空rmb ：人民幣 usd ：美元 hkd ：港元 mop ：澳元（暫不支持） sgd ：新幣（暫不支持），此查詢條件暫時(shí)不提供輸出參數(shù)字段類型描述可為空備注h

35、otelcountint酒店個(gè)數(shù)n查詢結(jié)果中返回的酒店個(gè)數(shù)hotels hotels包含n個(gè)hotel數(shù)組hotelhotel數(shù)組 hotelnamestring酒店名稱n hotelidstring酒店idnstarcodestring星級(jí)代碼n參見靜態(tài)數(shù)據(jù)文件hotelbaseinfocodes_cn.xmlhoteladdressstring酒店地址n hotelinvstatuscodestring酒店房態(tài)n0-正常 1-部分日期滿房，2-全部滿房 lowestpricedecimal酒店最低價(jià)n roomsrooms下包含n個(gè)room數(shù)組，參見下面介紹 hotelpromotions

36、酒店活動(dòng)節(jié)點(diǎn)節(jié)點(diǎn)包含多個(gè)子節(jié)點(diǎn)，節(jié)點(diǎn)對(duì)應(yīng)字段說明為： roomn roomnamestring房型名稱n roomtypeidstring房型idn roominvstatuscodestring房型房態(tài)n0-正常 1-部分日期滿房，2-全部滿房rateplansrateplan數(shù)組節(jié)點(diǎn)節(jié)點(diǎn)包含多個(gè)子節(jié)點(diǎn)，節(jié)點(diǎn)對(duì)應(yīng)字段說明為： rateplan rateplanidintrpid藝龍?jiān)诜啃突A(chǔ)上把產(chǎn)品進(jìn)一個(gè)細(xì)分，細(xì)分后的每一產(chǎn)品稱為rateplan，簡稱rp rateplancodestringrp業(yè)務(wù)編碼 rateplannamestringrp名稱guesttypecodestring客人

37、類型代碼參見靜態(tài)數(shù)據(jù)hotelbaseinfocodes_cn.xml文件ratesnrp價(jià)格數(shù)組，參見下面介紹garanteerulesy擔(dān)保規(guī)則數(shù)組，參見下面介紹bookingrulessy預(yù)訂規(guī)則數(shù)組，參見下面介紹addvaluesy增值服務(wù)信息數(shù)組，參見下面介紹addvaluesdescriptiony增值服務(wù)信息描述，參見下面介紹drrrulesy產(chǎn)品促銷規(guī)則數(shù)組，參見下面介紹hotelpromotionsy酒店促銷活動(dòng)數(shù)組，參見下面介紹節(jié)點(diǎn)對(duì)應(yīng)字段說明為：rates 房價(jià)數(shù)組 totalpricedecimal總價(jià) currencycodestring貨幣代碼 taxesamoun

38、tint稅費(fèi)節(jié)點(diǎn)， 包含類型，價(jià)格，暫不使用 rate每日價(jià)格數(shù)組節(jié)點(diǎn)對(duì)應(yīng)字段說明為： rate每日價(jià)格數(shù)組 datedatetime對(duì)應(yīng)日期n假設(shè)你查詢2010-10-5到2010-10-7價(jià)格，則對(duì)應(yīng)rate展示3天（5，6，7）價(jià)格數(shù)據(jù)（rate） currencycodestring貨幣代碼 invstatuscodestring每日房態(tài)n0-正常 1、2-全部滿房 retailratedecimal門市價(jià)n memberratedecimal會(huì)員價(jià)格n預(yù)訂酒店價(jià)格，返回-1代表此房無價(jià)，無價(jià)和滿房都不能進(jìn)行預(yù)訂 addbedratedecimal加床價(jià)格y返回-1代表不能加床，0-免

39、費(fèi)加床，大于0表示加床的費(fèi)用節(jié)點(diǎn)節(jié)點(diǎn)包含多個(gè)子節(jié)點(diǎn)，節(jié)點(diǎn)對(duì)應(yīng)字段說明為：garanteerules garanteerule garanteerulestypecodeint擔(dān)保規(guī)則類型 1- 信用卡-日期擔(dān)保2- 信用卡-房量擔(dān)保， 房量擔(dān)保時(shí)也有有效日期的限制，同時(shí)可能會(huì)并存客人到店時(shí)間的判斷條件，不能只簡單的校驗(yàn)房量，需要遍歷檢查rulevalues中的每個(gè)節(jié)點(diǎn)后進(jìn)行綜合判斷 rulevaluesdictionaryentry規(guī)則的具體數(shù)據(jù)數(shù)組, 規(guī)則有幾個(gè)參數(shù)，對(duì)應(yīng)幾個(gè)節(jié)點(diǎn)值 descriptionstring該條擔(dān)保規(guī)則對(duì)應(yīng)的描述，如果代理不想解析規(guī)則，可以直接在預(yù)定流程中展示該描述

40、節(jié)點(diǎn)對(duì)應(yīng)字段說明為： rulevalues key對(duì)應(yīng)擔(dān)保條件字段n value對(duì)應(yīng)擔(dān)保條件值yrulevalue項(xiàng)說明：項(xiàng)示例值說明備注startdate2010-05-04 00:00:00需要擔(dān)保開始日期1-入住日期2-在店日期3-預(yù)訂日期舉例：datetype為1表示當(dāng)前訂單的入住日期落在startdate 和 enddate之間，并且入住日期符合周設(shè)置時(shí)才需要判斷其它條件是否擔(dān)保，否則不需要擔(dān)保 enddate2010-12-31 00:00:00需要擔(dān)保結(jié)束日期datetype1擔(dān)保條件日期判斷基準(zhǔn)weekset1,2,3,4,5,6,7周有效天數(shù)， 一般為周一到周日都有效， 判斷

41、日期符合日期段同時(shí)也要滿足周設(shè)置的有效周一對(duì)應(yīng)為1，周二對(duì)應(yīng)為2， 依次類推gage1信用卡擔(dān)保 ,該字段目前可以忽略系統(tǒng)默認(rèn)為1 isarrivetimevouch0是否校驗(yàn)到店時(shí)間 0為不校驗(yàn)到店時(shí)間1為需要校驗(yàn)到店時(shí)間當(dāng)isarrivetimevouch為1時(shí)，arrivestattime、arriveendtime、istomorrow才有值arrivestattime18:00到店擔(dān)保的開始時(shí)間arriveendtime6:00到店擔(dān)保的結(jié)束時(shí)間istomorrow1到店擔(dān)保的結(jié)束時(shí)間是否為第二天 0為當(dāng)天，1為次日isroomcountvouch0是否校驗(yàn)房量 0為不校驗(yàn)房量條件，

42、1為校驗(yàn)房量條件當(dāng)garanteerulestypecode為2時(shí)有效roomcount0擔(dān)保的房間數(shù),預(yù)定幾間房以上要擔(dān)保vouchmoneytype2擔(dān)保金額, 1為首晚房費(fèi)2為全額房費(fèi)ischange1是否允許變更1為允許變更2為不允許變更c(diǎn)hangerule4擔(dān)保規(guī)則條數(shù)，規(guī)則1、不允許變更取消 2、允許變更/取消,需在xx日yy時(shí)之前通知3、允許變更/取消,需在最早到店時(shí)間之前幾小時(shí)通知4、允許變更/取消,需在到店日期的24點(diǎn)之前幾小時(shí)通知當(dāng)存在規(guī)則2、3、4時(shí)，需要查看daynum、hournum、timenum數(shù)據(jù)以及ischange當(dāng)changerule=2時(shí)，需包含字段為：daynum2011-02-28幾日對(duì)應(yīng)規(guī)則3描述中 “允許變更/取消,需在xx日yy時(shí)之前通知” 中的xx日，yy時(shí)timenum18：00幾時(shí)當(dāng)changerule=3時(shí)，需包含字段為：hournum6幾小時(shí)對(duì)應(yīng)規(guī)則3描述中 “ 允許變更/取消,需在最早到店時(shí)間之前幾小時(shí)通知” 中的幾小時(shí)當(dāng)changerule=4時(shí)，需校驗(yàn)字段為：hournum5幾