微信開放批量獲取用戶基本信息接口，你還在一個個獲取用戶基本信息嗎，是時候change了

在關注者與公衆號產生消息交互後，公衆號可得到關注者的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、4六、6四、9六、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、4六、6四、9六、132數值可選，0表明640*640正方形頭像），用戶沒有頭像時該項爲空。若用戶更換頭像，原有頭像URL將失效。
subscribe_time	用戶關注時間，爲時間戳。若是用戶曾屢次關注，則取最後關注時間
unionid	只有在用戶將公衆號綁定到微信開放平臺賬號後，纔會出現該字段。詳見：獲取用戶我的信息（UnionID機制）
remark	公衆號運營者對粉絲的備註，公衆號運營者可在微信公衆平臺用戶管理界面對粉絲添加備註
groupid	用戶所在的分組ID

錯誤時微信會返回錯誤碼等信息，JSON數據包示例以下（該示例爲AppID無效錯誤）:

{"errcode":40013,"errmsg":"invalid appid"}