您的位置：首页 > 移动开发 > 微信开发

微信开发笔记-（2）获取用户基本信息

2016-12-22 17:10 489 查看
                            微信开发笔记-（2）获取用户基本信息

文章内容摘自微信|公众平台开发者文档

在关注者与公众号产生消息交互后，公众号可获得关注者的OpenID（加密后的微信号，每个用户对每个公众号的OpenID是唯一的。对于不同公众号，同一用户的openid不同）。公众号可通过本接口来根据OpenID获取用户基本信息，包括昵称、头像、性别、所在城市、语言和关注时间。

请注意，如果开发者有在多个公众号，或在公众号、移动应用之间统一用户帐号的需求，需要前往微信开放平台（open.weixin.qq.com）绑定公众号后，才可利用UnionID机制来满足上述需求。

UnionID机制说明：
开发者可通过OpenID来获取用户基本信息。特别需要注意的是，如果开发者拥有多个移动应用、网站应用和公众帐号，可通过获取用户基本信息中的unionid来区分用户的唯一性，因为只要是同一个微信开放平台帐号下的移动应用、网站应用和公众帐号，用户的unionid是唯一的。换句话说，同一用户，对同一个微信开放平台下的不同应用，unionid是相同的。


获取用户基本信息（包括UnionID机制）

开发者可通过OpenID来获取用户基本信息。请使用https协议。

接口调用请求说明
http请求方式: GET
https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN


参数说明
参数是否必须说明
access_token是调用接口凭证
openid是普通用户的标识，对当前公众号唯一
lang否返回国家地区语言版本，zh_CN 简体，zh_TW 繁体，en 英语
返回说明

正常情况下，微信会返回下述JSON数据包给公众号：
{
"subscribe": 1,
"openid": "o6_bmjrPTlm6_2sgVt7hMZOPfL2M",
"nickname": "Band",
"sex": 1,
"language": "zh_CN",
"city": "广州",
"province": "广东",
"country": "中国",
"headimgurl":    "http://wx.qlogo.cn/mmopen/g3MonUZtNHkdmzicIlibx6iaFqAc56vxLSUfpb6n5WKSYVY0ChQKkiaJSgQ1dZuTOgvLLrhJbERQQ4eMsv84eavHiaiceqxibJxCfHe/0",
"subscribe_time": 1382694957,
"unionid": " o6_bmasdasdsad6_2sgVt7hMZOPfL"
"remark": "",
"groupid": 0
}


参数说明
参数说明
subscribe用户是否订阅该公众号标识，值为0时，代表此用户没有关注该公众号，拉取不到其余信息。
openid用户的标识，对当前公众号唯一
nickname用户的昵称
sex用户的性别，值为1时是男性，值为2时是女性，值为0时是未知
city用户所在城市
country用户所在国家
province用户所在省份
language用户的语言，简体中文为zh_CN
headimgurl用户头像，最后一个数值代表正方形头像大小（有0、46、64、96、132数值可选，0代表640*640正方形头像），用户没有头像时该项为空。若用户更换头像，原有头像URL将失效。
subscribe_time用户关注时间，为时间戳。如果用户曾多次关注，则取最后关注时间
unionid只有在用户将公众号绑定到微信开放平台帐号后，才会出现该字段。详见：获取用户个人信息（UnionID机制）
remark公众号运营者对粉丝的备注，公众号运营者可在微信公众平台用户管理界面对粉丝添加备注
groupid用户所在的分组ID
错误时微信会返回错误码等信息，JSON数据包示例如下（该示例为AppID无效错误）:
{"errcode":40013,"errmsg":"invalid appid"}


全局返回码说明

使用网页调试工具调试该接口


批量获取用户基本信息

开发者可通过该接口来批量获取用户基本信息。最多支持一次拉取100条。

接口调用请求说明
http请求方式: POST
https://api.weixin.qq.com/cgi-bin/user/info/batchget?access_token=ACCESS_TOKEN


POST数据示例
{
"user_list": [
{
"openid": "otvxTs4dckWG7imySrJd6jSi0CWE",
"lang": "zh-CN"
},
{
"openid": "otvxTs_JZ6SEiP0imdhpi50fuSZg",
"lang": "zh-CN"
}
]
}


参数说明
参数是否必须说明
openid是用户的标识，对当前公众号唯一
lang否国家地区语言版本，zh_CN 简体，zh_TW 繁体，en 英语，默认为zh-CN
返回说明

正常情况下，微信会返回下述JSON数据包给公众号（示例中为一次性拉取了2个openid的用户基本信息，第一个是已关注的，第二个是未关注的）：
{
"user_info_list": [
{
"subscribe": 1,
"openid": "otvxTs4dckWG7imySrJd6jSi0CWE",
"nickname": "iWithery",
"sex": 1,
"language": "zh_CN",
"city": "Jieyang",
"province": "Guangdong",
"country": "China",
"headimgurl": "http://wx.qlogo.cn/mmopen/xbIQx1GRqdvyqkMMhEaGOX802l1CyqMJNgUzKP8MeAeHFicRDSnZH7FY4XB7p8XHXIf6uJA2SCunTPicGKezDC4saKISzRj3nz/0",
"subscribe_time": 1434093047,
"unionid": "oR5GjjgEhCMJFyzaVZdrxZ2zRRF4",
"remark": "",
"groupid": 0
},
{
"subscribe": 0,
"openid": "otvxTs_JZ6SEiP0imdhpi50fuSZg",
"unionid": "oR5GjjjrbqBZbrnPwwmSxFukE41U",
}
]
}


参数说明
参数说明
subscribe用户是否订阅该公众号标识，值为0时，代表此用户没有关注该公众号，拉取不到其余信息，只有openid和UnionID（在该公众号绑定到了微信开放平台账号时才有）。
openid用户的标识，对当前公众号唯一
nickname用户的昵称
sex用户的性别，值为1时是男性，值为2时是女性，值为0时是未知
city用户所在城市
country用户所在国家
province用户所在省份
language用户的语言，简体中文为zh_CN
headimgurl用户头像，最后一个数值代表正方形头像大小（有0、46、64、96、132数值可选，0代表640*640正方形头像），用户没有头像时该项为空。若用户更换头像，原有头像URL将失效。
subscribe_time用户关注时间，为时间戳。如果用户曾多次关注，则取最后关注时间
unionid只有在用户将公众号绑定到微信开放平台帐号后，才会出现该字段。详见：获取用户个人信息（UnionID机制）
remark公众号运营者对粉丝的备注，公众号运营者可在微信公众平台用户管理界面对粉丝添加备注
groupid用户所在的分组ID
错误时微信会返回错误码等信息，JSON数据包示例如下（该示例为AppID无效错误）:
{"errcode":40013,"errmsg":"invalid appid"}


全局返回码说明：

返回码说明
-1系统繁忙，此时请开发者稍候再试
0请求成功
40001获取access_token时AppSecret错误，或者access_token无效。请开发者认真比对AppSecret的正确性，或查看是否正在为恰当的公众号调用接口
40002不合法的凭证类型
40003不合法的OpenID，请开发者确认OpenID（该用户）是否已关注公众号，或是否是其他公众号的OpenID
40004不合法的媒体文件类型
40005不合法的文件类型
40006不合法的文件大小
40007不合法的媒体文件id
40008不合法的消息类型
40009不合法的图片文件大小
40010不合法的语音文件大小
40011不合法的视频文件大小
40012不合法的缩略图文件大小
40013不合法的AppID，请开发者检查AppID的正确性，避免异常字符，注意大小写
40014不合法的access_token，请开发者认真比对access_token的有效性（如是否过期），或查看是否正在为恰当的公众号调用接口
40015不合法的菜单类型
40016不合法的按钮个数
40017不合法的按钮个数
40018不合法的按钮名字长度
40019不合法的按钮KEY长度
40020不合法的按钮URL长度
40021不合法的菜单版本号
40022不合法的子菜单级数
40023不合法的子菜单按钮个数
40024不合法的子菜单按钮类型
40025不合法的子菜单按钮名字长度
40026不合法的子菜单按钮KEY长度
40027不合法的子菜单按钮URL长度
40028不合法的自定义菜单使用用户
40029不合法的oauth_code
40030不合法的refresh_token
40031不合法的openid列表
40032不合法的openid列表长度
40033不合法的请求字符，不能包含\uxxxx格式的字符
40035不合法的参数
40038不合法的请求格式
40039不合法的URL长度
40050不合法的分组id
40051分组名字不合法
40117分组名字不合法
40118media_id大小不合法
40119button类型错误
40120button类型错误
40121不合法的media_id类型
40132微信号不合法
40137不支持的图片格式
41001缺少access_token参数
41002缺少appid参数
41003缺少refresh_token参数
41004缺少secret参数
41005缺少多媒体文件数据
41006缺少media_id参数
41007缺少子菜单数据
41008缺少oauth code
41009缺少openid
42001access_token超时，请检查access_token的有效期，请参考基础支持-获取access_token中，对access_token的详细机制说明
42002refresh_token超时
42003oauth_code超时
43001需要GET请求
43002需要POST请求
43003需要HTTPS请求
43004需要接收者关注
43005需要好友关系
44001多媒体文件为空
44002POST的数据包为空
44003图文消息内容为空
44004文本消息内容为空
45001多媒体文件大小超过限制
45002消息内容超过限制
45003标题字段超过限制
45004描述字段超过限制
45005链接字段超过限制
45006图片链接字段超过限制
45007语音播放时间超过限制
45008图文消息超过限制
45009接口调用超过限制
45010创建菜单个数超过限制
45015回复时间超过限制
45016系统分组，不允许修改
45017分组名字过长
45018分组数量超过上限
46001不存在媒体数据
46002不存在的菜单版本
46003不存在的菜单数据
46004不存在的用户
47001解析JSON/XML内容错误
48001api功能未授权，请确认公众号已获得该接口，可以在公众平台官网-开发者中心页中查看接口权限
50001用户未授权该api
50002用户受限，可能是违规后接口被封禁
61451参数错误(invalid parameter)
61452无效客服账号(invalid kf_account)
61453客服帐号已存在(kf_account exsited)
61454客服帐号名长度超过限制(仅允许10个英文字符，不包括@及@后的公众号的微信号)(invalid kf_acount length)
61455客服帐号名包含非法字符(仅允许英文+数字)(illegal character in kf_account)
61456客服帐号个数超过限制(10个客服账号)(kf_account count exceeded)
61457无效头像文件类型(invalid file type)
61450系统错误(system error)
61500日期格式错误
61501日期范围错误
9001001POST数据参数不合法
9001002远端服务不可用
9001003Ticket不合法
9001004获取摇周边用户信息失败
9001005获取商户信息失败
9001006获取OpenID失败
9001007上传文件缺失
9001008上传素材的文件类型不合法
9001009上传素材的文件尺寸不合法
9001010上传失败
9001020帐号不合法
9001021已有设备激活率低于50%，不能新增设备
9001022设备申请数不合法，必须为大于0的数字
9001023已存在审核中的设备ID申请
9001024一次查询设备ID数量不能超过50
9001025设备ID不合法
9001026页面ID不合法
9001027页面参数不合法
9001028一次删除页面ID数量不能超过10
9001029页面已应用在设备中，请先解除应用关系再删除
9001030一次查询页面ID数量不能超过50
9001031时间区间不合法
9001032保存设备与页面的绑定关系参数错误
9001033门店ID不合法
9001034设备备注信息过长
9001035设备申请参数不合法
9001036查询起始值begin不合法
内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理 点击这里给我发消息
标签： 
相关文章推荐
新的分享
章节导航