h5.authorizeUserInfo

本接口应在服务器端调用,详细说明参见 服务端API

获取网页应用授权登录用户信息,更多使用方法详见 授权登录流程

接口地址

https://miniapp.cloud.189.cn/platform/h5auth/api/open/oauth2/authorizeUserInfo

调用方式

GET

请求参数

参数名 类型 长度 必要性 说明
authorizationToken string 255 必须 授权用户的令牌

请求示例

https://miniapp.cloud.189.cn/platform/h5auth/api/open/oauth2/authorizeUserInfo?authorizationToken=AB6AD62661EE2B09E39121B5B6D3434F45FC7597AE76AC1327B8025CCCECDD580CAFD5034A100012166EA0E7D5FD198B63E656C80A4CE49612FD58520462E170E80426FE9156CD0F6AA60B7F50E9BA888D633D41D56D8BBBA6556EAC28367828607E1483

响应数据

属性名 类型 长度 说明
code number 11 接口状态代码,0表示成功,其他的表示非正常情况
msg string 255 接口状态说明
data object - 接口数据对象
  encryptedData string 1024 用户信息加密串

data.encryptedData解密过程如下:

// 解密过程伪代码
userInfo = XXTea.decrypted(encryptedData, appSecret);

注意:appSecret 为 H5 应用秘钥。如接入方服务端使用 Java 开发,XXTea 算法的入参一般是 Hex 十六进制形式,请将 appSecret 转码为十六进制形式即可。

另外,我们还提供了针对不同开发语言的小程序签名签名和加解密算法封装实现的 SDK 工具包( Java SDKNode.js SDK),简化开发者的接入调试,开箱即用。

解密后的字符串经过序列化后的对象参数如下:

属性名 类型 长度 说明
openId string 255 用户唯一标识。开发者可依据该值和用户体系做绑定关系
phoneNumber string 11 用户手机号
appId string 8 H5 应用 ID
timestamp number 255 时间戳

假设appSecret = 32b5362f61f26f4e0e1221a57e7ab02ea77dbc40encryptedData如下

A83FE5716360F141AD490C4A14349684202581439D7BCE51CC6D0550B872B7C0A7FA9C78F9B1DEB988FF73C1CBC0406FFBC9DBF0D1CAE33AF019507DF3B1479621A77DE1F16A7C3AC5D52017F184CFA99F19064E122B0CA5C88C88C1526AC7CFAE8FACDB7BA8F28F7C38424667E5E1EE589AD8A48664C56B1BD25AA448C252CF7BCAA3AA9376AB7192496C36

解密后得到 JSON 字符串为

{
"openId": "ee01554bdc77dee74db8bf8acc3426690c2572c9694e38e8",
"appId": "0e0d8b62",
"phoneNumber": "18912345679",
"timestamp": 1578042800057
}

响应示例

  • 正常响应
{
"code": 0,
"msg": "成功",
"data": {
"encryptedData": "A83FE5716360F141AD490C4A14349684202581439D7BCE51CC6D0550B872B7C0A7FA9C78F9B1DEB988FF73C1CBC0406FFBC9DBF0D1CAE33AF019507DF3B1479621A77DE1F16A7C3AC5D52017F184CFA99F19064E122B0CA5C88C88C1526AC7CFAE8FACDB7BA8F28F7C38424667E5E1EE589AD8A48664C56B1BD25AA448C252CF7BCAA3AA9376AB7192496C36"
}
}
  1. 1. h5.authorizeUserInfo
    1. 1.1. 接口地址
    2. 1.2. 调用方式
    3. 1.3. 请求参数
    4. 1.4. 请求示例
    5. 1.5. 响应数据
    6. 1.6. 响应示例