一、獲取用戶列表
公眾號可通過本接口來獲取帳號的關注者列表,關注者列表由一串OpenID(加密后的微信號,每個用戶對每個公眾號的OpenID是唯一的)組成。一次拉取調用最多拉取10000個關注者的OpenID,可以通過多次拉取的方式來滿足需求。
接口調用請求說明
參數 | 是否必須 | 說明 |
---|---|---|
access_token | 是 | 調用接口憑證 |
next_openid | 是 | 第一個拉取的OPENID,不填默認從頭開始拉取 |
返回說明
正確時返回JSON數據包:
參數 | 說明 |
---|---|
total | 關注該公眾賬號的總用戶數 |
count | 拉取的OPENID個數,最大值為10000 |
data | 列表數據,OPENID的列表 |
next_openid | 拉取列表的最后一個用戶的OPENID |
我們定義一個方法獲取用戶列表
在controller中調用這個方法
我們測試一下,看看我們獲取到的關注我們公眾號的用戶列表
二、獲取用戶詳情
在微信開發過程中,我們有時候需要獲取用戶的一些基礎信息,尤其比如微信公眾號和頭像地址。獲取用戶信息主要是通過以下接口:
通過這個接口里的參數 可以看到我們需要先獲得access_token、openid這兩個參數,access_token之前的文章已經說過了,openid是用戶的微信公眾號唯一標識
參數說明
參數 | 是否必須 | 說明 |
---|---|---|
access_token | 是 | 調用接口憑證 |
openid | 是 | 普通用戶的標識,對當前公眾號唯一 |
lang | 否 | 返回國家地區語言版本,zh_CN 簡體,zh_TW 繁體,en 英語 |
openid在用戶關注我們的公眾號時候就可以獲取到,不過在那里openid叫FromUserName
如果接口響應成功,則返回如下:
返回說明
正常情況下,微信會返回下述JSON數據包給公眾號:
參數說明
參數 | 說明 |
---|---|
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 | 只有在用戶將公眾號綁定到微信開放平台帳號后,才會出現該字段。 |
remark | 公眾號運營者對粉絲的備注,公眾號運營者可在微信公眾平台用戶管理界面對粉絲添加備注 |
groupid | 用戶所在的分組ID(兼容舊的用戶分組接口) |
tagid_list | 用戶被打上的標簽ID列表 |
subscribe_scene | 返回用戶關注的渠道來源,ADD_SCENE_SEARCH 公眾號搜索,ADD_SCENE_ACCOUNT_MIGRATION 公眾號遷移,ADD_SCENE_PROFILE_CARD 名片分享,ADD_SCENE_QR_CODE 掃描二維碼,ADD_SCENE_PROFILE_ LINK 圖文頁內名稱點擊,ADD_SCENE_PROFILE_ITEM 圖文頁右上角菜單,ADD_SCENE_PAID 支付后關注,ADD_SCENE_OTHERS 其他 |
qr_scene | 二維碼掃碼場景(開發者自定義) |
qr_scene_str | 二維碼掃碼場景描述(開發者自定義) |
這里先貼出所有的依賴