获取微信用户信息

根据 openid 获取用户更多资料,例如昵称、头像、性别、地区等信息

接口地址

请求参数

字段名称 字段类型 必填参数 说明
mch_id integer Y 商户号
sign string Y 数据签名 详见签名算法
openid string Y 用户的openid

正确返回

字段名称 字段类型 必填参数 说明
mch_id integer Y 商户号
return_code integer Y 0: 成功, 非0: 失败,具体参照错误码列表
return_message string Y 错误信息
sign string Y 数据签名 详见签名算法
openid string Y 用户的标识,对公众号唯一
nickname string Y 用户昵称
sex integer N 用户的性别,值为1时是男性,值为2时是女性,值为0时是未知
province string N 用户个人资料填写的省份
city string N 普通用户个人资料填写的城市
country string N 国家,如中国为CN
headimgurl string N 用户头像,最后一个数值代表正方形头像大小(有0、46、64、96、132数值可选,0代表640*640正方形头像),用户没有头像时该项为空。若用户更换头像,原有头像URL将失效。
unionid string N 只有在用户将公众号绑定到微信开放平台帐号后,才会出现该字段。

注意:

  • 如果获取 openid 时使用的 scopesnsapi_base,则上述返回字段均为空值。

错误返回

字段名称 字段类型 必填参数 说明
return_code integer Y 0: 成功, 非0: 失败,具体参照错误码列表
return_message string Y 错误信息

错误码

待补充

代码示例

待补充