ISV產(chǎn)品接入指南2（DOC33）

1、ISV產(chǎn)品接入指南目 錄TOC o 1-3 h z u HYPERLINK l _Toc267405230 1文檔目的 PAGEREF _Toc267405230 h 3 HYPERLINK l _Toc267405231 2ISV接入提交項 PAGEREF _Toc267405231 h 3 HYPERLINK l _Toc267405232 3接口開發(fā)與測試環(huán)境 PAGEREF _Toc267405232 h 3 HYPERLINK l _Toc267405233 4ISV接入工作內(nèi)容 PAGEREF _Toc267405233 h 4 HYPERLINK l _Toc267405234

2、5接口定義 PAGEREF _Toc267405234 h 5 HYPERLINK l _Toc267405235 5.1接口實現(xiàn)形式 PAGEREF _Toc267405235 h 5 HYPERLINK l _Toc267405236 5.2平臺提供給ISV的接口 PAGEREF _Toc267405236 h 5 HYPERLINK l _Toc267405237 5.2.1Web Service（參數(shù)為實體對象） PAGEREF _Toc267405237 h 5 HYPERLINK l _Toc267405238 5.2.2Web Service（參數(shù)為XML字符串） PAGEREF

3、 _Toc267405238 h 5 HYPERLINK l _Toc267405239 5.2.3Post方式 PAGEREF _Toc267405239 h 5 HYPERLINK l _Toc267405240 5.3ISV需要實現(xiàn)的接口定義 PAGEREF _Toc267405240 h 6 HYPERLINK l _Toc267405241 5.3.1實現(xiàn)方式1：Web Service（參數(shù)為實體對象） PAGEREF _Toc267405241 h 6 HYPERLINK l _Toc267405242 5.3.2實現(xiàn)方式2：Web Service（參數(shù)為XML字符串） PAGER

4、EF _Toc267405242 h 6 HYPERLINK l _Toc267405243 5.3.3實現(xiàn)方式3：Post方式 PAGEREF _Toc267405243 h 6 HYPERLINK l _Toc267405244 5.4ISV接口實現(xiàn)注意事項 PAGEREF _Toc267405244 h 6 HYPERLINK l _Toc267405245 5.5接口調(diào)用示例 PAGEREF _Toc267405245 h 7 HYPERLINK l _Toc267405246 5.5.1示例：Web Service（參數(shù)為實體對象） PAGEREF _Toc267405246 h 7

5、 HYPERLINK l _Toc267405247 5.5.2示例：Web Service（參數(shù)為XML字符串） PAGEREF _Toc267405247 h 8 HYPERLINK l _Toc267405248 5.5.3示例：Post方式 PAGEREF _Toc267405248 h 8 HYPERLINK l _Toc267405249 5.6接口消息格式 PAGEREF _Toc267405249 h 10 HYPERLINK l _Toc267405250 5.6.1請求消息 PAGEREF _Toc267405250 h 10 HYPERLINK l _Toc2674052

6、51 5.6.2返回消息 PAGEREF _Toc267405251 h 11 HYPERLINK l _Toc267405252 5.7消息體加密處理 PAGEREF _Toc267405252 h 13 HYPERLINK l _Toc267405253 5.8消息調(diào)用返回碼定義 PAGEREF _Toc267405253 h 13 HYPERLINK l _Toc267405254 6接口開發(fā)與產(chǎn)品改造指南 PAGEREF _Toc267405254 h 16 HYPERLINK l _Toc267405255 6.1接口實現(xiàn)過程步驟 PAGEREF _Toc267405255 h 16

7、 HYPERLINK l _Toc267405256 6.2配置文件 PAGEREF _Toc267405256 h 16 HYPERLINK l _Toc267405257 6.3接口實現(xiàn) PAGEREF _Toc267405257 h 17 HYPERLINK l _Toc267405258 6.3.1產(chǎn)品訂購 PAGEREF _Toc267405258 h 17 HYPERLINK l _Toc267405259 6.3.2用戶授權(quán) PAGEREF _Toc267405259 h 19 HYPERLINK l _Toc267405260 6.3.3健康檢查 PAGEREF _Toc267

8、405260 h 26 HYPERLINK l _Toc267405261 6.3.4產(chǎn)品登錄 PAGEREF _Toc267405261 h 28 HYPERLINK l _Toc267405262 6.3.5心跳保持 PAGEREF _Toc267405262 h 30 HYPERLINK l _Toc267405263 6.3.6數(shù)據(jù)同步 PAGEREF _Toc267405263 h 31 HYPERLINK l _Toc267405264 6.3.7客戶端登錄 PAGEREF _Toc267405264 h 31 HYPERLINK l _Toc267405265 7接口測試指南 P

9、AGEREF _Toc267405265 h 32 HYPERLINK l _Toc267405266 7.1測試準(zhǔn)備工作 PAGEREF _Toc267405266 h 32 HYPERLINK l _Toc267405267 7.1.1基本數(shù)據(jù)準(zhǔn)備 PAGEREF _Toc267405267 h 32 HYPERLINK l _Toc267405268 7.1.2基本數(shù)據(jù)檢查 PAGEREF _Toc267405268 h 32 HYPERLINK l _Toc267405269 7.2加解密算法測試 PAGEREF _Toc267405269 h 33 HYPERLINK l _Toc2

10、67405270 7.3開通企業(yè)客戶測試 PAGEREF _Toc267405270 h 33 HYPERLINK l _Toc267405271 7.4企業(yè)用戶授權(quán)測試 PAGEREF _Toc267405271 h 33 HYPERLINK l _Toc267405272 7.4.1集成授權(quán)測試1 PAGEREF _Toc267405272 h 33 HYPERLINK l _Toc267405273 7.4.2集成授權(quán)測試2 PAGEREF _Toc267405273 h 34 HYPERLINK l _Toc267405274 7.5產(chǎn)品登錄測試 PAGEREF _Toc2674052

11、74 h 34文檔目的本文檔用于于幫助IISV了了解其產(chǎn)產(chǎn)品接入入平臺時時需要進(jìn)進(jìn)行哪些些工作、如如何進(jìn)行行這些工工作、完完成后如如何進(jìn)行行測試等等，ISSV在開開始接入入工作前前，請詳詳細(xì)閱讀讀此文檔檔內(nèi)容。ISV接入入提交項項類型提交項重要程度描述文檔產(chǎn)品圖標(biāo)必需用戶訂購時時顯示的的產(chǎn)品圖圖標(biāo)產(chǎn)品介紹必需產(chǎn)品簡介，介介紹產(chǎn)品品的宣傳傳亮點、在在技術(shù)、功功能、應(yīng)應(yīng)用等方方面的特特點，以以及產(chǎn)品品能為用用戶在哪哪些方面面帶來價價值等用戶手冊必需詳細(xì)介紹產(chǎn)產(chǎn)品的管管理功能能與應(yīng)用用功能的的使用方方法，指指導(dǎo)企業(yè)業(yè)的管理理員與最最終用戶戶使用系系統(tǒng)安裝手冊必需系統(tǒng)的安裝裝部署說說明文檔檔，能讓讓平

12、臺維維護(hù)人員員參照此此文檔即即可自行行完成產(chǎn)產(chǎn)品部署署FAQ可選提供最終用用戶在使使用系統(tǒng)統(tǒng)中遇到到一些常常見的問問題時的的一般解解決方法法多媒體培訓(xùn)訓(xùn)材料可選Flashh、視頻頻或其它它形式的的多媒體體培訓(xùn)材材料程序系統(tǒng)程序必需產(chǎn)品可運行行程序與與數(shù)據(jù)庫庫等接口程序必需產(chǎn)品接口可可運行程程序產(chǎn)品接口訪訪問地址址必需產(chǎn)品接口部部署后的的訪問地地址，其其中的主主機(jī)名與與端口可可替換為為實際部部署環(huán)境境的主機(jī)機(jī)名與端端口產(chǎn)品系統(tǒng)訪訪問地址址必需產(chǎn)品部署后后的訪問問地址，其其中的主主機(jī)名與與端口可可替換為為實際部部署環(huán)境境的主機(jī)機(jī)名與端端口接口開發(fā)與與測試環(huán)環(huán)境資源描述 HYPERLINK 5:70

13、12 http:/2222.92.1177.855:70012沙箱環(huán)境平平臺登錄錄地址 HYPERLINK 5:7011/SaaS2ISVInterface.asmx http:/2222.92.1177.855:70011/SSaaSS2ISSVInnterrfacce.aasmxx沙箱環(huán)境平平臺Weeb SServvicee地址 HYPERLINK 5:7011/SaaS2ISVInterfaceURl.aspx http:/2222.92.1177.855:70011/SSaaSS2ISSVInnterrfacceURRl.aaspxx沙箱環(huán)境接接收Poost數(shù)數(shù)據(jù)地址址 HYPERLI

14、NK 5:7012/SSOLogin.aspx http:/2222.92.1177.855:70012/SSSOLLogiin.aaspxx沙箱環(huán)境平平臺單點點登錄地地址 HYPERLINK 5:7009 http:/2222.92.1177.855:70009提供示例程程序、加加解密算算法、接接口調(diào)用用日志查查看、SSDK等等輔助調(diào)調(diào)試資源源ISV接入入工作內(nèi)內(nèi)容ISV產(chǎn)品品改造平臺中維護(hù)護(hù)的數(shù)據(jù)據(jù)，ISSV產(chǎn)品品中不可可增加或或刪除，如如企業(yè)、用用戶。平臺中維護(hù)護(hù)的數(shù)據(jù)據(jù)，ISSV產(chǎn)品品中僅可可編輯平平臺中不不包含的的數(shù)據(jù)屬屬性的值值。去掉登錄頁頁面去掉注銷、退退出等功功能去掉修改密密碼

15、、修修改個人人信息等等功能平臺用戶的的ID為為GUIID，IISV需需實現(xiàn)此此ID與與其產(chǎn)品品中的用用戶身份份的對應(yīng)應(yīng)。提供體驗功功能，能能讓用戶戶點擊產(chǎn)產(chǎn)品體驗驗鏈接后后，以一一個默認(rèn)認(rèn)體驗帳帳號的身身份直接接進(jìn)入系系統(tǒng)，讓讓用戶簡簡單試用用。ISV接口口實現(xiàn)企業(yè)客戶業(yè)業(yè)務(wù)受理理接口：企業(yè)訂訂購時調(diào)調(diào)用，平平臺會傳傳送企業(yè)業(yè)的信息息給ISSV；企業(yè)客戶員員工業(yè)務(wù)務(wù)受理接接口：企企業(yè)建立立用戶時時調(diào)用，平平臺會傳傳送用戶戶信息給給ISVV；角色列表同同步（讀讀?。┙咏涌冢浩笃髽I(yè)給用用戶分配配權(quán)限時時調(diào)用，如如果產(chǎn)品品無角色色功能，可可不實現(xiàn)現(xiàn)。用戶角色權(quán)權(quán)限同步步（讀取?。┙涌诳冢浩髽I(yè)業(yè)給用戶

16、戶分配權(quán)權(quán)限時調(diào)調(diào)用，如如果產(chǎn)品品無角色色功能，可可不實現(xiàn)現(xiàn)。用戶角色權(quán)權(quán)限同步步（更新新）接口口：企業(yè)業(yè)給用戶戶分配權(quán)權(quán)限時調(diào)調(diào)用，如如果產(chǎn)品品無角色色功能，可可不實現(xiàn)現(xiàn)。接口定義接口實現(xiàn)形形式平臺與ISSV之間間的交互互接口的的實現(xiàn)有有三種形形式，具具體如下下：雙方提供WWeb Serrvicce供對對方調(diào)用用，參數(shù)數(shù)與返回回值使用用實體對對象（實實體類），較較適用于于.Neet平臺臺或Jaava平平臺。雙方提供WWeb Serrvicce供對對方調(diào)用用，參數(shù)數(shù)與返回回值使用用字符串串（XMML文本本），較較適用于于Javva平臺臺或其它它異構(gòu)平平臺。雙方提供接接收Poost數(shù)數(shù)據(jù)的頁頁面

17、，PPostt的數(shù)據(jù)據(jù)及返回回值均為為字符串串（XMML文本本），較較適用于于Javva平臺臺或其它它異構(gòu)平平臺如PPHP、AASP等等。平臺提供給給ISVV的接口口Web SServvicee（參數(shù)數(shù)為實體體對象）方法名稱SaaSIISVIInteerfaaceXXMLSStriing參數(shù)數(shù)據(jù)類類型RequeestIInfoo返回值數(shù)據(jù)據(jù)類型RespoonseeInffoWeb SServvicee（參數(shù)數(shù)為XMML字符符串）方法名稱SaaSIISVIInteerfaaceXXMLSStriing參數(shù)數(shù)據(jù)類類型Strinng返回值數(shù)據(jù)據(jù)類型StrinngPost方方式請求方法POST參數(shù)形式

18、Msg=xxml格格式的字字符串參數(shù)數(shù)據(jù)類類型Strinng返回值數(shù)據(jù)據(jù)類型StrinngISV需要要實現(xiàn)的的接口定定義ISV從接接口實現(xiàn)現(xiàn)的三種種方式中中，選擇擇一種適適合自己己平臺的的方式實實現(xiàn)給平平臺調(diào)用用的接口口。實現(xiàn)方式11：Weeb SServvicee（參數(shù)數(shù)為實體體對象）方法名稱ISVSaaaSIInteerfaace參數(shù)數(shù)據(jù)類類型RequeestIInfoo返回值數(shù)據(jù)據(jù)類型RespoonseeInffo實現(xiàn)方式22：Weeb SServvicee（參數(shù)數(shù)為XMML字符符串）方法名稱ISVSaaaSIInteerfaaceXXMLSStriing參數(shù)數(shù)據(jù)類類型Strinng返回

19、值數(shù)據(jù)據(jù)類型Strinng實現(xiàn)方式33：Poost方方式請求方法POST參數(shù)形式Msg=xxml格格式的字字符串參數(shù)數(shù)據(jù)類類型Strinng返回值數(shù)據(jù)據(jù)類型StrinngISV接口口實現(xiàn)注注意事項項Web SServvicee方法只只有一個個參數(shù)，通通過傳遞遞不同的的參數(shù)CCodee來指定定調(diào)用的的功能。namesspacce 必必須是： HYPERLINK http:/SaaSInterface.Sispark.M/ htttp:/SaaaSIInteerfaace.Sissparrk.MMm/，包包括最后后一個反反斜線。幾種實現(xiàn)方方式提供供的接口口方法的的功能一一樣，只只是參數(shù)數(shù)和返回回值

20、類型型不同。具具體的業(yè)業(yè)務(wù)功能能和返回回信息由由請求消消息頭的的操作碼碼（操作作碼）決決定，即即接口調(diào)調(diào)用只有有一個入入口。示示例如下下：publiic RessponnseIInfoo ISSVSaaaSIInteerfaace(ReqquesstInnfo reqq) ReespoonseeInffo rrespp = neww RessponnseIInfoo(); swwitcch (reqq.Heead.Codde) /企業(yè)業(yè)客戶業(yè)業(yè)務(wù)受理理接口 ccasee ISSV1001011: reesp = IISV1101001CoorpBBindd.ExxecuuteBBusiines

21、ss(rreq); reeturrn rrespp; /企業(yè)業(yè)客戶員員工業(yè)務(wù)務(wù)受理接接口 ccasee ISSV1001022: reesp = IISV1101002SttafffBinnd.EExeccuteeBussineess(reqq); reeturrn rrespp; /角色色列表同同步（讀讀取）接接口 ccasee ISSV1002011: reesp = IISV1102001PuullRRolees.EExeccuteeBussineess(reqq); reeturrn rrespp; /用戶戶角色權(quán)權(quán)限同步步（讀取?。┙涌诳?ccasee ISSV1002022: re

22、esp = IISV1102002PuullUUserrRolle.EExeccuteeBussineess(reqq); reeturrn rrespp; /用戶戶角色權(quán)權(quán)限同步步（更新新）接口口 ccasee ISSV1002033: reesp = IISV1102003SyyncUUserrRolle.EExeccuteeBussineess(reqq); reeturrn rrespp; /未知知接口，非非法調(diào)用用 ddefaaultt: reeturrn nulll; 接口調(diào)用示示例示例：Weeb SServvicee（參數(shù)數(shù)為實體體對象） /構(gòu)造RRequuesttInffo對象

23、象并賦值值 ReequeestIInfoo reequeest = nnew ReqquesstInnfo(); ReequeestHHeaddInffo rreqHHeadd = neww ReequeestHHeaddInffo(); reeqHeead.SubbmittTimme = 22008807009099443337779; reeqHeead.ApppID = PROO2000805527000055; reeqHeead.Codde = IISV1101001; reeqHeead.CTIID = 2200880700900000000555; reeqHeead.Priio

24、riity = 10; reeqHeead.Verrsioon = 11; reequeest.Heaad = reeqHeead; sttrinng bbodyy = 1變更原原因; /加密BBodyy并賦值值，“AABCDD12334”為為密鑰 reequeest.Boddy = CrrptoograaphyyHellperr.CoomEnncryypt(boddy, ABBCD112344); /實例化化Webb Seerviice ISSV2SSaaSSIntterffacee serrvicce = neew ISVV2SaaaSIInteerfaace(); /調(diào)用WWeb Ser

25、rvicce ReespoonseeInffo rrespponsse = seerviice.ISVVSaaaSInnterrfacce(rrequuestt); /解密RRespponsseInnfo的的Boddy，還還原為XXML sttrinng bbodyyXmll = CrpptoggrapphyHHelpper.CommDeccryppt(rrespponsse.BBodyy, ABCCD12234);示例：Weeb SServvicee（參數(shù)數(shù)為XMML字符符串） /構(gòu)造BBodyy的XMML字符符串 sttrinng bbodyyXMLL = 1開通; /加密BBodyy的X

26、MML字符符串，“AABCDD12334”為為密鑰 sttrinng bbodyy = CrpptoggrapphyHHelpper.CommEnccryppt(bbodyyXMLL, ABCCD12234); /構(gòu)造請請求消息息XMLL字符串串 sttrinng rrequuesttXMLL = ISSV1001011200080070990000000055PRRO20008006100000012000807709009444337779110 + boddy + ; /實例化化Webb Seerviice ISSV2SSaaSSIntterffacee serrvicce = neew

27、 ISVV2SaaaSIInteerfaace(); /調(diào)用WWeb Serrvicce sttrinng rrespponsseXMML = seerviice.ISVVSaaaSInnterrfacceXMMLSttrinng(rrequuesttXMLL); /取出BBodyy值 XmmlDoocummentt xmmlDooc = neew XmllDoccumeent(); xmmlDooc.LLoaddXmll(reespoonseeXMLL); XmmlNoode rooot = xmmlDooc.DDocuumenntEllemeent; sttrinng rrespponss

28、eBoody = rroott.SeelecctSiinglleNoode(Boody).IInneerTeext; /解密BBodyy，還原原為XMML sttrinng bbodyyXmll = CrpptoggrapphyHHelpper.CommDeccryppt(rrespponsseBoody, AABCDD12334);示例：Poost方方式 / / Poost方方式請求求Urll,返回回ressponnse字字符串 / / 數(shù)數(shù)據(jù)流 / Urrl地址址 / 返回數(shù)數(shù)據(jù) priivatte staaticc strringg UrrlPoost(strringg poostDDa

29、taa,sttrinng pposttUrll) trry HHttppWebbReqquesst RRequuesttObjjectt = WebbReqquesst.CCreaate(posstUrrl) as HtttpWeebReequeest; / 設(shè)設(shè)定Coookiie RRequuesttObjjectt.CoookiieCoontaaineer = neew CoookieeConntaiinerr(); RRequuesttObjjectt.Crredeentiialss = CreedenntiaalCaachee.DeefauultCCreddenttialls; /Re

30、equeestOObjeect.Prooxy = tthiss._wwebPProxxy; / 設(shè)設(shè)定請求求頭。 RRequuesttObjjectt.PrrotoocollVerrsioon = neew Verrsioon(11, 00); RRequuesttObjjectt.KeeepAAlivve = trrue; RRequuesttObjjectt.PrreAuutheentiicatte = faalsee; RRequuesttObjjectt.Accceppt = */*; /ReequeestOObjeect.Reffereer = poostUUrl; RRequues

31、ttObjjectt.Heeadeers.Addd(AAcceept-Lannguaage, uutf-8); RRequuesttObjjectt.UnnsaffeAuutheentiicattedCConnnecttionnShaarinng = trrue; /ReequeestOObjeect.UseerAggentt = SMMPClliennt; RRequuesttObjjectt.Meethood = PPOSTT; RRequuesttObjjectt.CoonteentTTypee = apppliicattionn/x-wwww-foorm-urllenccodeed;

32、RRequuesttObjjectt.AlllowwAuttoReedirrectt = truue; / PPostt數(shù)據(jù) bbytee posstBuuffeer = Enncoddingg.UTTF8.GettByttes(Mssg= + HtttpUttiliity.UrllEnccodee(poostDDataa); RRequuesttObjjectt.CoonteentLLenggth = pposttBuffferr.Leengtth; uusinng (Sysstemm.IOO.Sttreaam pposttStrreamm = ReqquesstObbjecct.GGetR

33、RequuesttStrreamm() posstSttreaam.WWritte(pposttBuffferr, 00, pposttBuffferr.Leengtth); posstSttreaam.CClosse(); /網(wǎng)絡(luò)絡(luò)響應(yīng)對對象 HHttppWebbRessponnse ressp = ReequeestOObjeect.GettRessponnse() aas HtttpWeebReespoonsee; SSysttem.IO.Strreamm reespSStreeam = rrespp.GeetReespoonseeStrreamm(); /獲取取返回數(shù)數(shù)據(jù)保護(hù)護(hù)包 SS

34、ysttem.IO.StrreammReaaderr sttreaamReead = nnew Sysstemm.IOO.SttreaamReeadeer(rresppStrreamm, EEncoodinng.DDefaaultt); SStriingBBuillderr sttrReet = neew StrringgBuiildeer(); sstrRRet.Apppendd(sttreaamReead.ReaadTooEndd(); rresppStrreamm.Cllosee(); rrespp.Cllosee(); rretuurn strrRett.TooStrringg();

35、caatchh (Exxcepptioon eex) tthroow neww Exccepttionn(URRL方式式調(diào)用錯錯誤. + ex.Messsagge, ex); /reeturrn eex.MMesssagee; 接收方示例例： prootecctedd voiid PPagee_Looad(objjectt seendeer, EveentAArgss e) sttrinng mmsg = RRequuesttMMsg;/對請求求消息mmsg進(jìn)進(jìn)行解析析并做業(yè)業(yè)務(wù)處理理，生成成返回消消息。 Reespoonsee.Cllearr(); Reespoonsee.Wrritee(S

36、YSS103301200080331500000000223 + PROO2000805527000055220088040091661900775500 + 11.0100 + 300); 接口消息格格式請求消息請求消息是是指調(diào)用用接口的的一方發(fā)發(fā)出的消消息，即即Webb Seerviice方方法的傳傳入?yún)?shù)數(shù)。 ISVV101101 200080770900000000555 PROO2000805527000055 2000807709009444337779 1 10 id99#F999044sfLLO(%)$DSSKLDDOFEEKRXXBFSSDF#$LLCL_+$LXVV:SSF

37、LOOW(#$DDVS消息頭所有接口的的請求消消息的消消息頭格格式相同同，具體體屬性說說明見下下表：名稱說明數(shù)據(jù)類型長度（字節(jié)節(jié)）Code操作碼Strinng8CTID客戶端交易易序列號號（在發(fā)起起方唯一一標(biāo)識一一個交易易的流水水號，客客戶系統(tǒng)統(tǒng)內(nèi)166位唯一一標(biāo)示號號）組成方式：8位日日期88位唯一一數(shù)，每每天從00000000001開始始，如220088031550000000001Strinng16AppIDD業(yè)務(wù)應(yīng)用標(biāo)標(biāo)識（標(biāo)標(biāo)識是哪哪個ISSV應(yīng)用用系統(tǒng)，由平臺統(tǒng)一分配）Strinng8SubmiitTiime提交時間，格式為為：YYYYMMMDDDHHmmmsssffffStrin

38、ng17Versiion版本號（保保留字段段）當(dāng)前值: 1Strinng10Priorrityy優(yōu)先級（保保留字段段）當(dāng)前值: 10Int3消息體每一個接口口的請求求消息的的消息體體的格式式各不相相同，具具體請參參見各接接口的詳詳細(xì)消息息格式說說明。返回消息請求消息是是指接口口被調(diào)用用的一方方返回的的消息，即即Webb Seerviice方方法的返返回值。 ISVV101101 200080770900000000555 200080770900000019887 PROO2000805527000055 2000807709009444337779 1 10 0 id99#F999044sf

39、LLO(%)$DSSKLDDOFEEKRXXBFSSDF#$LLCL_+$LXVV:SSFLOOW(#$DDVS消息頭所有接口的的返回消消息的消消息頭格格式相同同，具體體屬性說說明見下下表：名稱說明數(shù)據(jù)類型長度（字節(jié)節(jié)）Code操作碼Strinng8CTID客戶端交易易序列號號（在發(fā)起起方唯一一標(biāo)識一一個交易易的流水水號，客客戶系統(tǒng)統(tǒng)內(nèi)166位唯一一標(biāo)示號號）組成方式：8位日日期88位唯一一數(shù)，每每天從00000000001開始始，如220088031550000000001Strinng16STID服務(wù)端交易易序列號號（在接受受方唯一一標(biāo)識一一個交易易的流水水號，平平臺系統(tǒng)統(tǒng)內(nèi)唯一一20位位

40、唯一流流水）組成方式：ApppID + “_” + 8位日日期88位唯一一數(shù)，每每天從00000000001開始始，如11001120008031550000000001Strinng25AppIDD業(yè)務(wù)應(yīng)用標(biāo)標(biāo)識（標(biāo)標(biāo)識是哪哪個ISSV應(yīng)用用系統(tǒng)，由平臺統(tǒng)一分配）Strinng16RequeestTTimee請求接受時時間，格式為為：YYYYMMMDDDHHmmmsssffffStrinng17RespoonseeTimme響應(yīng)處理時時間，格式為為：YYYYMMMDDDHHmmmsssffffStrinng17Versiion版本號（保保留字段段）當(dāng)前值：11Strinng10Priorri

41、tyy優(yōu)先級（保保留字段段）當(dāng)前值：110(能轉(zhuǎn)換為為intt的串)Strinng16Statuus返回結(jié)果狀狀態(tài)(能轉(zhuǎn)換為為intt的串)(0: 正正常；-1: 系統(tǒng)調(diào)調(diào)用異常常)Strinng16消息體每一個接口口的返回回消息的的消息體體的格式式各不相相同，具具體請參參見各接接口的詳詳細(xì)消息息格式說說明。消息體加密密處理消息體的原原始數(shù)據(jù)據(jù)為一段段XMLL字符串串，如：1變更原原因PPRO220088052270000529200080070990000000000002000901109000000000000，在消息息傳輸時時，消息息體需要要加密后后傳輸，即即消息的的Boddy部分分為

42、加密密后的字字符串。無無論是請請求消息息還是返返回消息息的消息息體都需需經(jīng)過加加密處理理，具體體加密算算法為：Basse644(DEES(MMD5(消息體體) + 消息息體)消息調(diào)用返返回碼定定義CodeResulltCoodeResulltMeessaage描述所有消息0成功正常返回1對未定義錯錯誤的描描述未定義錯誤誤101數(shù)據(jù)非法加加密ISV應(yīng)用用系統(tǒng)私私鑰與SSaaSS中的私私鑰不一一致102非法的XMML格式式消息格式與與本規(guī)范范中定義義的不一一致SSO鑒權(quán)權(quán)消息1101001011獲取登錄信信息異常常在獲取當(dāng)前前登錄用用戶信息息時出錯錯110100102用戶Tokken不不存在用戶T

43、okken不不存在，需需要重新新登錄110100103用戶Tokken 已失效效用戶Tokken過過期，需需要重新新登錄1101001044用戶Tokken非非法用戶Tokken非非法，需需要重新新登錄1101001055用戶登錄未未知系統(tǒng)統(tǒng)SaaS對對用戶登登錄的系系統(tǒng)未知知1101001066其他錯誤1101001*編碼定定義鑒權(quán)權(quán)消息其其他錯誤誤SSO心跳跳消息1101002022用戶Tokken已已失效用戶Tokken過過期，需需要重新新登錄1101002033用戶Tokken不不存在用戶Tokken不不存在，需需要重新新登錄1101001044用戶Tokken非非法用戶Tokken非

44、非法，需需要重新新登錄110100205獲取用戶登登錄信息息信息出出錯在獲取當(dāng)前前登錄用用戶信息息時出錯錯110100206更新令牌錯錯誤更新令牌錯錯誤客戶端登錄錄接口消息息1102001011 用戶名或或密碼出出錯用戶名或密密碼出錯錯1102001033其他錯誤1102001*編碼定定義產(chǎn)品品訪問鑒鑒權(quán)消息息其他錯錯誤產(chǎn)品訪問鑒鑒權(quán)消息息1102002011用戶Tokken已已失效用戶Tokken過過期，需需要重新新登錄1102002022用戶Tokken不不存在用戶Tokken不不存在，需需要重新新登錄1102002033用戶Tokken非非法用戶Tokken非非法，需需要重新新登錄110

45、2002044獲取用戶登登錄信息息信息出出錯獲取用戶登登錄信息息信息出出錯1102002055判斷邏輯錯錯誤判斷訂購關(guān)關(guān)系業(yè)務(wù)務(wù)邏輯錯錯誤企業(yè)信息接接口1103001011取得用戶信信息錯誤誤獲取企業(yè)管管理員信信息出錯錯1103001022未獲得企業(yè)業(yè)信息返回信息為為空1103001033獲取企業(yè)信信息異常常獲取企業(yè)信信息發(fā)生生業(yè)務(wù)錯錯誤企業(yè)員工信信息接口口1103002011非法的UsserIIDsUserIIDs為為空1103002022獲取用戶信信息錯誤誤獲取用戶信信息錯誤誤計費消息1104001011數(shù)據(jù)非法加加密 ISV應(yīng)用用系統(tǒng)私私鑰與SSaaSS中的私私鑰不一一致11040010

46、22用戶Tokken已已失效用戶Tokken過過期，需需要重新新登錄110400103用戶Tokken不不存在用戶Tokken不不存在，需需要重新新登錄1101001044用戶Tokken非非法用戶Tokken非非法，需需要重新新登錄1104001055用戶訂購關(guān)關(guān)系不存存在用戶沒有權(quán)權(quán)限使用用該功能能1104001066未知業(yè)務(wù)資資費信息息SaaS管管理平臺臺未設(shè)置置該業(yè)務(wù)務(wù)的計費費策略1104001077其他錯誤3*編碼碼定義批批價消息息其他錯錯誤企業(yè)客戶業(yè)業(yè)務(wù)受理理消息2101001011業(yè)務(wù)配置參參數(shù)錯誤誤業(yè)務(wù)訂購配配置不符符合ISSV應(yīng)用用系統(tǒng)的的約定210100102業(yè)務(wù)功能點點訂

47、購錯錯誤訂購的功能能點與IISV應(yīng)應(yīng)用系統(tǒng)統(tǒng)提供的的不一致致210100103Licennse數(shù)數(shù)量錯誤誤Licennse可可能不是是非負(fù)的的整數(shù)210100104未知操作類類型ISV應(yīng)用用系統(tǒng)無無法識別別操作類類型（訂訂購、取取消、暫暫停、恢恢復(fù)）210100105其他錯誤4*編碼碼定義該該類消息息其他錯錯誤企業(yè)客戶員員工業(yè)務(wù)務(wù)受理消消息2101002011未知企業(yè)客客戶帳號號企業(yè)客戶帳帳號在IISV應(yīng)應(yīng)用系統(tǒng)統(tǒng)中不存存在2101002022用戶手機(jī)號號碼非法法用戶手機(jī)號號碼錯誤誤2101002033其他錯誤5*編碼碼定義該該類消息息其他錯錯誤接口開發(fā)與與產(chǎn)品改改造指南南接口實現(xiàn)過過程步驟驟

48、序號工作內(nèi)容1聯(lián)系平臺管管理員，在在平臺中中錄入IISV和和產(chǎn)品信信息，獲獲取ISSVIDD、ApppIDD、密鑰鑰2建立配置文文件，填填入平臺臺管理員員提供的的ISVVID、AAppIID、密密鑰、平平臺接口口地址、平平臺單點點登錄地地址3建立Webb Seerviice并并聲明好好方法，發(fā)發(fā)布在外外網(wǎng)，然然后將WWeb Serrvicce的地地址和產(chǎn)產(chǎn)品地址址發(fā)給平平臺管理理員，在在平臺的的產(chǎn)品信信息中錄錄入。4 HYPERLINK l _產(chǎn)品訂購 實現(xiàn)產(chǎn)品訂訂購功能能5 HYPERLINK l _開通企業(yè)客戶測試 測試產(chǎn)品訂訂購功能能6 HYPERLINK l _用戶授權(quán) 實現(xiàn)用戶授授權(quán)

49、功能能7 HYPERLINK l _企業(yè)用戶授權(quán)測試 測試用戶授授權(quán)功能能8 HYPERLINK l _產(chǎn)品登錄 實現(xiàn)產(chǎn)品登登錄功能能9 HYPERLINK l _產(chǎn)品登錄測試 測試產(chǎn)品登登錄功能能10 HYPERLINK l _心跳保持 實現(xiàn)心跳保保持功能能11 HYPERLINK l _SSO心跳測試 測試心跳保保持功能能配置文件ISV需提提供一個個配置文文件，其其中包括括以下可可修改的的配置參參數(shù)：參數(shù)值Web SServvicee接口地地址(或或Posst數(shù)據(jù)據(jù)的頁面面地址)正式環(huán)境的的平臺接接口地址址ISVIDDISV在平平臺中的的唯一標(biāo)標(biāo)識碼AppIDDISV的某某一產(chǎn)品品在平臺臺

50、中的唯唯一標(biāo)識識碼加解密密鑰鑰ISV分配配的加解解密密鑰鑰平臺單點登登錄頁面面正式環(huán)境的的平臺單單點登錄錄頁面.Net應(yīng)應(yīng)用的WWeb.connfigg文件中中添加配配置信息息示例，其其它平臺臺類似： 接口實現(xiàn)產(chǎn)品訂購應(yīng)用場景企業(yè)客戶業(yè)業(yè)務(wù)受理理接口（IISV實實現(xiàn)，平平臺調(diào)用用）企業(yè)客戶業(yè)業(yè)務(wù)受理理接口由由ISVV提供給給平臺調(diào)調(diào)用，平平臺向IISV輸輸入待增增加的企企業(yè)客戶戶，ISSV給企企業(yè)客戶戶創(chuàng)建一一個新的的實例，并并配置數(shù)數(shù)據(jù)庫等等相關(guān)資資源。注注意事項項如下：ISV給企企業(yè)創(chuàng)建建實例時時如果需需要特殊殊的參數(shù)數(shù)，則需需事先整整理出來來，交給給平臺管管理員維維護(hù)。這這樣用戶戶在訂購

51、購的時候候就可以以輸入這這些參數(shù)數(shù)的值，然然后平臺臺會將這這些參數(shù)數(shù)值傳遞遞給ISSV的WWeb Serrvicce，IISV再再根據(jù)這這些參數(shù)數(shù)值給企企業(yè)開通通服務(wù)。如果ISVV的產(chǎn)品品需要根根據(jù)模塊塊收費，則則需要將將模塊信信息整理理并提交交給平臺臺管理員員。這樣樣用戶在在訂購的的時候就就可以選選擇需要要的模塊塊。然后后平臺會會將模塊塊信息傳傳遞給IISV的的Webb Seerviice。企業(yè)可以多多次訂購購一個產(chǎn)產(chǎn)品，例例如初次次訂購和和續(xù)訂，IISV產(chǎn)產(chǎn)品需要要做相應(yīng)應(yīng)處理，續(xù)續(xù)訂時，注注意新的的時間區(qū)區(qū)間的記記錄和處處理。消息類型編編碼ISV1001011請求消息消息格式Reeque

52、est通通用消息息頭加密后后的消息息體未加密的消消息體格格式綁定標(biāo)標(biāo)志綁定說說明應(yīng)應(yīng)用（產(chǎn)產(chǎn)品）IID企業(yè)客客戶IDD企企業(yè)客戶戶名稱企業(yè)客客戶簡稱稱企業(yè)客客戶英文文名稱企業(yè)客客戶英文文簡稱企業(yè)業(yè)FQDDN企企業(yè)營業(yè)業(yè)執(zhí)照號號 企業(yè)法法人企業(yè)管管理員GGUIDD企業(yè)管管理員聯(lián)聯(lián)系電話話企業(yè)管管理員聯(lián)聯(lián)系手機(jī)機(jī)企業(yè)管管理員聯(lián)聯(lián)系郵件件企業(yè)業(yè)地址企企業(yè)郵寄寄地址 郵編編企企業(yè)電話話傳真號號碼郵箱地地址企業(yè)業(yè)WEBB網(wǎng)址企業(yè)LoogoUURL 變更時時間業(yè)務(wù)配配置參數(shù)數(shù)代碼業(yè)務(wù)配配置參數(shù)數(shù)值模塊塊1,模模塊2,開始時時間結(jié)束束時間名稱說明數(shù)據(jù)類型長度（字節(jié)節(jié)）OPTyppe受理標(biāo)志:1 : 開通通2

53、 : 暫停停3 : 恢復(fù)復(fù)4 : 更新新5 : 退訂訂狀態(tài)22、3、55只用企企業(yè)客戶戶ID和和應(yīng)用（產(chǎn)產(chǎn)品）IID字段段Strinng8OPNotte綁定說明，例例如：業(yè)業(yè)務(wù)變更更原因Strinng256AppIDD應(yīng)用（產(chǎn)品品）IDDStrinng16CorpIInfoo企業(yè)客戶的的企業(yè)信信息Strinng16ParammNamme業(yè)務(wù)訂購配配置參數(shù)數(shù)名Strinng64ParammVallue業(yè)務(wù)訂購配配置參數(shù)數(shù)值Strinng256ModulleLiist訂購模塊列列表（以以逗號分分割）StrinngStarttTimme開始時間（只只對OPPTyppe: 1,44有效）格式為：YYY

54、YYYMMDDDHHHmmsssffffStrinng17EndTiime結(jié)束時間（只只對OPPTyppe: 1,44有效）格式為：YYYYYYMMDDDHHHmmsssffffStrinng17返回消息消息格式Reespoonsee通用消消息頭加密后后的消息息體未加密的消消息體格格式返回回結(jié)果代代碼返回回結(jié)果描描述名稱說明數(shù)據(jù)類型長度（字節(jié)節(jié)）ResulltCoode返回結(jié)果代代碼（00:成功功；1:失?。㏒trinng16ResulltDeesc返回結(jié)果文文字描述述Strinng256用戶授權(quán)用戶集成授授權(quán)需要要ISVV實現(xiàn)44個接口口，包括括企業(yè)客客戶員工工業(yè)務(wù)受受理接口口，及權(quán)權(quán)限角色

55、色相關(guān)的的三個接接口：企業(yè)客戶員員工業(yè)務(wù)務(wù)受理接接口：目目前必須須實現(xiàn)開開通(代代碼為11)和停停用(代代碼為44)兩種種情況。角色列表同同步（讀讀取）接接口，如如果產(chǎn)品品無角色色功能，可可不實現(xiàn)現(xiàn)。用戶角色權(quán)權(quán)限同步步（讀取取）接口口，如果果產(chǎn)品無無角色功功能，可可不實現(xiàn)現(xiàn)。用戶角色權(quán)權(quán)限同步步（更新新）接口口，如果果產(chǎn)品無無角色功功能，可可不實現(xiàn)現(xiàn)。應(yīng)用場景角色列表同同步（讀讀?。┙咏涌冢↖ISV實實現(xiàn)，平平臺調(diào)用用）返回ISVV產(chǎn)品中中所有角角色的列列表。消息類型編編碼ISV1002011請求消息消息格式Reequeest通通用消息息頭加密后后的消息息體未加密的消消息體格格式應(yīng)用提提供商

56、IID應(yīng)應(yīng)用（產(chǎn)產(chǎn)品）IID企業(yè)客客戶IDD名稱說明數(shù)據(jù)類型長度（字節(jié)節(jié)）ISVIDD應(yīng)用提供商商IDStrinng16AppIDD應(yīng)用（產(chǎn)品品）IDDStrinng16CorpIID企業(yè)客戶IIDStrinng16返回消息消息格式Reespoonsee通用消消息頭加密后后的消息息體未加密的消消息體格格式返回回結(jié)果代代碼返回回結(jié)果描描述應(yīng)用提提供商IID應(yīng)應(yīng)用（產(chǎn)產(chǎn)品）IID企業(yè)客客戶IDD角色I(xiàn)ID角角色名角角色描述述名稱說明數(shù)據(jù)類型長度（字節(jié)節(jié)）ResulltCoode返回結(jié)果代代碼(00: 成成功；11: 失失敗)Strinng16ResulltDeesc返回結(jié)果描描述Strinng25

57、6ISVIDD應(yīng)用提供商商IDStrinng16AppIDD應(yīng)用（產(chǎn)品品）IDDStrinng16CorpIID企業(yè)客戶IIDStrinng16RoleLListt角色列表RoleIInfoo角色信息RoleIID角色I(xiàn)D(ISVV系統(tǒng)內(nèi)內(nèi)部角色色I(xiàn)D)Strinng16RoleNNamee角色名Strinng64RoleDDescc角色描述Strinng256用戶角色權(quán)權(quán)限同步步（讀取?。┙涌诳冢↖SSV實現(xiàn)現(xiàn)，平臺臺調(diào)用）返回當(dāng)前要要授權(quán)的的用戶在在ISVV的產(chǎn)品品中具有有權(quán)限的的角色列列表。消息類型編編碼ISV1002022請求消息消息格式Reequeest通通用消息息頭加密后后的消息息

58、體未加密的消消息體格格式應(yīng)用提提供商IID應(yīng)應(yīng)用（產(chǎn)產(chǎn)品）IID企業(yè)客客戶IDD 用戶IID名稱說明數(shù)據(jù)類型長度（字節(jié)節(jié)）ISVIDD應(yīng)用提供商商IDStrinng16AppIDD應(yīng)用（產(chǎn)品品）IDDStrinng16CorpIID企業(yè)客戶IIDStrinng16UserIID用戶ID(可轉(zhuǎn)換換為Guuid的的串)Strinng36返回消息消息格式Reespoonsee通用消消息頭加密后后的消息息體未加密的消消息體格格式返回回結(jié)果代代碼返回回結(jié)果描描述應(yīng)用提提供商IID應(yīng)應(yīng)用（產(chǎn)產(chǎn)品）IID企業(yè)客客戶IDD用戶IID角色I(xiàn)ID名稱說明數(shù)據(jù)類型長度（字節(jié)節(jié)）ResulltCoode返回結(jié)果代代碼

59、(00: 成成功；11: 失失敗)Strinng16ResulltDeesc返回結(jié)果描描述Strinng256ISVIDD應(yīng)用提供商商IDStrinng16AppIDD應(yīng)用（產(chǎn)品品）IDDStrinng16CorpIID企業(yè)客戶IIDStrinng16UserIID用戶IDStrinng36RoleLListt角色列表RoleIID角色I(xiàn)D(ISVV系統(tǒng)內(nèi)內(nèi)部角色色I(xiàn)D)Strinng64企業(yè)客戶員員工業(yè)務(wù)務(wù)受理接接口（IISV實實現(xiàn)，平平臺調(diào)用用）企業(yè)客戶員員工業(yè)務(wù)務(wù)受理接接口由IISV提提供給平平臺調(diào)用用，平臺臺向ISSV輸入入待增加加的企業(yè)業(yè)用戶（員員工），IISV同同步用戶戶信息，并并

60、保存授授權(quán)信息息。消息類型編編碼ISV1001022請求消息消息格式Reequeest通通用消息息頭加密后后的消息息體未加密的消消息體格格式綁定標(biāo)標(biāo)志綁定說說明應(yīng)應(yīng)用（產(chǎn)產(chǎn)品）IID企業(yè)客客戶IDD用戶IDD用用戶類型型用戶名名稱別名性別用用戶登錄錄名用戶AAD 帳帳號用戶戶SAMM帳戶郵箱地地址聯(lián)系地地址HHomeeAdddresss身份證證出生日日期部門IDD 職職務(wù)辦公電電話移動電電話變更時時間開始始時間結(jié)束束時間名稱說明數(shù)據(jù)類型長度（字節(jié)節(jié)）OPTyppe操作類型：1:開開通2:暫停3:恢復(fù)4 : 停用Strinng8OPNotte綁定說明，例如：業(yè)務(wù)變變更原因因等。Strinng25