-
10周年大促!注册即领300元优惠券
- 注册/登录
接口功能说明
通过该接口代替微信授权
注意:
使用第三方授权接口后,人人秀平台涉及和微信相关的功能将无法使用,比如微信卡券、微信支付等功能。
红包奖品,目前支持红包海报提现的方式,领取微信红包。 详情查看文档
用户打开h5活动授权步骤如下:
用户打开h5活动地址
人人秀跳转到[第三方授权接口]并传入h5_guid
第三方开发者通过[第三方授权接口] 获得h5_guid ,根据[人人秀授权接口]生成 h5活动授权链接并跳转完成h5授权,以下为调用流程时序图:
接口文档:
1. 人人秀授权接口
说明:该接口由人人秀提供给第三方开发者调用,第三方开发者调用该接口生成h5活动授权链接来完成授权
注意事项:
生成的授权链接有效期为10分钟
授权链接调用后就会失效,每次使用都需要调用接口重新生成链接
请求地址 | https://api.rrx.cn/v1/h5/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://api.rrx.cn/v1/h5/authorize?app_key=testkey&time_stamp=123&sign=testsign&openid=123&nickname=%E5%B0%8F%E5%B0%8F
第四步,重定向到授权链接
注意:
1. 计算签名时,不要对参数进行urlencode处理
2. 拼接授权链接时,需要对参数进行urlencode处理,避免乱码和错码
3. 由于红包活动防作弊策略,使用红包插件时,参数headimgurl不能为空
示例代码
JavaScript重定向
window.location.href='授权链接';
java 重定向
response.sendRedirect(授权链接)
2. 第三方授权接口
说明:该接口由第三方开发者提供给人人秀调用,必须设置该接口地址,开发者应该在每次打开h5活动时调用 [人人秀授权接口] 生成授权链接,否则用户直接打开h5会提示请先登录
请求地址 | [ 第三方授权接口] | ||
请求方式 | 重定向 | ||
参数说明 | |||
参数名称 | 是否必须 | 类型 | 说明 |
app_key | 是 | string(32) | 人人秀平台分配的AppKey |
time_stamp | 是 | int(13) | 1970-01-01开始的时间戳,精确到毫秒 |
sign | 是 | string(32) | 根据签名算法计算所得,如何计算签名 |
h5_guid | 是 | string(6) | 人人秀平台下活动唯一标识,6位字符串 |
redirect | 否 | string(200) | h5活动地址 |
人人秀重定向到[ 第三方授权接口]时,会对每个参数进行urlencode处理。
注意:
1 第三方开发者,接收到参数,必须先将参数urldecode处理,然后计算签名
注意事项
1、使用了第三方授权,活动里面的支付必须使用第三方平台支付
附录: