获取用户信息

接口说明

本接口用于获取用户信息，同时也可以用来校验 AccessToken 的有效性。

权限说明

本接口需要拥有以下任意一项权限：

• scope.user.info.base

请求格式

描述	定义
Path	/oauth/v2/userinfo
Method	GET
Accept	application/json

请求参数

名称	类型	必选	备注
access_token	string	是	请求授权成功时获取的 Access Token

响应体

参数名	类型	描述
ret	integer	业务返回码
msg	string	业务返回码描述
data.openID	string	用户唯一标识
data.nick	string	用户的昵称
data.avatar	string	用户头像
data.source	string	用户授权方式。 wx: 微信 qq:QQ
data.bindSource	string	用户绑定账号。 wx: 微信 qq:QQ
data.unionID	string	用户统一标识。针对一个腾讯文档开放平台开发者账号下的应用，同一用户的 unionID 是唯一的

请求示例

curl --location --request GET 'https://docs.qq.com/oauth/v2/userinfo?access_token=ACCESS_TOKEN' 

响应示例

{
    "ret": 0,
    "msg": "Succeed",
    "data": {
        "openID": "OpenIDTest",
        "nick": "nickTest",
        "avatar": "https://example.com/avatar.png",
        "source": "wx",
        "unionID": "UnionIDTest"
    }
}