Skip to main content

获取用户信息

接口概述​

该接口用于获取用户的基本信息，包括绑定的 QQ 号、昵称、头像等信息。请求时需要提供有效的 access_token。

接口 URL

GET https://ydzx.panretro.com/external/api/v1/oauth2/userinfo

请求参数

参数名类型必填描述
access_tokenstring是OAuth2 授权访问令牌，用于验证用户身份

注意：access_token 必须有效，否则接口会返回授权失败。

响应说明​

接口返回 JSON 格式数据，主要字段如下：

响应示例​

{
  "code": 200,
  "msg": "success",
  "data": {
    "qq": "3052381496",
    "phone": null,
    "nickname": "NTG",
    "avatar": "/api/avatar/get/personal?id=1777458500"
  }
}

响应字段说明​

字段名类型描述
codeint状态码，200 表示请求成功
msgstring返回信息，成功时为 "success"
data.qqstring用户绑定的 QQ 号，不为 null
data.phonestring用户绑定的手机号，可能为 null
data.nicknamestring用户昵称，不为 null
data.avatarstring用户头像路径

响应示例说明​

  • qq 和 nickname 为必填字段，确保有值