WO+分享平台中心对外接入技术方案v133

广东联通互动营销平台（wo+分享）对外接入技术方案拓维信息2013年05月

目录1 文档说明 32 接入系统说明 32.1 验证中心 42.2 开放功能说明 43 使用场景及流程说明 43.1 场景一：嵌入wo+分享定制化的用户中心 43.2 场景二：使用17wo分享功能 63.3 场景三：第三方合作平台手机用户与wo+分享账户绑定 74 接口协议说明 85 接口列表 95.1 第三方网站用户登录接口 95.2 第三方微薄登录接口 95.3 第三方微薄分享接口 105.4 获取验证ID接口 105.5 账户绑定接口 105.6 结果码说明 11

文档说明 该文档主要在以下几种情况中使用第三方合作平台用户与wo+分享用户实现单点登录使用；第三方合作平台使用wo+分享分享功能；为客户端或网站类产品嵌入wo+分享定制化的用户中心或其它功能页面技术对接中使用；接入系统说明

验证中心WO+验证中心是实现WO+第三方用户验证和单点登录的平台，目的在于：引入第三方平台的用户；允许用户将第三方平台的账号通过手机号码绑定到WO+账号；合并不同平台之间的账户信息，以方便使用统一的账户来消费积分、沃币、流量等；为用户生成唯一验证中心ID，用于WO+单点登录。实现用户新浪账号，腾讯账号的授权开放功能说明定制化用户中心：为每个第三方合作方法平台提供一个定制化的用户中心，满足对不同的平台风格和内容的需要。开放用户账户：为接入wo+分享平台的第三方合作平台用户，新建账户加虚拟和实体奖品。分享功能：提供微薄分享和短信分享功能。内容访问：为第三合作平台定制化内容访问页面。使用场景及流程说明场景一：嵌入wo+分享定制化的用户中心说明：为第三方合作的产品（客户端或网站）提供定制化的用户中心页面。流程介绍流程说明：用户发起登录请求用户在第三方合作平台登录成功后，重定向访问验证中心【第三方网站用户登录接口】，获取到用户会话ID（jssesionid）用户终端请验证中心【第三方网站用户登录接口】验证中心处理成功后，将发起重定向操作。验证中心将用户登录成功后的会话（jsessionid）参数追加到重定向地址后。第三方合作平台可以通过httpget方式获取。用户终端收到重定向后的地址进行访问。重定向地址是第三方合作平台的登录成功页地址。用户终端发起访问用户中心请求，该请求地址是第三合作平台的代理地址。第三方平台代理收到访问请求，将带上用户的会话ID（jsessionid）。重定向到wo+分享用户中心。场景二：使用wo+分享功能说明：第三方合作产品（客户端或网站）使用wo+分享分享功能。流程介绍流程说明：用户终端发起微薄登录页面访问请求。第三方接入平台收到用户终端请求，将重定向到验证中心的【第三方微薄登录接口】用户终端收到重定向过来的地址，调用取接口验证中心登录成功后，重定向第三方平台提供的登录成功页面，并将用户会话jsessionid追加地址后。用户终端收到重定向请求，访问第三方平台登录成功页面。第三方平台登录获取到用户会话jsessionid并保存。用户终端发送微薄分享请求到第三方平台。第三方平台收到分享请求先调用【获取验证ID】，通过jsessionid获取到验证ID。第三方平台收到验证中心返回的验证ID，直接调用验证中心【第三方微薄分享接口】场景三：第三方合作平台手机用户与wo+分享账户绑定说明：为了给第三方合作平台手机用户赠送礼品，需要将用户手机号码与wo+分享账户绑定。流程说明流程说明用户终端发起登录请求用户在第三方合作平台登录成功后，重定向访问验证中心【第三方网站用户登录接口】，获取到用户会话ID（jssesionid）用户终端请验证中心【第三方网站用户登录接口】验证中心处理成功后，将发起重定向操作。验证中心将用户登录成功后的会话（jsessionid）参数追加到重定向地址后。第三方合作平台可以通过httpget方式获取。用户终端收到重定向后的地址进行访问。重定向地址是第三方合作平台的登录成功页地址。第三方合作平台获取到用户终端登录成功请求后，调用验证中心【获取验证ID】接口，得到验证ID。第三合作平台调用验证中心【账户绑定】接口，将用户手机号码与验证ID绑定。场景四、第三方平台获取手机号码访问wo+用户中心说明：第三方平台获取到用户手机号码，登录17wo用户中心。17wo用户中心会根据用户手机号码自动登录或注册。流程说明：用户终端发起用户中心访问请求到第三方合作平台。第三方合作平台根据用户发送请求获取到用户手机号码。第三方合作平台调用验证中心【手机号码用户登录或注册】接口验证中心收到第三方合作平台的接口调用请求后，进行用户登录或注册处理。处理成功后重定向17wo用户中心地址到用户终端。用户终端收到请求，访问17wo用户中心。接口协议说明协议类型：采用http协议。输入参数加密方法：所有的接口都要求传入参数"u",u参数为一个组合加密生成的字符串。参数u的生成方法，例如接口需要传入sid和backurl两个参数，生成str=”sid=XXXXX;backurl=XXXXX”的字符串,之后进行加密处理生成u参数，加密方式如下：对str进行TripleDES加密，生成加密后的字节串strBytes[]。密钥由验证中心与第三方网站约定；将strBytes生成Base64字符串，该字符串即为"u"的值；3DES加密采用CBC模式，明文PKCS5（7）填充，向量是8个空字节，密钥需要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个字节）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:””连续签到天数,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:发送一条微薄失败00000009:系统错误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:手机号