授权服务获取用户信息(后端接口)
信息
本文档为后端接口,由第三方服务端调用,不能在小程序前端调用。
第三方服务端使用小程序端通过 mgtv.login 或 mgtv.getUserAuthCode 获取到的 authCode(有效期 5 分钟),请求以下接口兑换用户信息。
接口URL
https://mp-user.api.mgtv.com/openApi/v1/auth/userInfo
请求参数
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
| authCode | string | 是 | 芒果侧生成的 authCode(由 mgtv.login 或 mgtv.getUserAuthCode 获取) |
| sign | string | 是 | 签名,见「签名算法」说明 |
| timestamp | number | 是 | 时间戳(单位:毫秒) |
| appId | string | 是 | 小程序 APPID |
返回值
| 属性 | 类型 | 说明 |
|---|---|---|
| code | number | 状态码 |
| data | object | 芒果用户信息,结构见下表 |
| msg | string | 错误信息,见服务端 API 错误码 |
Object data
| 属性 | 类型 | 说明 |
|---|---|---|
| mgOpenId | string | 第三方用户唯一标识 |
| nickname | string | 昵称,仅 mgtv.getUserAuthCode 获取的 authCode 可兑换 |
| avatar | string | 头像,仅 mgtv.getUserAuthCode 获取的 authCode 可兑换 |
| mobile | string | 手机号,仅 mgtv.getUserAuthCode 获取的 authCode 可兑换 |
| appId | string | 小程序 APPID |
备注
使用 mgtv.login 获取的 authCode 兑换时,仅返回 mgOpenId 和 appId;如需获取昵称、头像、手机号,请使用 mgtv.getUserAuthCode 获取的 authCode。
服务端 API 错误码
| 错误码 | 说明 |
|---|---|
| 200 | OK |
| -400 | 请求错误 |
| -401 | 未认证(签名验签失败) |
| 7001 | 签名过期 |
| 7002 | 授权码无效 |
| 7003 | 授权码与应用不匹配 |