跳到主要内容

授权服务获取用户信息(后端接口)

信息

本文档为后端接口,由第三方服务端调用,不能在小程序前端调用。

第三方服务端使用小程序端通过 mgtv.loginmgtv.getUserAuthCode 获取到的 authCode(有效期 5 分钟),请求以下接口兑换用户信息。

接口URL

https://mp-user.api.mgtv.com/openApi/v1/auth/userInfo

请求参数

属性类型必填说明
authCodestring芒果侧生成的 authCode(由 mgtv.login 或 mgtv.getUserAuthCode 获取)
signstring签名,见「签名算法」说明
timestampnumber时间戳(单位:毫秒)
appIdstring小程序 APPID

返回值

属性类型说明
codenumber状态码
dataobject芒果用户信息,结构见下表
msgstring错误信息,见服务端 API 错误码

Object data

属性类型说明
mgOpenIdstring第三方用户唯一标识
nicknamestring昵称,仅 mgtv.getUserAuthCode 获取的 authCode 可兑换
avatarstring头像,仅 mgtv.getUserAuthCode 获取的 authCode 可兑换
mobilestring手机号,仅 mgtv.getUserAuthCode 获取的 authCode 可兑换
appIdstring小程序 APPID
备注

使用 mgtv.login 获取的 authCode 兑换时,仅返回 mgOpenIdappId;如需获取昵称、头像、手机号,请使用 mgtv.getUserAuthCode 获取的 authCode。

服务端 API 错误码

错误码说明
200OK
-400请求错误
-401未认证(签名验签失败)
7001签名过期
7002授权码无效
7003授权码与应用不匹配