WO+分享平臺中心對外接入技術方案v133

廣東聯通互動營銷平臺（wo+分享）對外接入技術方案拓維信息2013年05月

目錄1 文檔說明 32 接入系統(tǒng)說明 32.1 驗證中心 42.2 開放功能說明 43 使用場景及流程說明 43.1 場景一：嵌入wo+分享定制化的用戶中心 43.2 場景二：使用17wo分享功能 63.3 場景三：第三方合作平臺手機用戶與wo+分享賬戶綁定 74 接口協(xié)議說明 85 接口列表 95.1 第三方網站用戶登錄接口 95.2 第三方微薄登錄接口 95.3 第三方微薄分享接口 105.4 獲取驗證ID接口 105.5 賬戶綁定接口 105.6 結果碼說明 11

文檔說明 該文檔主要在以下幾種情況中使用第三方合作平臺用戶與wo+分享用戶實現單點登錄使用；第三方合作平臺使用wo+分享分享功能；為客戶端或網站類產品嵌入wo+分享定制化的用戶中心或其它功能頁面技術對接中使用；接入系統(tǒng)說明

驗證中心WO+驗證中心是實現WO+第三方用戶驗證和單點登錄的平臺，目的在于：引入第三方平臺的用戶；允許用戶將第三方平臺的賬號通過手機號碼綁定到WO+賬號；合并不同平臺之間的賬戶信息，以方便使用統(tǒng)一的賬戶來消費積分、沃幣、流量等；為用戶生成唯一驗證中心ID，用于WO+單點登錄。實現用戶新浪賬號，騰訊賬號的授權開放功能說明定制化用戶中心：為每個第三方合作方法平臺提供一個定制化的用戶中心，滿足對不同的平臺風格和內容的需要。開放用戶賬戶：為接入wo+分享平臺的第三方合作平臺用戶，新建賬戶加虛擬和實體獎品。分享功能：提供微薄分享和短信分享功能。內容訪問：為第三合作平臺定制化內容訪問頁面。使用場景及流程說明場景一：嵌入wo+分享定制化的用戶中心說明：為第三方合作的產品（客戶端或網站）提供定制化的用戶中心頁面。流程介紹流程說明：用戶發(fā)起登錄請求用戶在第三方合作平臺登錄成功后，重定向訪問驗證中心【第三方網站用戶登錄接口】，獲取到用戶會話ID（jssesionid）用戶終端請驗證中心【第三方網站用戶登錄接口】驗證中心處理成功后，將發(fā)起重定向操作。驗證中心將用戶登錄成功后的會話（jsessionid）參數追加到重定向地址后。第三方合作平臺可以通過httpget方式獲取。用戶終端收到重定向后的地址進行訪問。重定向地址是第三方合作平臺的登錄成功頁地址。用戶終端發(fā)起訪問用戶中心請求，該請求地址是第三合作平臺的代理地址。第三方平臺代理收到訪問請求，將帶上用戶的會話ID（jsessionid）。重定向到wo+分享用戶中心。場景二：使用wo+分享功能說明：第三方合作產品（客戶端或網站）使用wo+分享分享功能。流程介紹流程說明：用戶終端發(fā)起微薄登錄頁面訪問請求。第三方接入平臺收到用戶終端請求，將重定向到驗證中心的【第三方微薄登錄接口】用戶終端收到重定向過來的地址，調用取接口驗證中心登錄成功后，重定向第三方平臺提供的登錄成功頁面，并將用戶會話jsessionid追加地址后。用戶終端收到重定向請求，訪問第三方平臺登錄成功頁面。第三方平臺登錄獲取到用戶會話jsessionid并保存。用戶終端發(fā)送微薄分享請求到第三方平臺。第三方平臺收到分享請求先調用【獲取驗證ID】，通過jsessionid獲取到驗證ID。第三方平臺收到驗證中心返回的驗證ID，直接調用驗證中心【第三方微薄分享接口】場景三：第三方合作平臺手機用戶與wo+分享賬戶綁定說明：為了給第三方合作平臺手機用戶贈送禮品，需要將用戶手機號碼與wo+分享賬戶綁定。流程說明流程說明用戶終端發(fā)起登錄請求用戶在第三方合作平臺登錄成功后，重定向訪問驗證中心【第三方網站用戶登錄接口】，獲取到用戶會話ID（jssesionid）用戶終端請驗證中心【第三方網站用戶登錄接口】驗證中心處理成功后，將發(fā)起重定向操作。驗證中心將用戶登錄成功后的會話（jsessionid）參數追加到重定向地址后。第三方合作平臺可以通過httpget方式獲取。用戶終端收到重定向后的地址進行訪問。重定向地址是第三方合作平臺的登錄成功頁地址。第三方合作平臺獲取到用戶終端登錄成功請求后，調用驗證中心【獲取驗證ID】接口，得到驗證ID。第三合作平臺調用驗證中心【賬戶綁定】接口，將用戶手機號碼與驗證ID綁定。場景四、第三方平臺獲取手機號碼訪問wo+用戶中心說明：第三方平臺獲取到用戶手機號碼，登錄17wo用戶中心。17wo用戶中心會根據用戶手機號碼自動登錄或注冊。流程說明：用戶終端發(fā)起用戶中心訪問請求到第三方合作平臺。第三方合作平臺根據用戶發(fā)送請求獲取到用戶手機號碼。第三方合作平臺調用驗證中心【手機號碼用戶登錄或注冊】接口驗證中心收到第三方合作平臺的接口調用請求后，進行用戶登錄或注冊處理。處理成功后重定向17wo用戶中心地址到用戶終端。用戶終端收到請求，訪問17wo用戶中心。接口協(xié)議說明協(xié)議類型：采用http協(xié)議。輸入參數加密方法：所有的接口都要求傳入參數"u",u參數為一個組合加密生成的字符串。參數u的生成方法，例如接口需要傳入sid和backurl兩個參數，生成str=”sid=XXXXX;backurl=XXXXX”的字符串,之后進行加密處理生成u參數，加密方式如下：對str進行TripleDES加密，生成加密后的字節(jié)串strBytes[]。密鑰由驗證中心與第三方網站約定；將strBytes生成Base64字符串，該字符串即為"u"的值；3DES加密采用CBC模式，明文PKCS5（7）填充，向量是8個空字節(jié)，密鑰需要24位，不足后面空格填充。鑒權參數說明：接口中使用的渠道名稱和加密密鑰是由負責技術對接的wo+分享網站管理員分配提供給合作方使用。IP白名單限制：WO+平臺接口作了IP白名單限制，因此需要事先向WO+平臺提供接口調用方的IP地址。接口列表第三方網站用戶登錄接口接口地址：/login/LoginController/{渠道名}?u={u}說明：第三方站點使用本接口讓用戶登入WO+平臺。輸入參數名稱說明sid第三方站點用戶IDbackurl登錄成功后跳轉地址（可選）如果不填則返回平臺默認提供頁面地址）返回參數登錄完成后，接口將以HTTPcode302的方式跳轉到backurl，并附上參數jsessionid。手機號碼用戶登錄或注冊接口地址：/login/PhoneMobileController/{渠道名}?u={u}說明：第三方站點可以使用用戶手機號碼登入17wo用戶中心輸入參數名稱說明mobile用戶手機號碼backurl登錄成功后跳轉地址（可選）如果不填則返回平臺默認提供頁面地址）返回參數登錄完成后，接口將以HTTPcode302的方式跳轉到backurl，并附上參數jsessionid。第三方微薄登錄接口接口地址：/OpenOauthLogin/{渠道名}/{weibo}?state={state}說明：第三方站點使用本接口讓用戶使用微博賬號登入WO+平臺。輸入參數名稱說明weibo微博類型，可選值qq/sinastate用于標識用戶會話。該參數將在登錄成功后返回backurl登錄成功后跳轉地址（可選）如果不填則返回平臺默認提供頁面地址）返回參數登錄完成后，接口將以HTTPcode302的方式跳轉到backurl，并附上參數jsessionid。

第三方微薄分享接口接口地址：/view/SendWeiboController/{渠道名}?u=說明：提供給第三方合作平臺分享微薄接口輸入參數名稱說明auhtid驗證碼IDcontent分享內容（不能超過140個字節(jié)）weiboname微博名稱，可選值qq/sina返回參數{"code":"00000000","result":{}}code：處理結果碼獲取驗證ID接口接口地址：/view/QueryAuthidByjSessionId/{渠道名}?jsessionid=說明：通過用戶會話ID獲取驗證ID接口輸入參數名稱說明jsessionid用戶會話ID返回參數處理成功返回JSON格式：｛code:"結果碼",result:{”authid”}｝處理失敗返回JSON格式：｛code:"結果碼",description:"失敗原因"｝賬戶綁定接口接口地址：/view/BindPhoneController/{渠道名}?u=說明：將驗證ID與手機號碼進行綁定輸入參數名稱說明authid驗證IDphone用戶手機號碼返回參數處理成功返回JSON格式：｛code:"結果碼",result:””｝處理失敗返回JSON格式：｛code:"結果碼",description:"失敗原因"｝wo+分享用戶注冊接口接口地址：/view/WoShareRegisterController/{渠道名}?u=說明：提供wo+分享用戶注冊信息輸入參數名稱說明mobile用戶手機號碼pwd密碼mobiletype1：聯通用戶2：移動用戶3：電信用戶0：其它用戶sid接入平臺的用戶唯一標識（如果為空sid=mobile）返回參數處理成功返回JSON格式：｛code:"結果碼",result:”jsessionid”｝處理失敗返回JSON格式：｛code:"結果碼",description:"失敗原因"｝wo+分享用戶登錄接口接口地址：/view/WoShareLoginController/{渠道名}?u=說明：提供wo+分享用戶登錄信息輸入參數名稱說明mobile用戶手機號碼pwd密碼sid接入平臺的用戶唯一標識（如果為空sid=mobile）iswouser是否用17wo用戶賬號驗證false不使用;true使用（默認為true）返回參數處理成功返回JSON格式：｛code:"結果碼",result:”jsessionid”｝處理失敗返回JSON格式：｛code:"結果碼",description:"失敗原因"｝wo+分享用戶密碼修改接口接口地址：/view/WoShareModifyController/{渠道名}?u=說明：提供wo+分享用戶登錄信息輸入參數名稱說明mobile用戶手機號碼oldpwd老密碼newpwd新密碼sid接入平臺的用戶唯一標識（可以為空）iswouser是否用17wo用戶賬號驗證false不使用;true使用（默認為true）返回參數處理成功返回JSON格式：｛code:"結果碼",result:”jsessionid”｝處理失敗返回JSON格式：｛code:"結果碼",description:"失敗原因"｝查詢WO+分享用戶賬戶信息接口地址：/view/QueryUserInfoController/{渠道名}?u=說明：提供wo+分享用戶登錄信息輸入參數名稱說明jsessionid用戶會話ID返回參數處理成功返回JSON格式：｛code:"結果碼",result:{userId:””,//用戶ID或手機號碼isMark:””,//簽到true已簽到false未簽到level:””,等級growup:””,成長值usericon:””,用戶圖標integral:””,用戶當前沃豆flow:””用戶當前流量,coin:””沃幣數,continuousCheckin:””連續(xù)簽到天數,note:””,短信telephoneExpenses:””,贈送話費presentNum:””,禮品數medal:[{type:“”,勛章類型name:””,勛章名稱img:””勛章圖片地址},{type:””,勛章類型name:””,勛章名稱img:””勛章圖片地址}]}｝處理失敗返回JSON格式：｛code:"結果碼",description:"失敗原因"｝wo+分享訪問入口地址訪問地址：/{訪問頁面地址}?c={渠道名稱}&jsessionid=說明：訪問頁面地址:嵌入的17wo頁面地址輸入參數名稱說明jsessionid用戶會話IDc渠道名稱wo+用戶簽到接口接口地址：/view/WoSignInController/{渠道名}?u=說明：提供wo+分享用戶登錄信息輸入參數名稱說明jsessionid用戶會話ID返回參數處理成功返回JSON格式：｛code:"結果碼",result:””｝處理失敗返回JSON格式：｛code:"結果碼",description:"失敗原因"｝結果碼說明00000019:發(fā)送一條微薄失敗00000009:系統(tǒng)錯誤00000008:調用接口錯誤00000003:參數錯誤00000012:用戶USERID不存在00000002:地址錯誤服務不存在00000011:userid已經綁定authid00000014:QQtoken接口返回錯誤00000001:用戶來源渠道不存在00000013:獲取qqtoken接口連接異常00000000:成功00000016:OAUTH平臺ID不存在00000007:號碼沒有被其它驗證ID綁定，合并失敗00000015:QQopenid接口返回錯誤00000006:號碼已經被另一個驗證ID綁定00000018:沒有綁定微薄賬戶00000005:驗證碼不存在00000017:sinatoken接口返回錯誤00000004:手機號