獲取用戶基本信息(UnionID機(jī)制)
獲取用戶基本信息(UnionID機(jī)制)
在關(guān)注者與公眾號產(chǎn)生消息交互后，公眾號可獲得關(guān)注者的OpenID（加密后的微信號，每個用戶對每個公眾號的OpenID是唯一的。對于不同公眾號，同一用戶的openid不同）。公眾號可通過本接口來根據(jù)OpenID獲取用戶基本信息，包括昵稱、頭像、性別、所在城市、語言和關(guān)注時間。
請注意，如果開發(fā)者有在多個公眾號，或在公眾號、移動應(yīng)用之間統(tǒng)一用戶帳號的需求，需要前往微信開放平臺（open.weixin.qq.com）綁定公眾號后，才可利用UnionID機(jī)制來滿足上述需求。
UnionID機(jī)制說明：
開發(fā)者可通過OpenID來獲取用戶基本信息。特別需要注意的是，如果開發(fā)者擁有多個移動應(yīng)用、網(wǎng)站應(yīng)用和公眾帳號，可通過獲取用戶基本信息中的unionid來區(qū)分用戶的唯一性，因?yàn)橹灰峭粋€微信開放平臺帳號下的移動應(yīng)用、網(wǎng)站應(yīng)用和公眾帳號，用戶的unionid是唯一的。換句話說，同一用戶，對同一個微信開放平臺下的不同應(yīng)用，unionid是相同的。
獲取用戶基本信息（包括UnionID機(jī)制）
開發(fā)者可通過OpenID來獲取用戶基本信息。請使用https協(xié)議。
接口調(diào)用請求說明
http請求方式: GET https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN
參數(shù)說明
| 參數(shù) | 是否必須 | 說明 |
| access_token | 是 | 調(diào)用接口憑證 |
| openid | 是 | 普通用戶的標(biāo)識，對當(dāng)前公眾號唯一 |
| lang | 否 | 返回國家地區(qū)語言版本，zh_CN 簡體，zh_TW 繁體，en 英語 |
返回說明
正常情況下，微信會返回下述JSON數(shù)據(jù)包給公眾號：
"subscribe": 1,
"openid": "o6_bmjrPTlm6_2sgVt7hMZOPfL2M",
"nickname": "Band",
"sex": 1,
"language": "zh_CN",
"city": "廣州",
"province": "廣東",
"country": "中國",
"headimgurl": "http://wx.qlogo.cn/mmopen/g3MonUZtNHkdmzicIlibx6iaFqAc56vxLSUfpb6n5WKSYVY0ChQKkiaJSgQ1dZuTOgvLLrhJbERQQ4
eMsv84eavHiaiceqxibJxCfHe/0",
"subscribe_time": 1382694957,"unionid": " o6_bmasdasdsad6_2sgVt7hMZOPfL"
"remark": "",
"groupid": 0,
"tagid_list":[128,2]
}參數(shù)說明
| 參數(shù) | 說明 |
| subscribe | 用戶是否訂閱該公眾號標(biāo)識，值為0時，代表此用戶沒有關(guān)注該公眾號，拉取不到其余信息。 |
| openid | 用戶的標(biāo)識，對當(dāng)前公眾號唯一 |
| nickname | 用戶的昵稱 |
| sex | 用戶的性別，值為1時是男性，值為2時是女性，值為0時是未知 |
| city | 用戶所在城市 |
| country | 用戶所在國家 |
| province | 用戶所在省份 |
| language | 用戶的語言，簡體中文為zh_CN |
| headimgurl | 用戶頭像，最后一個數(shù)值代表正方形頭像大?。ㄓ?、46、64、96、132數(shù)值可選，0代表640*640正方形頭像），用戶沒有頭像時該項(xiàng)為空。若用戶更換頭像，原有頭像URL將失效。 |
| subscribe_time | 用戶關(guān)注時間，為時間戳。如果用戶曾多次關(guān)注，則取最后關(guān)注時間 |
| unionid | 只有在用戶將公眾號綁定到微信開放平臺帳號后，才會出現(xiàn)該字段。 |
| remark | 公眾號運(yùn)營者對粉絲的備注，公眾號運(yùn)營者可在微信公眾平臺用戶管理界面對粉絲添加備注 |
| groupid | 用戶所在的分組ID（兼容舊的用戶分組接口） |
| tagid_list | 用戶被打上的標(biāo)簽ID列表 |
錯誤時微信會返回錯誤碼等信息，JSON數(shù)據(jù)包示例如下（該示例為AppID無效錯誤）:
批量獲取用戶基本信息
開發(fā)者可通過該接口來批量獲取用戶基本信息。最多支持一次拉取100條。
接口調(diào)用請求說明
http請求方式: POST
https://api.weixin.qq.com/cgi-bin/user/info/batchget?access_token=ACCESS_TOKEN
POST數(shù)據(jù)示例
"user_list": [
{
"openid": "otvxTs4dckWG7imySrJd6jSi0CWE",
"lang": "zh-CN"
},
{
"openid": "otvxTs_JZ6SEiP0imdhpi50fuSZg",
"lang": "zh-CN"
}
]
}
參數(shù)說明
| 參數(shù) | 是否必須 | 說明 |
| openid | 是 | 用戶的標(biāo)識，對當(dāng)前公眾號唯一 |
| lang | 否 | 國家地區(qū)語言版本，zh_CN 簡體，zh_TW 繁體，en 英語，默認(rèn)為zh-CN |
返回說明
正常情況下，微信會返回下述JSON數(shù)據(jù)包給公眾號（示例中為一次性拉取了2個openid的用戶基本信息，第一個是已關(guān)注的，第二個是未關(guān)注的）：
"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/xbIQx1GRqdvyqkMMhEaGOX802l1CyqMJNgUzKP8MeAeHFicRDSnZH7FY4XB7p8XHXIf6uJA2SCun
TPicGKezDC4saKISzRj3nz/0",
"subscribe_time": 1434093047,"unionid": "oR5GjjgEhCMJFyzaVZdrxZ2zRRF4",
"remark": "",
"groupid": 0,
"tagid_list":[128,2]
{
"subscribe": 0,
"openid": "otvxTs_JZ6SEiP0imdhpi50fuSZg",
"unionid": "oR5GjjjrbqBZbrnPwwmSxFukE41U",
}
]
}
參數(shù)說明
| 參數(shù) | 說明 |
| subscribe | 用戶是否訂閱該公眾號標(biāo)識，值為0時，代表此用戶沒有關(guān)注該公眾號，拉取不到其余信息，只有openid和UnionID（在該公眾號綁定到了微信開放平臺賬號時才有）。 |
| openid | 用戶的標(biāo)識，對當(dāng)前公眾號唯一 |
| nickname | 用戶的昵稱 |
| sex | 用戶的性別，值為1時是男性，值為2時是女性，值為0時是未知 |
| city | 用戶所在城市 |
| country | 用戶所在國家 |
| province | 用戶所在省份 |
| language | 用戶的語言，簡體中文為zh_CN |
| headimgurl | 用戶頭像，最后一個數(shù)值代表正方形頭像大?。ㄓ?、46、64、96、132數(shù)值可選，0代表640*640正方形頭像），用戶沒有頭像時該項(xiàng)為空。若用戶更換頭像，原有頭像URL將失效。 |
| subscribe_time | 用戶關(guān)注時間，為時間戳。如果用戶曾多次關(guān)注，則取最后關(guān)注時間 |
| unionid | 只有在用戶將公眾號綁定到微信開放平臺帳號后，才會出現(xiàn)該字段。 |
| remark | 公眾號運(yùn)營者對粉絲的備注，公眾號運(yùn)營者可在微信公眾平臺用戶管理界面對粉絲添加備注 |
| groupid | 用戶所在的分組ID（暫時兼容用戶分組舊接口） |
| tagid_list | 用戶被打上的標(biāo)簽ID列表 |
錯誤時微信會返回錯誤碼等信息，JSON數(shù)據(jù)包示例如下（該示例為AppID無效錯誤）: