帮助中心  /  第三方授权接口(旧版)

第三方授权接口(旧版)

接口功能说明

通过该接口方案,可以完成使用自己系统的用户体系、业务逻辑,授权用户参与活动,代替使用微信授权获取用户流程。该方案包含2个接口调用,请仔细阅读本文档活动授权时序图,完成接口对接开发。

因使用第三方授权接口后,人人秀平台涉及和微信平台相关的功能将无法使用,比如微信支付等功能。


用户活动授权流程

  • 1. 用户打开h5活动地址,进入活动;

  • 2. 进入活动时人人秀主动跳转到【第三方授权接口】(需在人人秀开放平台配置)并传入h5_guid等参数。

  • 3. 第三方授权接口】接收到h5_guid等参数人人秀调用接口传递的参数 ,完成自己业务逻辑后,根据【人人秀授权接口】生成 h5活动授权链接并主动跳转h5授权,完成重定向跳转进入活动。


图解用户活动授权时序图:

image.png

1.    人人秀授权接口

开发说明:

  • 该接口由人人秀提供给第三方开发者调用,第三方开发者调用该接口生成h5活动授权链接来完成授权

  • 生成的授权链接有效期为10分钟

  • 授权链接调用后就会失效,每次使用都需要调用接口重新生成链接

请求地址

https://open.rrx.cn/api/v1/thirdAuth/authorize

请求方式

重定向

参数说明

参数名称

是否必须

类型

说明

app_key

string(32)

人人秀平台分配的AppKey

time_stamp

int(13)

1970-01-01开始的时间戳,精确到毫秒

sign

string(32)

根据签名算法计算所得,如何计算签名

openid

string(32)

活动用户唯一标识  

nickname

string(60)

用户昵称  

headimgurl

string(200)

用户头像地址

h5_guid

string(6)

h5标记来自人人秀哪个活动

params

string(200)

其他参数,json字符串对象

redirect

string(200)

当前活动地址,用于授权成功后跳转

fail_url

string(200)

授权失败,跳转地址

响应示例

成功

直接跳转h5活动页面

失败

如果fail_url不为空 则跳转到fail_url,为空则返回错误信息{"result":1,"msg":"授权失败"}


对接步骤

第一步,计算签名,参照API接口规范及签名算法

第二步,对参数进行urlencode编码处理

第三步,拼接授权链接

    例如:https://open.rrx.cn/api/v1/thirdAuth/authorize?app_key=testkey&time_stamp=123&sign=testsign&openid=123&nickname=%E5%.&h5_guid=h5_guid&redirect=redirect

第四步,重定向到授权链接


数据注意事项:

  • 1.计算签名时,不要对参数进行urlencode处理

  • 2.拼接授权链接时,需要对参数进行urlencode处理,避免乱码和错码

  • 3.h5_guid、redirect,可以从人人秀调用第三方授权接口时传递的参数列获得

  • 4.headimgurl,如需生成海报必须允许该图片地址支持跨域访问,因合成海报需要canvas技术合成图片

  • 5.注意接口地址区分大小写 例如:https://open.rrx.cn/api/v1/thirdAuth/authorize


示例代码

JavaScript重定向

    window.location.href='授权链接';

java 重定向

    response.sendRedirect(授权链接)




2.    第三方授权接口

开发说明

  • 该接口由第三方开发者提供给人人秀调用,必须设置该接口地址。

  • 开发者应该在每次打开h5活动时调用 [人人秀授权接口] 生成授权链接,否则用户直接打开h5会提示请先登录

  • 人人秀重定向到[ 第三方授权接口]时,会对每个参数进行urlencode处理。

  • 第三方开发者,接收到参数,必须先将参数urldecode处理,然后计算签名

请求地址

[ 第三方授权接口]  

请求方式

重定向

参数说明      

参数名称

是否必须

类型

说明

app_key

string(32)

人人秀平台分配的AppKey

time_stamp

int(13)

1970-01-01开始的时间戳,精确到毫秒

sign

string(32)

根据签名算法计算所得,如何计算签名

h5_guid

string(6)

人人秀平台下活动唯一标识,6位字符串

redirect

string(200)

h5活动地址



注意事项

  • 不建议使用拼接参数的方式使用第三方客户登录授权,首次访问链接会携带,多页面间跳转可能会导致参数丢失。

  • 建议使用,用户登录状态授权,即人人秀请求第三方客户登录接口时,第三方获取当前用户登录状态然后通过接口返回用户信息,授权参与活动。



相关文档