帮助中心  /  用户授权接口（安装）

用户授权接口（安装）

接口功能说明

通过该接口方案，是可以对安装到终端（APP、小程序、网站）完成用户提前授权，完成用户身份注入，直接参与活动。


用户授权接口


ActivityUtilitySDK.identify(openid,nickname,headimgurl,sign)

通过该接口注入用户身份，点击活动即可直接参与。

参数名称

是否必须

类型

说明

openid

是

string(128)

活动用户唯一标识

人人秀识别用户唯一性判断依据 

nickname

是

string(60)

用户昵称  

headimgurl

是

string(200)

用户头像地址

注意：如有海报合成，需允许图片域名跨域

sign

是

string(32)

根据文档签名算法计算所得


签名计算

在安装页面获取secret，-> copy key

image.png

按照签名算法计算sign：

  • 第1步：对参数按照key=value的格式，并按照参数名ASCII字典序排序如下：stringA="headimgurl=urlEncode('https://thirdwx.qlogo.cn/mmopen/vi_32/Q0j4...TMa')&nickname= urlEncode('张3')&openid=ot1UbuBBzlE6IjEDWfyXQW3dy2S4";

  • 第2步：拼接AppSecret： stringSignTemp=stringA+"&secret=eRdLi88c6I6L95PFSX1Nq69Y84xLcD3T"

    sign=MD5(stringSignTemp).toUpperCase() //得到98C51350D2C5055194C809BA0CC6533D

特别注意以下重要规则：  

  • 参数名ASCII码从小到⼤排序（字典序）；  

  • 如果参数的值为空不参与签名；  

  • 参数名区分小写；  

  • ⼈⼈秀平台主动发起的请求时，传送的sign参数不参与签名，将⽣成的签名与该sign值作校验；


注意事项


  • 必须在服务器端计算签名

    客户端⽣成签名地址，可能会导致以下问题：

    1.客户端易被破解，Secret有外泄的⻛险，危害严重！

    2.如果⽤户的⼿机端时钟不准，或者不在北京时区，会导致时间验证过期，⽆法访问。 因此签名地址务必在服务器端⽣成。

    3.如不按要求，由此导致的损失，⼈⼈秀概不负责!

  • 签名失败的问题排查

    1.是否为编码异常导致。⼈⼈秀的请求部分参数会带有中⽂字符，第三方开发者需要先对请求参数做URLDecode 解码，可以在签名时遍历签名参数排查是否有字符乱码。



相关文档