攜程網(wǎng)站聯(lián)盟API20 詳細說明文檔 - 攜程網(wǎng)站聯(lián)盟- 攜程旅行網(wǎng)

1、1 攜程網(wǎng)站聯(lián)盟攜程網(wǎng)站聯(lián)盟攜程網(wǎng)站聯(lián)盟 apiapiapi 平臺平臺平臺 2.02.02.0 集成開發(fā)指南集成開發(fā)指南集成開發(fā)指南 文檔編號：p-11096.2-09-02 項 目 名：網(wǎng)站聯(lián)盟 ii 期-api2.0 平臺 作 者：劉磊 文 件 名：攜程旅行網(wǎng)網(wǎng)站聯(lián)盟 api2.0 集成開發(fā)指南.doc 保密等級： 審 核 人： 批 準(zhǔn) 人： 文件狀態(tài)： 草稿 正在修改 正式發(fā)布 最后更新時間：2012-7-11 版權(quán)申明： 本文件屬于機密文件，所有權(quán)屬于攜程計算機技術(shù)（上海）有限公司。任何接觸此件的人必 須遵守以下規(guī)定： 1 本文件及包含的內(nèi)容均屬于攜程計算機技術(shù)（上海）有限公司資產(chǎn)。

2、2 未經(jīng)攜程計算機技術(shù)（上海）有限公司的書面同意，任何人不得對本文件的全部和/或 部分內(nèi)容進行任何形式的復(fù)制或傳播擴散。 2 版本歷史 版本/狀態(tài)作者審核人發(fā)布日期備注 v0.1劉磊2012-5-4 v0.2劉磊2012-5-7增加國際機票相關(guān)內(nèi)容 v0.3陳浩劉磊2012-5-8 1修改酒店搜索，可訂檢查， 訂單詳情等契約及說明 2更新錯誤代碼 v1.0盛凱劉磊2012-5-10 1增加度假 api 說明 2請求列表中刪除訂單提交 api v1.1劉磊2012-5-11 1增加支付說明 2增加靜態(tài)文件下載地址 v1.2劉磊2012-6-4 1修改酒店靜態(tài)信息接口說 明，修正請求樣例中的錯誤

3、v1.3 徐馳 唐春龍 劉磊 劉磊2012-6-11 1增加團購 api 相關(guān)說明 2增加酒店 api 相關(guān)時間格 式說明 3增加酒店 api 價格計劃促 銷活動說明 v1.4 王濤 劉磊 劉磊2012-7-11 1增加國內(nèi)機票 api 說明 2修正團購 api 請求類型說 明 v1.4劉磊2012-8-30 1ota_hotelsearch 和 ota_hotelrateplan 增加 7 天及香格里拉等酒店查詢參 數(shù)說明 v1.5 徐馳 唐春龍 2012-9-26整理最新的說明文檔 3 目錄 1. 引言.8 1.1. 目的.8 1.2. 讀者對象.8 1.3. 文檔內(nèi)部約定.8 1.3.1

4、. 文檔字體約定.8 1.4. 術(shù)語與縮寫.8 2. 方案概述.9 2.1. 業(yè)務(wù)說明.9 2.2. 業(yè)務(wù)流程.11 2.3. api2.0 平臺介紹.16 3. 數(shù)據(jù)格式.20 3.1. 請求地址 .20 3.2. 請求類型 .20 3.3. 測試及正式訪問 .24 3.3.1. 測試環(huán)境訪問.24 3.3.2. 生產(chǎn)環(huán)境訪問.24 3.4. 請求頻次.24 3.5. 簽名原始串.24 3.6. 簽名算法.25 3.6.1. md5簽名原理.25 3.7. 接口介紹.26 3.7.1. 用戶 user.26 . 用戶生成 ota_useruniqueid.26 3.7.2. 酒

5、店hotel.28 . 靜態(tài)文件下載.28 . 聯(lián)通測試 ota_ping.29 . 酒店查詢 ota_hotelsearch .31 4 . 酒店靜態(tài)信息查詢 ota_hoteldescriptiveinfo.38 . 價格計劃查詢 ota_hotelrateplan.53 . 價格緩存變化查詢 ota_hotelcachechange.65 . 可訂檢查 ota_hotelavail.69 . 訂單生成 ota_hotelres.81 . 訂單取消 ota_canc

6、el.98 0. 訂單變化查詢 ota_hotelresnotif.102 1. 訂單詳情查詢 ota_read.107 2. 酒店列表查詢 d_hotelsearch .118 3. 酒店詳情 d_hoteldetail.137 4. 酒店訂單列表查詢 d_hotelorderlist.166 5. 酒店訂單詳情查詢 d_hotelorderdetail.173 6. 酒店評價查詢 d_hotelcommentlist.179 3.7.3. 國內(nèi)機票flight .182 . 靜態(tài)

7、文件下載 .182 . 國內(nèi)機票查詢 ota_flightsearch.183 . 國內(nèi)機票生成訂單 ota_fltsaveorder .191 . 國內(nèi)機票取消訂單 ota_fltcancelorder.201 . 國內(nèi)機票訂單列表 ota_fltorderlist.203 . 國內(nèi)機票訂單詳情 ota_fltvieworder .208 . 國內(nèi)機票訂單變更 ota_getstatuschangedorders.218 3.7.4. 國際機票flight .221 . 靜態(tài)文件下載 .221

8、5 . 國際機票查詢 ota_intlflightsearch .221 . 機型信息查詢 ota_fltgetcraftinfos .238 . 城市查詢 ota_fltgetcityinfos.241 . 機場查詢 ota_fltgetairportinfos .244 . 航空公司信息 ota_fltgetairlineinfos.246 3.7.5. 度假vacations.250 . 度假地址選擇器 ota_vacationaddressselector .250 . 度假城市列表（熱門

9、城市） ota_vacationcity.252 . 度假證件類型 ota_vacationcredentialtype .255 . 度假配送方式 ota_vacationdelivertype.257 . 度假酒店 ota_vacationhotels.261 . 度假訂單金額計算 ota_vacationorderamount.269 . 度假臨時訂單生成 ota_vacationordercreate .271 . 度假訂單列表 ota_vacationorderlist.299 . 度假

10、訂單明細 ota_vacationorderinfo .304 0. 度假產(chǎn)品單選項 ota_vacationorderitem.318 1. 產(chǎn)品查詢列表 ota_vacationpackagelist.347 2. 產(chǎn)品明細 ota_vacationpackageinfo.355 3. 度假暫存訂單詳情 ota_vacationtmporderinfo .367 4. 度假系統(tǒng)機票 ota_vacationsysflight.380 5. 度假可選項列表 ota_vacationorderoption.38

11、7 3.7.6. 支付.398 . 在線支付.398 6 . 支付流水查詢 getpaymentinfo.400 3.7.7. 團購.403 . 團購產(chǎn)品列表查詢 groupproductlist.403 . 團購產(chǎn)品詳細查看 groupproductinfo.407 . 團購訂單列表查詢 grouporderlist .414 . 團購訂單生成 groupcreateorder.417 . 團購券查詢 groupquerytickets.420 . 團購訂單通知 grouporde

12、rchange .423 . 團購產(chǎn)品通知 groupproductchange.426 . 團購券通知 groupticketchange .428 . 團購券取消 groupcanceltickets.431 4. 附錄.433 4.1. faq.433 4.1.1. 問：我運行程序后怎么一直報錯誤代碼：簽名錯誤？.433 4.1.2. 問：我怎么得到聯(lián)盟身份（alliance）和站點密鑰（secretkey）？.434 4.1.3. 問：如果我只想使用酒店查詢功能，然后跳轉(zhuǎn)到ctrip.com完成預(yù)訂怎么辦？ .434 4.1.4. 問：syst

13、em error:no cache在什么情況下出現(xiàn)的？.434 4.1.5. 問：我想通過api2.0的ota_hotelsearch接口查找某個城市的所有酒店，好 像查不到請求如下。.434 4.1.6. 問：酒店價格計劃接口ota_hotelrateplan可以一次查詢多家酒店的價格嗎？ .434 4.1.7. 問：“server returned http response code: 413”是什么問題？.435 4.1.8. 問：我怎么知道我可以對接口的最大訪問頻次是多少？.435 4.1.9. 問：areaid和brandcode對應(yīng)的數(shù)據(jù)在哪里能找到。.435 4.1.10. 問

14、：ota_hotelrateplan返回的結(jié)果里rateplancode=559401 rateplancategory=16描述的是什么意思。.435 4.1.11. 問：我之前用的是酒店api1.0查詢酒店信息的，請問現(xiàn)在提供的api2.0查詢 接口在使用方式上與api1.0有區(qū)別嗎？.436 7 4.1.12. 問：為什么我調(diào)用酒店api2.0的可訂性檢查接口會拋下面的錯。.436 4.1.13. 問：酒店api2.0新預(yù)訂接口下單時，擔(dān)保信息必須要填寫嗎？.436 4.1.14. 問：酒店api2.0新預(yù)訂接口對于信用擔(dān)保時錄入的信用卡資料需要經(jīng)過加密 再傳入嗎？.436 4.1.15

15、. 問：酒店api2.0搜索接口節(jié)點infotype數(shù) 字對應(yīng)的類型有哪些。.437 4.1.16. 問：酒店api2.0的搜索接口提供最低價格的顯示嗎？.437 4.1.17. 問：酒店api2.0的搜索接口提供國外酒店的搜索嗎？.437 4.1.18. 問：酒店api2.0價格計劃接口返回的內(nèi)容中描述的是什么信息。.438 4.1.19. 問：酒店api2.0調(diào)用中報錯.438 4.1.20. 問：價格計劃接口返回多個日期段的價格我該怎么取值。.438 4.1.21. 問：我用標(biāo)準(zhǔn)soap請求名為*.asmx的服務(wù)接口為什么連不上。.438 4.1.22. 問：酒店api2.0新預(yù)訂接口的

16、聯(lián)系方式contact type有哪幾種？.438 4.2. 錯誤代碼 .439 8 1. 引言 1.1. 目的 本文描述了網(wǎng)站聯(lián)盟 api 平臺對聯(lián)盟伙伴提供的接口化預(yù)訂解決方案，幫助聯(lián)盟伙伴 輕松實現(xiàn)酒店、機票、度假等在線旅游業(yè)務(wù)查詢、預(yù)訂、api 功能。文檔分別從交互模式、 簽名、接口、注意事項等方面詳細介紹了 api 平臺的工作方式和開發(fā)過程，可以幫助開發(fā) 人員快速入門并掌握開發(fā)技能，同時也可以作為日后接口參數(shù)及參數(shù)類型的速查手冊。 1.2. 讀者對象 本文檔的預(yù)期讀者為業(yè)務(wù)需求人員、開發(fā)經(jīng)理、項目經(jīng)理、架構(gòu)設(shè)計師、開發(fā)人員、 測試人員、設(shè)計評審人員、用戶文檔編寫者。 1.3. 文檔內(nèi)

17、部約定 1.3.1. 文檔字體約定 著重說明字體：對于本文中重要，易混淆，易疏忽的關(guān)鍵內(nèi)容進行標(biāo)記時使用 的字體 補充說明字體：為便于讀者理解，文本在某些描述之后會使用現(xiàn)有系統(tǒng)的實際情 況舉例，這是一種對于前文進行補充說明時使用的字體 待定信息字體：對于本文在編寫時未確定，需與相關(guān)干系人進一步明確信息時使 用的字體 1.4. 術(shù)語與縮寫 術(shù)語/縮寫解釋 apiapplication programming interface 應(yīng)用程序接口 9 本文中指攜程旅行網(wǎng)提供給聯(lián)盟伙伴的業(yè)務(wù)數(shù)據(jù)接口 webserviceurl指 api2.0 平臺提供的業(yè)務(wù) webservice 的請求地址 soap

18、webservice 請求時使用的網(wǎng)絡(luò)協(xié)議，api2.0 平臺中提供的所有 api 必須基于 soap 協(xié)議請求 secretkey 密鑰 指聯(lián)盟伙伴通過攜程客戶經(jīng)理完成 api 平臺權(quán)限開通后獲得的針對 每個 sid 的唯一身份認證標(biāo)識?？赏ㄟ^登錄聯(lián)盟平臺 (http:/)后通過站點列表中的站點詳情頁查看。 請妥善保存此密鑰并不得泄露給第三方 xmlns所有 api2.0 平臺提供的 api 的命名空間為 http:/ 信用卡加密 在酒店部分 api 中，對于涉及到信用卡部分的數(shù)據(jù)需要進行加密。 加密算法為 des 對稱加密。加密密鑰為 secretkey 的最后 8 位。 時間格式 時間字

19、符串格式應(yīng)當(dāng)采用”iso 8601” 標(biāo)準(zhǔn) 2012-06-15t15:00:00.000+08:00 2. 方案概述 2.1. 業(yè)務(wù)說明 api 平臺提供聯(lián)盟伙伴自行通過攜程旅行網(wǎng)提供的在線旅游業(yè)務(wù) api 實現(xiàn)業(yè)務(wù)相關(guān)流 程，避免了只能導(dǎo)流量而不能自主定義預(yù)訂流程的問題 10 聯(lián)盟站點攜程api平臺 酒店 機票 度假 支付 用戶 團購 11 2.2. 業(yè)務(wù)流程 攜程api平臺申請流程 攜程分銷聯(lián)盟平臺攜程客戶經(jīng)理聯(lián)盟站點 開始 注冊并開通 分銷聯(lián)盟 發(fā)送申請郵件 至客戶經(jīng)理 審核聯(lián)盟站點申請 審核結(jié)果 郵件通知審核結(jié)果 未通過 生成secretkey 并配置api權(quán)限 通過 查看審核結(jié)果

20、未通過 通過分銷聯(lián)盟 站點信息查詢 secretkey 通過 結(jié)束 12 攜程酒店api2.0業(yè)務(wù)流程 靜態(tài)數(shù)據(jù)初始化預(yù)訂 聯(lián)盟站點攜程api平臺 開始 讀取靜態(tài)數(shù)據(jù) 導(dǎo)入本地數(shù)據(jù) 庫并完成匹配 靜態(tài)文件下載 查詢價格計劃 價格計劃 查詢api 酒店查詢api 酒店靜態(tài)信息 查詢api 本地酒店 數(shù)據(jù)查詢 選擇酒店 價格緩存變化 查詢api 更新并展示 房型價格 填寫預(yù)訂可訂檢查api 生成預(yù)訂單 并本地存儲 訂單生成api 查詢訂單列表 訂單變化 查詢api 查詢訂單詳情 訂單詳情 查詢api 取消訂單訂單取消api 結(jié)束 13 攜程國內(nèi)機票api2.0業(yè)務(wù)流程 靜態(tài)數(shù)據(jù)初始化預(yù)訂 攜程ap

21、i平臺聯(lián)盟站點 否 是 訂單生成api 含信用卡信 息 讀取靜態(tài)數(shù)據(jù) 取消訂單 是否自行 收取信用卡 導(dǎo)入本地數(shù)據(jù) 庫并完成匹配 填寫預(yù)訂 自行收取 信用卡信息 信用卡支付 導(dǎo)入本地數(shù)據(jù) 庫并完成匹配 支付api 開始 訂單變更 通知api 訂單取消api 查詢訂單列表 查詢航班 國內(nèi)機票 航班查詢api 機場列表基礎(chǔ) 信息文件下載 城市列表基礎(chǔ) 信息文件下載 機型基礎(chǔ)信息 文件下載 航空公司基礎(chǔ) 信息文件下載 國內(nèi)票臺覆蓋 城市列表文件 結(jié)束 提交訂單 生成預(yù)訂單 并本地存儲 訂單生成api 不含信用卡信 息 14 聯(lián)盟api平臺業(yè)務(wù)接入（度假） 產(chǎn)品查詢預(yù)訂支付訂單查詢 攜程api平臺聯(lián)盟

22、站點 開始 用戶輸入 查詢關(guān)鍵字 根據(jù)關(guān)鍵字 獲取查詢參數(shù) 查詢產(chǎn)品 查詢并返回查詢參數(shù)查詢參數(shù)api 查詢并返回產(chǎn)品列表 展示產(chǎn)品列表 提供預(yù)訂入口 展示產(chǎn)品詳情 查詢并返回產(chǎn)品詳情產(chǎn)品詳情api 確認人數(shù)、 出行人類型 及出返日期 查詢并返回可選項列表可選項行程無關(guān) 展示產(chǎn)品下 可選項列表 展示產(chǎn)品下 單選項列表 單選項行程相關(guān)api查詢并返回單選項列表 展示產(chǎn)品 配送列表 查詢并返回單配送列表配送方式查詢api 確認出行 聯(lián)系人信息 生成暫存訂單 生成暫存訂單 并返回暫存訂單號 暫存訂單生成api 在線支付 信用卡 在攜程支付平臺進行支付 在線支付api 根據(jù)暫存訂單號獲取訂單 詳情和支

23、付金額 計算產(chǎn)品金額查詢并返回訂單總金額產(chǎn)品金額計算api 自動提交訂單 并更新暫存訂單狀態(tài) 支付結(jié)果 通過 展示訂單詳情 客戶查詢訂單查詢訂單并返回訂單信息 結(jié)束 取消訂單需通過 客服電話進行 查詢參數(shù)api 訂單核對頁 訂單列表查詢api 訂單詳情查詢api 不通過 15 攜程團購api2.0業(yè)務(wù)流程 靜態(tài)數(shù)據(jù)初始化預(yù)訂 攜程api平臺聯(lián)盟站點 開始 城市靜態(tài) 文件下載 讀取靜態(tài)數(shù)據(jù) 導(dǎo)入本地數(shù)據(jù) 庫并完成匹配 查詢產(chǎn)品信息 產(chǎn)品列表 查詢api 本地查詢 團購產(chǎn)品 選擇產(chǎn)品產(chǎn)品詳情api 生成預(yù)訂單 并本地存儲 填寫預(yù)訂 更新并展示 產(chǎn)品詳情 訂單生成api 是否自行收 款并發(fā)券 支付a

24、pi信用卡支付 券取消api 訂單變更 通知api 查詢訂單列表 取消券 查詢?nèi)斜?結(jié)束 券變更 通知api 券列表 查詢api 發(fā)送/展示 券信息 否 是 導(dǎo)入本地數(shù)據(jù) 庫并完成匹配 產(chǎn)品變更 通知api 16 2.3. api2.0 平臺介紹 提供方式：webservice 協(xié)議：soap 請求報文： 1)請求報文分為兩個部分：header 和 requestbody 2)header 節(jié)點說明 術(shù)語/縮寫解釋 allianceid 聯(lián)盟 id 指聯(lián)盟伙伴通過網(wǎng)站聯(lián)盟平臺(http:/)自行注冊或通過 攜程客戶經(jīng)理注冊后得到的唯一聯(lián)盟標(biāo)識 類型為 int32 sid 站點 id 指聯(lián)盟伙

25、伴通過網(wǎng)站聯(lián)盟平臺(http:/)開通聯(lián)盟并登錄 后自行添加或通過攜程客戶經(jīng)理注冊后得到的聯(lián)盟下站點的唯一標(biāo) 識 類型為 int32。 一個聯(lián)盟可擁有多個站點 requesttype 請求類型 請求類型必須同請求的 webserviceurl 中的請求頁面名稱一致（不 區(qū)分大小寫）。 若 webserviceurl 和 requesttype 不一致則會返回錯誤信息 timestamp 時間戳 本文中指以 1970-1-1 00:00:00.000 為基準(zhǔn)，至當(dāng)前時間為止的 17 總秒數(shù) 每次請求的時間戳必須在到達 api 后 30 秒內(nèi) signature 簽名 以原始簽名串按照順序進行字符

26、串拼接后 md5 加密所得的字符串。 md5 相關(guān)請見 md5 簽名章節(jié) 3)requestbody 節(jié)點說明 requestbody 節(jié)點為具體業(yè)務(wù)請求 xml，根據(jù)請求的業(yè)務(wù)不同而變化。具體可參見每 個 api 的請求 xml。 酒店 api 部分請求說明 例 1：酒店聯(lián)通測試請求 xml 如下： 例 2：酒店訂單取消請求 xml 如下： 18 總結(jié)： 通過以上示例可發(fā)現(xiàn)，對于所有的酒店請求，黑色部分每次請求均一致，藍色部分為 每個業(yè)務(wù) api 的具體業(yè)務(wù)請求體，隨著請求的 api 類型不同而變化。紅色部分為每次請求 的頭節(jié)點，根據(jù)具體請求時間和請求類型而變化 度假及其他 api 請求說明

27、： 例 1：度假查詢參數(shù) api 請求 xml 如下： 上海 例 2：度假查詢參數(shù) api 請求 xml 如下： 19 總結(jié)： 通過以上示例可發(fā)現(xiàn)，對于所有的度假請求，黑色部分每次請求均一致，藍色部分為 每個業(yè)務(wù) api 的具體業(yè)務(wù)請求體，隨著請求的 api 類型不同而變化。紅色部分為每次請求 的頭節(jié)點，根據(jù)具體請求時間和請求類型而變化 響應(yīng)報文 請求報文分為兩個部分：header 和 responsebody header 節(jié)點說明 術(shù)語/縮寫解釋 referenceid 唯一追蹤編號 對于每次請求均會返回此屬性 若在使用過程中發(fā)生問題可憑此聯(lián)系攜程技術(shù)人員尋求解決方案 resultcode

28、 請求結(jié)果標(biāo)志 success 成功 fail 失敗 unknown 未知問題 forbidden 禁止訪問 error 錯誤 resultno 錯誤編號 開發(fā)人員可通過該編號在錯誤代碼列表中查詢具體錯誤信息或?qū)で髷y程技 術(shù)人員支持 resultmsg錯誤信息 timestamp響應(yīng)時間戳 responsebody 節(jié)點說明 20 responsebody 節(jié)點為具體業(yè)務(wù)響應(yīng) xml，根據(jù)請求的業(yè)務(wù)不同而變化。具體可參見每個 api 的響應(yīng) xml 3. 數(shù)據(jù)格式 3.1. 請求地址 每個不同的 api 均提供不同的基于 soap 協(xié)議的請求地址。每次請求均需使用如下格 式生成完整請求地址：

29、http:/api_url/business type/requesttype.asmx 其中參數(shù)分別代表如下內(nèi)容： api_url：所需請求的 api 訪問地址，攜程旅行網(wǎng)提供了測試環(huán)境供測試使用，在測 試通過后請聯(lián)系客戶經(jīng)理開通生產(chǎn)環(huán)境訪問權(quán)限 business type：業(yè)務(wù)類型(hotel,flight,vacations,trains,tuan,user) requesttype：請求類型 3.2. 請求類型 不同業(yè)務(wù)的請求類型列表如下： 用戶 編號術(shù)語/縮寫解釋 4801ota_useruniqueid用戶生成 酒店 編號 術(shù)語/縮寫解釋 1101ota_ping聯(lián)通測試 1102

30、ota_hotelsearch酒店查詢 21 1103ota_hoteldescriptiveinfo酒店靜態(tài)信息查詢 1104ota_hotelrateplan價格計劃查詢 1105ota_hotelcachechange價格緩存變化查詢 1106ota_hotelavail可訂檢查 1107ota_hotelres訂單生成 1108ota_cancel訂單取消 1109ota_hotelresnotif訂單變化查詢 1110ota_read訂單詳情查詢 1111d_hotelsearch通過查詢服務(wù)器直接查詢酒店列表 1112d_hoteldetail通過查詢服務(wù)器直接查詢酒店詳情 111

31、3d_hotelorderlist通過查詢服務(wù)器直接查詢酒店訂單列表 1114d_hotelorderdetail通過查詢服務(wù)器直接查詢酒店訂單詳情 1115d_hotelcommentlist通過查詢服務(wù)器直接查詢酒店評論信息 國內(nèi)機票 編號 術(shù)語/縮寫解釋 1201ota_flightsearch國內(nèi)航班查詢 1202ota_getflightgifts國內(nèi)航班禮盒 1203ota_fltsaveorder國內(nèi)機票訂單保存 1204ota_fltcancelorder國內(nèi)機票訂單取消 1205ota_fltvieworder國內(nèi)機票訂單查詢 1206ota_getstatuschanged

32、orders國內(nèi)機票訂單變更查詢 1207ota_fltorderlist國內(nèi)機票訂單列表 22 國際機票 編號 術(shù)語/縮寫解釋 1311ota_intlflightsearch國際機票查詢 1301ota_fltgetcraftinfos機型基礎(chǔ)信息查詢 1302ota_fltgetcityinfos城市基礎(chǔ)信息查詢 1303ota_fltgetairportinfos機場基礎(chǔ)信息查詢 1304ota_fltgetairlineinfos航線基礎(chǔ)信息查詢 旅游度假 編號術(shù)語/縮寫解釋 1401ota_vacationaddressselector地址選擇器 1402ota_vacationc

33、ity出發(fā)城市列表 1403ota_vacationcredentialtype證件類型 1404ota_vacationdelivertype配送方式 1405ota_vacationhotels度假酒店列表 1406ota_vacationorderitem度假產(chǎn)品單選項 1407ota_vacationorderoption度假產(chǎn)品可選項 1408ota_vacationorderamount度假訂單金額計算 1409ota_vacationordercreate訂單生成 1410ota_vacationordersubmit訂單提交（支付完成后提交） 1411ota_vacationo

34、rderlist訂單列表查詢 1412ota_vacationorderinfo訂單詳情查詢 23 1413ota_vacationpackagelist度假產(chǎn)品列表查詢 1414ota_vacationpackageinfo度假產(chǎn)品詳情 1415ota_vacationtmporderinfo暫存訂單詳情 1416ota_vacationsysflight度假系統(tǒng)機票查詢 團購 編號術(shù)語/縮寫解釋 1501groupproductlist團購產(chǎn)品列表 1502groupproductinfo團購產(chǎn)品詳情 1503groupcreateorder團購創(chuàng)建訂單 1504group_submito

35、rder團購提交訂單 1504groupquerytickets團購券列表 1505groupcanceltickets團購取消券 1506grouporderlist團購訂單列表 1507groupproductchange團購產(chǎn)品變更通知 1508grouporderchange團購訂單變更通知 1509groupticketchange團購券變更通知 支付 編號術(shù)語/縮寫解釋 1601getpaymentdetail支付查詢 1602paymententry在線支付 24 3.3. 測試及正式訪問 3.3.1. 測試環(huán)境訪問 攜程提供 api2.0 平臺測試環(huán)境。 測試環(huán)境api_url

36、為：http:/openapit 暫未開通 請在閱讀完本手冊后，聯(lián)系客戶經(jīng)理開通測試環(huán)境訪問權(quán)限及訪問密鑰。 請務(wù)必于測試環(huán)境中確認調(diào)用程序沒有缺陷。 3.3.2. 生產(chǎn)環(huán)境訪問 請聯(lián)系客戶經(jīng)理開通訪問權(quán)限，并獲取生產(chǎn)環(huán)境訪問密鑰。 生產(chǎn)環(huán)境api_url為：http:/openapi 3.4. 請求頻次 api 平臺根據(jù)不同聯(lián)盟設(shè)置了每個 api 每分鐘可訪問次數(shù)限制。若超過訪問次數(shù)限制 則將返回 ratelimit，并將鎖定 5 分鐘。 若您的業(yè)務(wù)確實需要擴充訪問次數(shù)，請聯(lián)系攜程網(wǎng)站聯(lián)盟銷客戶經(jīng)理為您配置。 3.5. 簽名原始串 無論是用 get、post 還是 xml，簽名原始串組串方式

37、都一致，除 signature 字段外，待 簽名參數(shù)按照一定規(guī)則拼接而成，參數(shù)名、空值不傳遞，不參與簽名。 簽名時字段名和字段值都采用原始值，不進行 url encode。 md5 是一種摘要生成算法，通過在簽名原始串后加上聯(lián)盟通信密鑰的內(nèi)容，進行 md5 運算，形成的摘要字符串即為簽名結(jié)果。為了方便比較，簽名結(jié)果統(tǒng)一轉(zhuǎn)換為大寫字 25 符。 3.6. 簽名算法 目前為 md5 簽名 md5 簽名計算公式： signature=md5(timestamp+allianceid+md5(signature=md5(timestamp+allianceid+md5(密鑰密鑰).toupper()+

38、sid+requesttype).toupper().toupper()+sid+requesttype).toupper() 如簽名原始參數(shù)串是：allianceid =1 charset=utf-8 content-length: length soapaction: http:/ string 27 6)響應(yīng)示例： http/1.1 200 ok content-type: text/xml; charset=utf-8 content-length: length string 7)請求 requestxml 1 50 admin userrequest 字段類型描述默認值可為空備注

39、allianceidint聯(lián)盟 idn sidint站點 idn uidkeystring本地用戶名n 調(diào)用方本地用戶名 相同值會返回相同用戶標(biāo) 識 28 8)響應(yīng) requestresult 159c906a-aa28-4f54-b609-59d2c105fde2 1 0 userresponse 字段類型描述默認值可為空備注 uniqueuidstring用戶關(guān)聯(lián)標(biāo)識n唯一值 retcodeint響應(yīng)碼 0 表示成功，其他表示失 敗 operationtypeint響應(yīng)類型 0 表示新生成的用戶 1 表示已存在的用戶 3.7.2. 酒店 hotel . 靜態(tài)文件下載 1)代碼

40、表：http:/ list.xls 2)errorcode：http:/ 3)基礎(chǔ)信息 a)包括以下內(nèi)容： i.貨幣信息 ii.國家信息 iii.省份信息 iv.城市信息 29 v.商業(yè)區(qū)信息 vi.行政區(qū)信息 b) 獲取方式請詢問客戶經(jīng)理。 . 聯(lián)通測試 ota_ping 1)服務(wù)地址：http:/api_url/hotel/ota_ping.asmx 2)方法名：request 3)方法參數(shù)：requestxml string 4)功能： a)酒店 api 聯(lián)通性測試。 b)echodata 用來輸入要測試的文本 c)顯示請求的內(nèi)容，用來檢測是否正確。 5)請求示例： 以下是

41、 soap 1.1 請求和響應(yīng)示例。所顯示的占位符需替換為實際值。 post /hotel/ota_ping.asmx http/1.1 content-type: text/xml; charset=utf-8 content-length: length soapaction: http:/ string 6)響應(yīng)示例： 30 http/1.1 200 ok content-type: text/xml; charset=utf-8 content-length: length string 7)請求 requestxml 測試文本 ota_pingrq 字段類型描述默認值可為空備注 ec

42、hodatastring測試文本n 8)響應(yīng) requestresult 31 阿什頓 ota_pingrs 字段類型描述默認值可為空備注 echodatastring返回測試文本n . 酒店查詢 ota_hotelsearch 1)服務(wù)地址：http:/api_url/hotel/ota_hotelsearch.asmx 2)方法名：request 3)方法參數(shù)：requestxml string 4)功能： a)酒店所在城市 id，酒店名稱、酒店星級等查詢酒店信息列表。 5)請求示例： 以下是 soap 1.1 請求和響應(yīng)示例。所顯示的占位符需替換為實際值。 post /ho

43、tel/ota_hotelsearch.asmx http/1.1 content-type: text/xml; charset=utf-8 content-length: length soapaction: http:/ string 32 6)響應(yīng)示例： http/1.1 200 ok content-type: text/xml; charset=utf-8 content-length: length string 7)請求 requestxml 33 ota_hotelsearchrq 字段類型描述默認值可為空備注 criteriacriteria查詢條件n criteria 字

44、段類型描述默認值可為空備注 availableonlyindicatorbool 為真時，只返回可 預(yù)訂酒店；為假時， 返回所有已激活酒 店（針對不同渠道， 可用性會不同）。 truey criterion 字段類型描述默認值可為空備注 hotelrefhotelref酒店信息查詢條件n 查詢屬性中 至少有一條 查詢條件 awardaward酒店等級y0.5 award 字段類型描述默認值可為空備注 providerstring評分者y hotelstarrate(酒店星級) ctripstarrate(攜程星級) ctriprecommendrate( 攜程評分) ratingdecimal

45、分數(shù)或級別y hotelref 字段類型描述默認值可為空備注 areaidint區(qū)域 idy hotelcitycodeint城市 idy 34 hotelnamestring酒店名稱y 8)響應(yīng) requestresult http:/images4.c- 北京西路1068號 上海 200041 35 http:/images4.c- 4628-bb62-e1d92a0b362d_100_75.jpg 余姚路417號 上海 200042 36 返回酒店信息，包含： 品牌id、酒店id、酒店所在城市id、酒店名稱、行政區(qū)id 地理位置信息：經(jīng)度、緯度。 酒店地址：地址、城市名稱、郵編。 星級：

46、評級者、級別。 周邊熱門地標(biāo)地理信息：改點到酒店距離、距離單位、地標(biāo)名稱。 酒店描述等供應(yīng)商信息：酒店短描述和酒店圖標(biāo)url. ota_hotelsearchrs 字段類型描述可為空備注 propertieslist酒店列表y 酒店信息數(shù)組,參 見 property property 字段類型描述可為空備注 chaincodeint連鎖集團 idy brandcodeint品牌 idy hotelcodeint酒店 idn hotelcitycodeint酒店所在城市 idn hotelnamestring酒店名稱n areaidint行政區(qū) idn positionposition 地理位置

47、信息(酒店 gps 坐標(biāo))y參見 position 37 addressaddress酒店地址信息y參見 address award award 酒店星級、ctrip 星級、用戶評級等y 5 個并行節(jié)點,參見 award relativepositionrelativeposition周邊熱門地標(biāo)地理信息y vendormessagesvendormessages酒店描述等供應(yīng)商信息yn 個并行節(jié)點 position 字段類型描述可為空備注 latitudedecimal坐標(biāo)緯度n longitudedecimal坐標(biāo)經(jīng)度n address 字段類型描述可為空備注 addresslinestr

48、ing酒店地址y0.5 citynamestring城市名稱n postalcodestring郵編y award 字段類型描述可為空備注 providerstring分數(shù)種類y 參見 listcode(apc) ratingdecimal分值y relativeposition 字段類型描述可為空備注 38 distancestring和酒店的距離y unitofmeasurecodestring距離單位y namestring熱點，地標(biāo)名稱y vendormessages 字段類型描述可為空備注 vendormessagevendormessage酒店短描述和酒店圖標(biāo) urln vendo

49、rmessage 字段類型描述可為空備注 infotypestring信息類別n subsectionsubsection屬性n subsection 字段類型描述可為空備注 paragraphstring屬性值n . 酒店靜態(tài)信息查詢 ota_hoteldescriptiveinfo 1)服務(wù)地址：http:/api_url/hotel/ota_ hoteldescriptiveinfo.asmx 2)方法名：request 3)方法參數(shù)：requestxml string 4)功能： a)根據(jù)請求的 hotel code 返回相應(yīng)的酒店靜態(tài)信息，并根據(jù)請求返回酒店信息，酒 3

50、9 店設(shè)施，酒店區(qū)域，酒店多媒體信息。 5)請求示例： 以下是 soap 1.1 請求和響應(yīng)示例。所顯示的占位符需替換為實際值。 post /hotel/ota_hoteldescriptiveinfo.asmx http/1.1 content-type: text/xml; charset=utf-8 content-length: length soapaction: http:/ string 6)響應(yīng)示例： http/1.1 200 ok content-type: text/xml; charset=utf-8 content-length: length string 7)請求

51、requestxml ota_hoteldescriptiveinforq 字段類型描述可為空備注 hoteldescriptiveinfos list 酒店詳細描述信息請求列表n 酒店描述信息數(shù)組, 最多 10 個,參見 hoteldescriptivein fo hoteldescriptiveinfo 字段類型描述可為空備注 hotelcodestring酒店代碼n 酒店的唯一地標(biāo)識 代碼 hotelinfohotelinfo酒店類信息y參見 hotelinfo facilityinfofacilityinfo 設(shè)施類信息（客房、會議室、餐飲、娛樂） ，這里僅限請求酒店客房設(shè)施 y參見

52、facilityinfo areainfoareainfo位置區(qū)域類信息y參見 areainfo 41 contactinfocontactinfo聯(lián)系方式類信息y參見 contactinfo multimediaobjectsmultimediaobjects多媒體信息y 參見 multimediaobjects hotelinfo 字段類型描述可為空備注 senddatabool是否發(fā)送y true 表示需要發(fā) 送 facilityinfo 字段類型描述可為空備注 sendguestroomsbool是否發(fā)送客房信息y true 表示需要發(fā) 送 areainfo 字段類型描述可為空備注 s

53、endattractionsbool是否發(fā)送景點地標(biāo)信息y true 表示需要發(fā) 送 sendrecreationsbool是否發(fā)送娛樂區(qū)域信息y true 表示需要發(fā) 送 contactinfo 字段類型描述可為空備注 senddatabool是否發(fā)送數(shù)據(jù)y true 表示需要發(fā) 送 multimediaobjects 字段類型描述可為空備注 senddatabool是否發(fā)送數(shù)據(jù)y true 表示需要發(fā) 送 42 8)響應(yīng) requestresult 乘坐機場巴士1號線，在雨花臺站下車，步行至雨花南路東站，換乘 129路，在卡子門西站下車，換乘安銅線，在殷巷站下車，步行約240米。乘坐出租車

54、約63元。 乘坐地鐵1號線南延線(中國藥科大學(xué)方向)，在勝太路站下車，步行 至勝太路站，換乘安銅線，在殷巷站下車，步行約200米。乘坐出租車約25元。 乘坐地鐵1號線南延線(中國藥科大學(xué)方向)，在勝太路站下車，步行 至勝太路站，換乘安銅線，在殷巷站下車，步行約240米。乘坐出租車約45元。 乘坐地鐵1號線南延線(中國藥科大學(xué)方向)，在勝太路站下車，步行 至勝太路站，換乘安銅線，在殷巷站下車，步行約240米。乘坐出租車約58元。 43 4:2227/upload/hotel/19000/18806/80e098fd-de46- 46f7-80b4-9fbc2f

55、71490f_550_412.jpg 4:2227/upload/hotel/19000/18806/ad3e3339-1818- 4bd2-9dce-0f073d7cccd2_550_412.jpg 4:2227/upload/hotel/19000/18806/cf76d20b-7750- 4297-a952-e599cc40cd8a_550_412.jpg 4:2227/upload/hotel/19000/18806/35abef01-d857- 41bb-81b0-4de76e

56、616e89_550_412.jpg 44 4:2227/upload/hotel/19000/18806/fb29a9dc-caf1- 4614-9dba-737a9dd549ea_550_412.jpg 4:2227/upload/hotel/19000/18806/c56bf773b253482987f97403684023b7_550 _412.jpg 4:2227/upload/hotel/19000/18806/243b1a60232241ef9bc0384d5a8868db

57、_550 _412.jpg 4:2227/upload/hotel/19000/18806/c418e3f1cbba46718f70b0f333260435_550 _412.jpg 4:2227/upload/hotel/19000/18806/3b8985e5-9acd- 4396-b765-8091c85feca3_550_412.jpg 4:2227/upload/hotel/19000/18806/d206eb60-0b12- 47c5-ba88-46d4b6040ecb_55

58、0_412.jpg 45 4:2227/upload/hotel/19000/18806/1c7f371c-37ec- 468f-a376-f5d4970a8bcb_550_412.jpg 4:2227/upload/hotel/19000/18806/20c58c62-d9bf- 47d9-bb54-9d5eaff37492_550_412.jpg 4:2227/upload/hotel/19000/18806/f8752d74-3747- 4916-a53e-81f23012f112

59、_550_412.jpg 4:2227/upload/hotel/19000/18806/6fd70e62-48cb- 4204-bfe4-52989bae8bdb_550_412.jpg 4:2227/upload/hotel/19000/18806/1e526a22-af8a- 4c41-b736-2858aa8dd196_550_412.jpg 4:2227/upload/hotel/19000/18806/9846945b-7a31- 4771-a531-e9f32758a12b

60、_550_412.jpg 46 南京湖濱金陵飯店座落在風(fēng)光秀麗的百家湖畔東北面的半島上， 三面環(huán)湖，與湖光山色相映成趣，融為一體，美侖美奐。分布于建筑物間的親水休閑花園和庭園后部的垂 釣休閑區(qū)更為飯店營造了一種人與自然和諧的氣氛。地鐵一號南延線于2010年中旬正式開通，勝太路站站 距湖濱金陵飯店步行僅5分鐘路程。 南京湖濱金陵飯店座落在風(fēng)光秀麗的百家湖畔東北面的半島上，三面 環(huán)湖，與湖光山色相映成趣，融為一體，美侖美奐。分布于建筑物間的親水休閑花園和庭園后部的垂釣休 閑區(qū)更為飯店營造了一種人與自然和諧的氣氛。 http:/ 1.酒店環(huán)境和房間還算不錯,早餐也很好br/2.環(huán)境和服務(wù)都比較 滿意