由于微信官方去年12月是已經(jīng)不再輸出粉絲的昵稱和頭像信息,全行業(yè)都受到了影響,所以如果是去年12月27日后關(guān)注的粉絲,都無(wú)法獲取到昵稱和頭像的
獲取用戶基本信息(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)注意,如果開發(fā)者有在多個(gè)公眾號(hào),或在公眾號(hào)、移動(dòng)應(yīng)用之間統(tǒng)一用戶帳號(hào)的需求,需要前往微信開放平臺(tái)(open.weixin.qq.com)綁定公眾號(hào)后,才可利用UnionID機(jī)制來(lái)滿足上述需求。
UnionID機(jī)制說(shuō)明:
開發(fā)者可通過(guò)OpenID來(lái)獲取用戶基本信息。特別需要注意的是,如果開發(fā)者擁有多個(gè)移動(dòng)應(yīng)用、網(wǎng)站應(yīng)用和公眾帳號(hào),可通過(guò)獲取用戶基本信息中的unionid來(lái)區(qū)分用戶的唯一性,因?yàn)橹灰峭粋€(gè)微信開放平臺(tái)帳號(hào)下的移動(dòng)應(yīng)用、網(wǎng)站應(yīng)用和公眾帳號(hào),用戶的unionid是唯一的。換句話說(shuō),同一用戶,對(duì)同一個(gè)微信開放平臺(tái)下的不同應(yīng)用,unionid是相同的。
請(qǐng)注意:?20年6月8日起,用戶關(guān)注來(lái)源“微信廣告(ADD_SCENE_WECHAT_ADVERTISEMENT)”從“其他(ADD_SCENE_OTHERS)”中拆分給出,2021年12月27日之后,不再輸出頭像、昵稱信息。
獲取用戶基本信息(包括UnionID機(jī)制)
開發(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",??????"language":?"zh_CN",??????"subscribe_time":?1382694957,?????"unionid":?"?o6_bmasdasdsad6_2sgVt7hMZOPfL",?????"remark":?"",?????"groupid":?0,?????"tagid_list":[128,2],?????"subscribe_scene":?"ADD_SCENE_QR_CODE",?????"qr_scene":?98765,?????"qr_scene_str":?""?}
參數(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)唯一 |
| language | 用戶的語(yǔ)言,簡(jiǎn)體中文為zh_CN |
| subscribe_time | 用戶關(guān)注時(shí)間,為時(shí)間戳。如果用戶曾多次關(guān)注,則取最后關(guān)注時(shí)間 |
| unionid | 只有在用戶將公眾號(hào)綁定到微信開放平臺(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列表 |
| subscribe_scene | 返回用戶關(guān)注的渠道來(lái)源,ADD_SCENE_SEARCH 公眾號(hào)搜索,ADD_SCENE_ACCOUNT_MIGRATION 公眾號(hào)遷移,ADD_SCENE_PROFILE_CARD 名片分享,ADD_SCENE_QR_CODE 掃描二維碼,ADD_SCENE_PROFILE_LINK 圖文頁(yè)內(nèi)名稱點(diǎn)擊,ADD_SCENE_PROFILE_ITEM 圖文頁(yè)右上角菜單,ADD_SCENE_PAID 支付后關(guān)注,ADD_SCENE_WECHAT_ADVERTISEMENT 微信廣告,ADD_SCENE_REPRINT 他人轉(zhuǎn)載 ,ADD_SCENE_LIVESTREAM 視頻號(hào)直播,ADD_SCENE_CHANNELS 視頻號(hào) , ADD_SCENE_OTHERS 其他 |
| qr_scene | 二維碼掃碼場(chǎng)景(開發(fā)者自定義) |
| qr_scene_str | 二維碼掃碼場(chǎng)景描述(開發(fā)者自定義) |
錯(cuò)誤時(shí)微信會(huì)返回錯(cuò)誤碼等信息,JSON數(shù)據(jù)包示例如下(該示例為AppID無(wú)效錯(cuò)誤):
{"errcode":40013,"errmsg":"invalid?appid"}
批量獲取用戶基本信息
開發(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",?????????????"language":?"zh_CN",???????????????????????"subscribe_time":?1434093047,?????????????"unionid":?"oR5GjjgEhCMJFyzaVZdrxZ2zRRF4",?????????????"remark":?"",?????????????"groupid":?0,????????????"tagid_list":[128,2],????????????"subscribe_scene":?"ADD_SCENE_QR_CODE",????????????"qr_scene":?98765,????????????"qr_scene_str":?""???????},?????????{????????????"subscribe":?0,?????????????"openid":?"otvxTs_JZ6SEiP0imdhpi50fuSZg"????????}????]?}
參數(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)唯一 |
| language | 用戶的語(yǔ)言,簡(jiǎn)體中文為zh_CN |
| subscribe_time | 用戶關(guān)注時(shí)間,為時(shí)間戳。如果用戶曾多次關(guān)注,則取最后關(guān)注時(shí)間 |
| unionid | 只有在用戶將公眾號(hào)綁定到微信開放平臺(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列表 |
| subscribe_scene | 返回用戶關(guān)注的渠道來(lái)源,ADD_SCENE_SEARCH 公眾號(hào)搜索,ADD_SCENE_ACCOUNT_MIGRATION 公眾號(hào)遷移,ADD_SCENE_PROFILE_CARD 名片分享,ADD_SCENE_QR_CODE 掃描二維碼,ADD_SCENE_PROFILE_LINK 圖文頁(yè)內(nèi)名稱點(diǎn)擊,ADD_SCENE_PROFILE_ITEM 圖文頁(yè)右上角菜單,ADD_SCENE_PAID 支付后關(guān)注,ADD_SCENE_WECHAT_ADVERTISEMENT 微信廣告,ADD_SCENE_REPRINT 他人轉(zhuǎn)載 ,ADD_SCENE_LIVESTREAM 視頻號(hào)直播, ADD_SCENE_CHANNELS 視頻號(hào), ADD_SCENE_OTHERS 其他 |
| qr_scene | 二維碼掃碼場(chǎng)景(開發(fā)者自定義) |
| qr_scene_str | 二維碼掃碼場(chǎng)景描述(開發(fā)者自定義) |
錯(cuò)誤時(shí)微信會(huì)返回錯(cuò)誤碼等信息,JSON數(shù)據(jù)包示例如下(該示例為AppID無(wú)效錯(cuò)誤):
{"errcode":40013,"errmsg":"invalid?appid"}
(編輯:小酷)
掃碼添加客服微信
掃碼關(guān)注公眾號(hào)
酷網(wǎng)(大連)科技有限公司
致力于為客戶品牌提供完善解決方案
統(tǒng)一服務(wù)電話:0411-62888851
軟件著作權(quán)證:軟著登字第0824158號(hào)
備案號(hào):遼ICP備14000332號(hào)
增值電信業(yè)務(wù)經(jīng)營(yíng)許可證:遼B2-20240418