# 获取授权用户信息

接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。

接口英文名：snsUserInfo

如果网页授权作用域为snsapi_userinfo，则此时开发者可以通过access_token和openid拉取用户信息。

注意：此接口频率限制为 5 万/分钟

# 1. 调用方式

# HTTPS 调用

GET https://api.weixin.qq.com/sns/userinfo?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN

# 云调用

本接口不支持云调用。

# 第三方调用

本接口不支持第三方平台调用。

# 2. 请求参数

# 查询参数 `Query String Parameters`

参数名	类型	必填	示例	说明
access_token	string	是	-	接口调用凭证，可使用 access_token
openid	string	是	-	用户的唯一标识
lang	string	否	zh_CN	返回国家地区语言版本，zh_CN 简体，zh_TW 繁体，en 英语

# 请求体 `Request Payload`

无

# 3. 返回参数

# 返回体 `Response Payload`

参数名	类型	说明
openid	string	用户的唯一标识
nickname	string	用户昵称
sex	number	用户的性别，值为1时是男性，值为2时是女性，值为0时是未知
headimgurl	string	用户头像，最后一个数值代表正方形头像大小（有0、46、64、96、132数值可选，0代表640*640正方形头像），用户没有头像时该项为空。若用户更换头像，原有头像URL将失效。
unionid	string	只有在管理员将公众号绑定到微信开放平台账号后，才会出现该字段。
province	string	用户个人资料填写的省份
city	string	普通用户个人资料填写的城市
country	string	国家，如中国为CN
privilege	array	用户特权信息，json 数组，如微信沃卡用户为（chinaunicom）

# 4. 注意事项

目前网页授权有两个 scope，分别是：snsapi_base 和 snsapi_userinfo，解释如下：

snsapi_base：用来获取进入页面的用户的openid的，并且是静默授权并自动跳转到回调页的。（不会弹出信息确认框,仅能获取用户 openid 等信息，无法获取昵称头像）
snsapi_userinfo：用来获取用户的基本信息的。但这种授权需要用户手动同意。（由于用户同意过，所以无须依赖用户关注服务号，就可在授权后获取该用户的基本信息）

即，调用本接口必须是使用“snsapi_userinfo”构建的授权链接，并且获得用户授权同意，否则会返回 48001 的报错

# 5. 代码示例

请求示例

https://api.weixin.qq.com/sns/userinfo?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN

返回示例

{   
  "openid": "OPENID",
  "nickname": NICKNAME,
  "sex": 1,
  "province":"PROVINCE",
  "city":"CITY",
  "country":"COUNTRY",
  "headimgurl":"https://thirdwx.qlogo.cn/mmopen/g3MonUZtNHkdmzicIlibx6iaFqAc56vxLSUfpb6n5WKSYVY0ChQKkiaJSgQ1dZuTOgvLLrhJbERQQ4eMsv84eavHiaiceqxibJxCfHe/46",
  "privilege":[ "PRIVILEGE1" "PRIVILEGE2"     ],
  "unionid": "o6_bmasdasdsad6_2sgVt7hMZOPfL"
}

# 6. 错误码

以下是本接口的错误码列表，其他错误码可参考通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具辅助定位和分析问题。

错误码	错误描述	解决方案
40003	invalid openid	不合法的 OpenID ，请开发者确认 OpenID （该用户）是否已关注公众号，或是否是其他公众号的 OpenID

# 7. 适用范围

本接口在不同账号类型下的可调用情况：

服务号	移动应用	网站应用
仅认证	✔	✔

仅认证：表示仅允许企业主体已认证账号调用，未认证或不支持认证的账号无法调用。
✔：该账号可调用此接口。
其他未明确声明的账号类型，如无特殊说明，均不可调用此接口。

接口变更日志（2条）

2025 年 12 月 18 日

优化 unionid 字段描述，避免歧义

2025 年 12 月 11 日

文档描述优化