版權(quán)說明:本文檔由用戶提供并上傳,收益歸屬內(nèi)容提供方,若內(nèi)容存在侵權(quán),請進(jìn)行舉報(bào)或認(rèn)領(lǐng)
文檔簡介
1、博云網(wǎng)SaaS產(chǎn)品ISV接入指南版本日期:20111目錄1. 文檔目的 32. 接入提交項(xiàng) 33. 接口開發(fā)與測試環(huán)境 33.1. 接口工作流程 33.1.1. B/S 結(jié)構(gòu) 33.1.2. C/S 結(jié)構(gòu) 43.2. 接口工作內(nèi)容及步驟 53.2.1.B/S 結(jié)構(gòu) 63.2.2. C/S 結(jié)構(gòu) 63.3. 接口的定義及開發(fā) 63.3.1.接口實(shí)現(xiàn)形式 63.3.2. 接口消息格式 63.3.3. 軟件接口定義 83.4. 配置文件說明 103.5. 軟件試用流程 111. 文檔目的本文檔用于幫助ISV 了解其產(chǎn)品接入平臺時(shí)需要進(jìn)行哪些工作、如何進(jìn)行這些工作、完成后如何進(jìn)行測試等,ISV在開始接
2、入工作前,請?jiān)敿?xì)閱讀此文檔內(nèi)容。2. 接入提交項(xiàng)提交項(xiàng)重要程度描述數(shù)據(jù)同步接口訪問地址必需用戶購買及添加子賬戶以及賬戶操作時(shí)同步信息的接口地址產(chǎn)品系統(tǒng)訪問地址必需用戶使用軟件時(shí)跳轉(zhuǎn)的地址接口密鑰必需接口加密密鑰,測試環(huán)境使用默認(rèn)1234567890,上線時(shí)重新設(shè)定產(chǎn)品試用地址建議用戶試用產(chǎn)品所跳轉(zhuǎn)的地址產(chǎn)品試用賬號一般用戶試用產(chǎn)品登錄所需賬號產(chǎn)品試用密碼一般用戶試用產(chǎn)品登錄所需密碼3. 接口開發(fā)與測試環(huán)境3.1. 接口工作流程3.1.1. B/S 結(jié)構(gòu)用戶博云網(wǎng)SaaS軟件購買軟件調(diào)用數(shù)據(jù)同步接口發(fā)送軟件授權(quán)指令數(shù)據(jù)處理,開通系統(tǒng)返回處理結(jié)授權(quán)使用用戶調(diào)用數(shù)據(jù)同步接口發(fā)送用戶授權(quán)指令數(shù)據(jù)處理,
3、添加用戶返回處理結(jié)(對用戶的一些操作)調(diào)用數(shù)據(jù)同步接口發(fā)送操作指令數(shù)據(jù)處理,修改用戶返回處理結(jié)用戶點(diǎn)擊使用軟件按鈕跳轉(zhuǎn)到使用軟件鑒權(quán)接進(jìn)行反向用戶鑒權(quán)調(diào)用平臺用戶鑒權(quán)接口發(fā)送鑒權(quán)指令 鑒權(quán)并返回直接進(jìn)入軟件使用返回處理結(jié)果收到結(jié)果或提示無權(quán)限使用說明:1、用戶購買軟件,支付完成后,我平臺調(diào)用軟件平臺的數(shù)據(jù)同步接口,發(fā)送軟件授權(quán) 指令,將用戶定制數(shù)據(jù)信息同步給軟件平臺2、購買用戶給其它操作用戶授權(quán),我平臺調(diào)用軟件平臺的數(shù)據(jù)同步接口,發(fā)送用戶授 權(quán)指令,將用戶授權(quán)數(shù)據(jù)信息同步給軟件平臺3、用戶使用軟件的時(shí)候,在我平臺登錄后,點(diǎn)擊軟件的使用按鈕,我平臺跳轉(zhuǎn)至軟件平臺的用戶使用鑒權(quán)地址,并將軟件及用戶
4、標(biāo)示傳遞給軟件平臺,軟件平臺根絕用戶信息,調(diào)用我平臺的用戶鑒權(quán)接口,進(jìn)行用戶身份驗(yàn)證,如果返回成功,則無需再次登錄,直接跳轉(zhuǎn)至軟件平臺內(nèi);如果返回失敗,提示用戶無權(quán)限使用3.1.2. C/S 結(jié)構(gòu)用戶博云網(wǎng)軟件平臺服務(wù)器端軟件客戶端購買軟件調(diào)用數(shù)據(jù)同步接口發(fā)送軟件授權(quán)指令數(shù)據(jù)處理,開通系統(tǒng)返回處理結(jié)授權(quán)使用用戶調(diào)用數(shù)據(jù)同步接口發(fā)送冃戶授權(quán)指令數(shù)據(jù)處理,添加用戶返回處理結(jié)果(對用戶的一些操作)調(diào)用數(shù)據(jù)同步接口發(fā)送操作指令數(shù)據(jù)處理,修改用戶返回處理結(jié)果客戶端選擇博云網(wǎng)平臺使用 調(diào)用平臺用戶鑒權(quán)接口發(fā)送鑒權(quán)指令登錄軟件 鑒權(quán)并返回返回處理結(jié)果收到結(jié)果直接進(jìn)入軟件使用或提示無權(quán)限使用說明:1、用戶購買
5、軟件,支付完成后,我平臺調(diào)用軟件服務(wù)端平臺的數(shù)據(jù)同步接口,發(fā)送軟 件授權(quán)指令,將用戶定制數(shù)據(jù)信息同步給軟件服務(wù)端平臺2、購買用戶給其它操作用戶授權(quán),我平臺調(diào)用軟件服務(wù)端平臺的數(shù)據(jù)同步接口,發(fā)送用戶授權(quán)指令,將用戶授權(quán)數(shù)據(jù)信息同步給軟件服務(wù)端平臺3、用戶使用軟件的時(shí)候,在客戶端選擇所在平臺(博云網(wǎng)) ,輸入賬號登錄,軟件服 務(wù)端收到客戶端登錄請求,調(diào)用我平臺的用戶鑒權(quán)接口,進(jìn)行用戶身份驗(yàn)證,如果返 回成功,則直接進(jìn)入軟件平臺內(nèi);如果返回失敗,提示用戶無權(quán)限使用。3.2. 接口工作內(nèi)容及步驟條件: 注冊成為博云網(wǎng)商家,激活賬號并發(fā)布了軟件產(chǎn)品3.2.1. B/S 結(jié)構(gòu)1、新增數(shù)據(jù)同步接口,實(shí)現(xiàn)數(shù)據(jù)
6、信息的同步接收及處理;2、去除現(xiàn)有軟件的登錄部分;3、新增軟件使用的跳轉(zhuǎn)地址,并開發(fā)反向用戶鑒權(quán)功能。3.2.2. C/S 結(jié)構(gòu)1、服務(wù)器端新增數(shù)據(jù)同步接口,實(shí)現(xiàn)數(shù)據(jù)信息的同步接收及處理;2、修改客戶端,增加平臺選項(xiàng),讓用戶選擇用戶來源;3、服務(wù)器端修改用戶登錄認(rèn)證,判斷如果選擇是博云網(wǎng)平臺的用戶,調(diào)用我平臺提供 的用戶鑒權(quán)接口,進(jìn)行用戶鑒權(quán)認(rèn)證。33接口的定義及開發(fā)331.接口實(shí)現(xiàn)形式目前數(shù)據(jù)同步和用戶鑒權(quán)接口均采用Http發(fā)送Post請求的方式傳遞數(shù)據(jù)軟件使用采用url跳轉(zhuǎn)的方式3.3.2. 接口消息格式. 請求消息請求消息是指調(diào)用接口的一方發(fā)出的消息,.1.
7、消息頭Versio n=1& code二0&tid二1&appid二2&requesttime二3&authcode=4所有接口的請求消息的消息頭格式相同,具體屬性說明見下表:名稱說明數(shù)據(jù)類型長度(字節(jié))Code操作碼Stri ng4TID序列號,唯一標(biāo)識一次業(yè)務(wù)動(dòng)作Stri ngAppID業(yè)務(wù)應(yīng)用標(biāo)識(標(biāo)識是哪個(gè) ISV應(yīng)用軟件,在錄 入資源的時(shí)候由平臺統(tǒng)一分配)Stri ngRequestTime請求時(shí)間,14位Stri ng14Version 版本號(保留字段)當(dāng)前值 :1Stri ng校驗(yàn)碼Stri ng32AuthCodeMD5(TID+Req
8、uestTime+ISV 密碼).2. 消息體每一個(gè)接口的請求消息的消息體的格式各不相同,具體請參見各接口的詳細(xì)消息 格式說明。3322 消息體加密處理消息體的原始數(shù)據(jù)為一段字符串,在消息傳輸時(shí),消息體需要加密后傳輸,即消 息的Body部分為加密后的字符串。消息加解密調(diào)用我平臺提供的加解密接口。3323返回消息返回消息是指接口被調(diào)用的一方返回的消息。成功返回:SUCCESS失敗返回:Err :錯(cuò)誤編碼(錯(cuò)誤編碼定義如下表)錯(cuò)誤編碼定義:CodeResultCodeResultMessage描述通用1001網(wǎng)絡(luò)傳輸錯(cuò)誤Post發(fā)送或接受數(shù)據(jù)失敗1002參數(shù)不完整無參數(shù)或參數(shù)個(gè)數(shù)不對
9、1003身份不合法無法獲取接口密碼接口校驗(yàn)及加解密1011參數(shù)不正確時(shí)間格式不對1012接口已失效接口已超時(shí)1013校驗(yàn)失敗校驗(yàn)碼不止確1014加密體加密失敗1015加密體解密失敗1016參數(shù)不完整Msg參數(shù)為空無加密體定制1021Sp數(shù)據(jù)處理錯(cuò)誤授權(quán)1031Sp數(shù)據(jù)處理錯(cuò)誤鑒權(quán)1041數(shù)據(jù)內(nèi)部錯(cuò)誤1042用戶不合法333.軟件接口定義333.1. 軟件授權(quán)接口用戶購買軟件,支付完成后,我平臺調(diào)用此接口將用戶定制數(shù)據(jù)信息同步給軟件平臺消息類型編碼1001請求消息消息格式Version=1 &code=0&tid=1&appid=2&requesttime=3&a
10、mp;authcode=4 &msg=加密消息體未加密的消息體格式optype=0subid=1subtype=2starttime=3en dtime=4user num=5userid=6user name=7staffname=8officeph on e=9mobileph on e=10address=11zipcode=12email=13每個(gè)參數(shù)一行,以換行符“rn ”分割,無先后順序名稱說明數(shù)據(jù)類型長度(字節(jié))OPType受理標(biāo)志:1:開通2:暫停3:恢復(fù)4:更新5:退訂 狀態(tài)2、3、5只用企業(yè)客戶ID和應(yīng)用(產(chǎn)品)ID字段Stri ng8SublD定制流水號Stri
11、ng50SubType定制類型(保留)默認(rèn)為 1Stri ng8StartTime開始時(shí)間(只對OPType:1,4有效)格式為:YYYYMMDDStri ng8En dTime結(jié)束時(shí)間(只對OPType:1,4有效)Stri ng8格式為:YYYYMMDDUsernum開通用戶數(shù)(只對OPType:1,4有效)Stri ng16Userid訂購人idStri ngUsern ame訂購人賬號Stri ngStaffname訂購人姓名Stri ngOfficeph one辦公電話Stri ngMobileph one手機(jī)Stri ngAddress地址Stri ngZipcode郵編Stri
12、ngEmail郵件地址Stri ngStri ng返回消息正確返回SUCCESS錯(cuò)誤返回Err:錯(cuò)誤編碼3332用戶授權(quán)購買用戶給其它操作用戶授權(quán),我平臺調(diào)用此接口將用戶授權(quán)數(shù)據(jù)信息同步給軟件平 臺消息類型編碼1002請求消息消息格式Version=1 &code=0&tid=1&appid=2&requesttime=3&authcode=4&msg=加密消息體未加密的消息體格式optype=0 subid=1 subtype=2 starttime=3 en dtime=4 userid=5user name=6staffname=7emai
13、l=8名稱說明數(shù)據(jù)類型長度(字節(jié))OPType操作類型:1:開通2:暫停3:恢復(fù)4:停用Stri ng8SublD定制流水號Stri ng50SubType定制類型(保留)默認(rèn)值 1Stri ng8StartTime開始時(shí)間(只對OPType:1,4格式為:YYYYMMDD有效)Stri ng8En dTime結(jié)束時(shí)間(只對 OPType:1,4有效)Stri ng8格式為:YYYYMMDDUserid使用人idStri ngUsern ame使用人賬號Stri ngStaffname使用人姓名Stri ngEmail郵件地址Stri ng返回消息正確返回SUCCESS錯(cuò)誤返回Err:錯(cuò)誤編碼
14、3333產(chǎn)品訪問鑒權(quán)接口用戶使用軟件的時(shí)候,軟件平臺調(diào)用此用戶鑒權(quán)接口,進(jìn)行用戶身份驗(yàn)證消息類型編碼1003請求消息消息格式sid=0&pid=1&uid=2&tid=3&sign=4名稱說明數(shù)據(jù)類型長度(字節(jié))Sid應(yīng)用提供商ID (網(wǎng)站注冊時(shí)獲得)Stri ng16Pid應(yīng)用(產(chǎn)品)ID (網(wǎng)站錄入產(chǎn)品時(shí)獲得)Stri ng16Uid用戶IDStri ng36Tid提交時(shí)間(格式:yyyyMMddHHmmss)Stri ng14Sign令牌 md5(tid+spkey)Stri ng32返回消息成功返回SUCCESS userid=0 usertype=1失
15、敗返回Err:錯(cuò)誤編碼B/S模式1、用戶在我平臺點(diǎn)擊使用軟件按鈕,跳轉(zhuǎn)鏈接至產(chǎn)品使用接口地址(例如:http:/*.*.*/sp_usesoft.aspx?sid=0&pid=1&uid=2&tid=3&sig n=4)2、 產(chǎn)品使用頁面 post 數(shù)據(jù) sid=0&pid=1&uid=2&tid=3&sign=4至9/ISV_Test/ISVInterface_useauc.ashx(測試地址,正式地址在正式接入時(shí)提供)3、根據(jù)返回結(jié)果直接跳轉(zhuǎn)至軟件使用C/S模式1、 客戶端登錄時(shí),服務(wù)器端
16、post 數(shù)據(jù) sid=0&pid=1&uid=2&tid=3&sig n=4至9/ISV_Test/ISVI nterface_useauc.ashx(測試地址,正式地址在正式接入時(shí)提供)2、根據(jù)返回結(jié)果返回給客戶端是否成功登錄3.4. 配置文件說明"/>< add key = "saasurl "value = "9/ISV_Test/ISVInterface_useauc.ashx用戶反向鑒權(quán)接口測試地址,正式地址接入時(shí)提供< add key = " encodeurl " value = " 9/ISV_Test/isvencode.ashx"/>數(shù)據(jù)傳輸加解密測試地址,正式地址接入時(shí)提供< add key = " domain " value = " 3/net
溫馨提示
- 1. 本站所有資源如無特殊說明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請下載最新的WinRAR軟件解壓。
- 2. 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請聯(lián)系上傳者。文件的所有權(quán)益歸上傳用戶所有。
- 3. 本站RAR壓縮包中若帶圖紙,網(wǎng)頁內(nèi)容里面會有圖紙預(yù)覽,若沒有圖紙預(yù)覽就沒有圖紙。
- 4. 未經(jīng)權(quán)益所有人同意不得將文件中的內(nèi)容挪作商業(yè)或盈利用途。
- 5. 人人文庫網(wǎng)僅提供信息存儲空間,僅對用戶上傳內(nèi)容的表現(xiàn)方式做保護(hù)處理,對用戶上傳分享的文檔內(nèi)容本身不做任何修改或編輯,并不能對任何下載內(nèi)容負(fù)責(zé)。
- 6. 下載文件中如有侵權(quán)或不適當(dāng)內(nèi)容,請與我們聯(lián)系,我們立即糾正。
- 7. 本站不保證下載資源的準(zhǔn)確性、安全性和完整性, 同時(shí)也不承擔(dān)用戶因使用這些下載資源對自己和他人造成任何形式的傷害或損失。
最新文檔
- 手工制瓷技藝2
- 二零二五年度國家級公路局養(yǎng)護(hù)技術(shù)服務(wù)專項(xiàng)合同書3篇
- 2024年上海市行政職業(yè)能力測驗(yàn)題庫(各地真題)
- 貴州航天職業(yè)技術(shù)學(xué)院《數(shù)據(jù)挖掘與R語》2023-2024學(xué)年第一學(xué)期期末試卷
- 專題06:寫作指導(dǎo)(考題練習(xí))(解析版)
- 二建市政工程實(shí)務(wù)-二建《市政公用工程管理與實(shí)務(wù)》押題密卷3358
- 有序參與社會治理自覺維護(hù)國家安全
- 2025年護(hù)士個(gè)人工作計(jì)劃范文
- 2025年年度健康教育工作計(jì)劃
- 2025護(hù)士個(gè)人年度工作計(jì)劃例文
- 對外投資合作國別(地區(qū))指南 -泰國
- 2023年-2024年崗位安全教育培訓(xùn)試題及答案通用
- 口腔修復(fù)學(xué)(全套課件290p)課件
- 小學(xué)生心理問題的表現(xiàn)及應(yīng)對措施【全國一等獎(jiǎng)】
- 小學(xué)生科普人工智能
- 初中學(xué)段勞動(dòng)任務(wù)清單(七到九年級)
- 退耕還林監(jiān)理規(guī)劃
- GB/T 1335.2-2008服裝號型女子
- GB 31247-2014電纜及光纜燃燒性能分級
- DCC20網(wǎng)絡(luò)型監(jiān)視與報(bào)警
- 項(xiàng)目實(shí)施路徑課件
評論
0/150
提交評論