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