Spring Boot獲取微信用戶信息的超簡單方法
前言
不知道你是否參加過拼多多上邀請微信好友砍價功能,這個功能實現(xiàn)首先需要考慮的就是獲取微信用戶的信息。獲取用戶信息就是獲取公眾號下微信用戶的信息,今天我就來講講如何從公眾號下獲取微信用戶信息。
需要聲明一點的是獲取微信公眾號下的用戶信息的權(quán)限是服務號才有,個人訂閱號是沒有該權(quán)限的。
獲取公眾號用戶信息實戰(zhàn)
第一步需要先申請接口測試號并進行網(wǎng)頁授權(quán)設(shè)置
訪問如下鏈接進行接口測試號申請。
https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Requesting_an_API_Test_Account.html
選擇接口測試號申請,如下圖所示:
點擊登錄進行掃碼登錄,如下圖所示:
登錄后如下圖所示:
在下面的的網(wǎng)頁賬號一欄添加網(wǎng)頁授權(quán)的IP或者域名。
為了方便測試我這里設(shè)置成了回環(huán)地址,最好設(shè)置成具體的 IP 地址或者域名信息。域名和 IP 地址不要添加http或者https。這里 IP 和域名可以是內(nèi)網(wǎng)地址。
到這里網(wǎng)頁授權(quán)設(shè)置完畢!
第二步是下載微信web開發(fā)者工具,可以在PC 進行測試。
https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Web_Developer_Tools.html
傻瓜式一步一步安裝即可。
第三步 看微信操作教程并完成代碼實現(xiàn)
接下來就是代碼部分編寫了,在開發(fā)前首先需要看一下獲取微信公眾號用戶信息的教程:
通過訪問:https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html 。獲取微信用戶信息具體操作有如下4步。
第一步:用戶同意授權(quán),獲取code
代碼的操作就是拼接引導用戶進行微信授權(quán)地址,然后重定向到微信服務,微信服務在根據(jù)重定向的 URL 地址并攜帶 code 重定向到我們的服務器。這一步需要配置有公眾號 appid 和 redirect_uri 。
需要注意的是重定向的地址需要 encode 以下,具體操作如下面代碼所示:
String url = URLEncoder.encode(request.getRequestURL().toString());
具體地址如下圖所示:紅色框位置需要改為我們公眾號 appid 和 redirect_uri 信息,其他的內(nèi)容不用改動。
程序重定向該地址后會讓用戶進行授權(quán),如下圖所示:
用戶點擊同意后,微信服務會根據(jù)重定向地址重定向回我們的服務中并攜帶code。
第二步就是根據(jù) code 獲取網(wǎng)頁授權(quán) access_token 和 openid。
調(diào)用如下面所示微信 API ,紅色框 code 替換成獲取的 code,其他內(nèi)容不用做任何改動。
第三步:刷新access_token(如果需要)
access_token有效期是7200s,當access_token超時后,可以使用refresh_token進行刷新,refresh_token有效期為30天,當refresh_token失效之后,需要用戶重新授權(quán)。這步可做可不做,我們這里就繞開這步。
第四步:拉取用戶信息(需scope為 snsapi_userinfo)
關(guān)于網(wǎng)頁授權(quán)的兩種scope的區(qū)別說明
1、以snsapi_base為scope發(fā)起的網(wǎng)頁授權(quán),是用來獲取進入頁面的用戶的openid的,并且是靜默授權(quán)并自動跳轉(zhuǎn)到回調(diào)頁的。用戶感知的就是直接進入了回調(diào)頁(往往是業(yè)務頁面)
2、以snsapi_userinfo為scope發(fā)起的網(wǎng)頁授權(quán),是用來獲取用戶的基本信息的。但這種授權(quán)需要用戶手動同意,并且由于用戶同意過,所以無須關(guān)注,就可在授權(quán)后獲取該用戶的基本信息。
根據(jù)第二步獲取的 access_token 和 opendId 獲取微信用戶的信息。調(diào)用如下圖所示微信 API,將獲取的 access_token 和 opendId 替換如下圖中紅色框位置內(nèi)容,其他不用做任何改動。返回的 json 信息就是該公眾好號的用戶信息。
講完操作流程,接下來就是代碼實現(xiàn)。具體獲取微信用戶信息 Controller 內(nèi)容如下:
@RestController @RequestMapping("/weixin") public class WeiXinDemoController { @Autowired private WeiXinService weiXinService; @RequestMapping("/getWeiXinUserInfo") public String getWeiXinUserInfo(String code,HttpServletRequest request,HttpServletResponse response,HttpSession session) throws IOException{ //第一步:用戶同意授權(quán),獲取code if (code == null) { String url = URLEncoder.encode(request.getRequestURL().toString()); String authorizeUrl = weiXinService.buildAuthorizeURL(url); response.sendRedirect(authorizeUrl); return null; } //第二步:通過code換取網(wǎng)頁授權(quán)access_token和openid String htmlInfo = ""; Map<String, Object> openIdInfo = weiXinService.getOpenIdInfo(code); String errcode = (String)openIdInfo.get("errcode"); if(StringUtils.isEmpty(errcode)){ //第四步:拉取用戶信息(需scope為 snsapi_userinfo)根據(jù)access_token和OpenId Map<String, Object> weiXinUserInfo = weiXinService.getWeiXinUserInfo(openIdInfo); String userInfohtml = createUserInfoHtml(weiXinUserInfo); return userInfohtml; } return htmlInfo; }
@Component @ConfigurationProperties(prefix="wx") public class WeiXinConfig { private String appID; private String mchID; private String appsecret; private String key; //省略getter and setter }
application.properties 配置內(nèi)容如下:
微信核心處理都在 WeiXinService中,微信接口調(diào)用時通過 RestTemplate來實現(xiàn)的。
拼接引導用戶進行微信授權(quán)地址代碼如下:
/** * 拼接用戶授權(quán)重定向的URL * @param url * @return */ public String buildAuthorizeURL(String url){ return concatAuthorizeURL(url); } private String concatAuthorizeURL(String url) { StringBuilder authorizeUrl = new StringBuilder(AUTHORIZEURL); authorizeUrl.append("?appid=").append(weiXinConfig.getAppID()); authorizeUrl.append("&redirect_uri=").append(url); authorizeUrl.append("&response_type=code"); //snsapi_base (不彈出授權(quán)頁面,直接跳轉(zhuǎn),只能獲取用戶openid), //snsapi_userinfo (彈出授權(quán)頁面,可通過openid拿到昵稱、性別、所在地。并且, 即使在未關(guān)注的情況下,只要用戶授權(quán),也能獲取其信息 ) authorizeUrl.append("&scope=snsapi_userinfo"); authorizeUrl.append("&state=").append("STATE"); authorizeUrl.append("#wechat_redirect"); return authorizeUrl.toString(); }
根據(jù) code 獲取網(wǎng)頁授權(quán) access_token 和 openid 代碼如下:
/** * 獲取 access_token 和 openid * @param code * @return */ public Map<String,Object> getOpenIdInfo(String code){ String getAccessTokenUrl = concatGetOpenIdInfoURL(code); String json = postRequestForWechat(getAccessTokenUrl); Map<String,Object> map = jsonToMap(json); return map; } private String concatGetOpenIdInfoURL(String code) { StringBuilder getAccessTokenUrl = new StringBuilder(GE_TACCESSTOKEN_URL); getAccessTokenUrl.append("?appid=").append(weiXinConfig.getAppID()); getAccessTokenUrl.append("&secret=").append(weiXinConfig.getAppsecret()); getAccessTokenUrl.append("&code=").append(code); getAccessTokenUrl.append("&grant_type=authorization_code"); return getAccessTokenUrl.toString(); } private String postRequestForWechat(String getAccessTokenUrl) { ResponseEntity<String> postForEntity = restTemplate.postForEntity(getAccessTokenUrl, null, String.class); String json = postForEntity.getBody(); return json; } private Map jsonToMap(String json) { Gson gons = new Gson(); Map map = gons.fromJson(json, new TypeToken<Map>(){}.getType()); return map; }
通過 access_token 和 openid 獲取微信用戶信息 代碼如下:
/** * 獲取微信用戶信息通過 access_token 和 openid * @param map * @return */ public Map getWeiXinUserInfo(Map<String, Object> map) { String getUserInfoUrl = concatGetWeiXinUserInfoURL(map); String json = getRequestForWechat(getUserInfoUrl); Map userInfoMap = jsonToMap(json); return userInfoMap; } private String concatGetWeiXinUserInfoURL(Map<String, Object> map) { String openId = (String) map.get("openid"); String access_token = (String) map.get("access_token"); // 繞過檢驗授權(quán)憑證(access_token)是否有效 StringBuilder getUserInfoUrl = new StringBuilder(GE_USERINFO_URL); getUserInfoUrl.append("?access_token=").append(access_token); getUserInfoUrl.append("&openId=").append(openId); getUserInfoUrl.append("&lang=zh_CN"); return getUserInfoUrl.toString(); } private String getRequestForWechat(String getUserInfoUrl) { ResponseEntity<String> postForEntity = restTemplate.getForEntity(getUserInfoUrl.toString(), String.class); String json = postForEntity.getBody(); return json; }
測試
下載微信web開發(fā)者工具完成后,根據(jù)傻瓜式安裝即可。安裝完成后打開web開發(fā)者工具,如下圖所示選擇公眾號網(wǎng)頁。
輸入 http:127.0.1:8090/sbe2/weixin/getWeiXinUserInfo,就會看到該測試公眾號的用戶信息。
一般情況下我們通過接口測試號配置成測試環(huán)境域名或 IP,測試通過后就可以在服務號上配置網(wǎng)頁授權(quán)域名,順便在把我們項目配置的 appid 換成服務號的 appid 即可。具體操作如下:
小結(jié)
獲取微信公眾號用戶信息步驟就是:第一步拼接引導用戶授權(quán)的地址然后根據(jù)該地址重定向到微信服務,第二步獲取授權(quán)code,根據(jù) code 獲取 access_token 和 OpenId,第三步根據(jù) access_token 和 OpenId 獲取微信用戶信息。
我這里介紹最簡三步,正常來講還需要驗證access_token 是否有效,這一步也可以通過緩存access_token到Reid中并設(shè)置過期時間,當其失效后刷新access_token。
在這里再三強調(diào)一下,微信提供操作文檔一定要多看幾篇,因為很多細節(jié)都在文檔中進行了說明。當你把微信提供操作文檔看透,你就會覺得其實就是個API 調(diào)用而已。
代碼示例
具體代碼示例請查看我的GitHub 倉庫 springbootexamples 中的 spring-boot-2.x-weixin 查看。
GitHub:https://github.com/zhuoqianmingyue/springbootexamples
總結(jié)
以上就是這篇文章的全部內(nèi)容了,希望本文的內(nèi)容對大家的學習或者工作具有一定的參考學習價值,謝謝大家對腳本之家的支持。
- springboot整合微信支付sdk過程解析
- springboot 微信授權(quán)網(wǎng)頁登錄操作流程
- SpringBoot 微信退款功能的示例代碼
- Springboot單體架構(gòu)http請求轉(zhuǎn)換https請求來支持微信小程序調(diào)用接口
- 基于springboot微信公眾號開發(fā)(微信自動回復)
- SpringBoot JS-SDK自定義微信分享的實現(xiàn)
- 微信小程序 springboot后臺如何獲取用戶的openid
- SpringBoot中獲取微信用戶信息的方法
- SpringBoot微信消息接口配置詳解
- activemq整合springboot使用方法(個人微信小程序用)
- Springboot網(wǎng)站第三方登錄 微信登錄
- Spring Boot項目中集成微信支付v3
相關(guān)文章
Java編程細節(jié)重構(gòu)之為什么if-else不是好代碼詳析
這篇文章主要給大家介紹了關(guān)于Java編程細節(jié)重構(gòu)之為什么if-else不是好代碼的相關(guān)資料,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學些學習吧2018-09-09Spring實戰(zhàn)之FileSystemResource加載資源文件示例
這篇文章主要介紹了Spring實戰(zhàn)之FileSystemResource加載資源文件,結(jié)合實例形式分析了spring FileSystemResource加載xml資源文件的具體實現(xiàn)步驟與相關(guān)操作技巧,需要的朋友可以參考下2019-12-12Spring Validation和Hibernate Validator結(jié)合國際化代碼實例
這篇文章主要介紹了Spring Validation和Hibernate Validator結(jié)合國際化代碼實例,我們需要對請求參數(shù)進行非空、長度、正確性進行校驗, 本文主要講解Spring Validation 和 Hibernate Validator, 同時整合i18n(國際化)實現(xiàn)參數(shù)校驗自動,需要的朋友可以參考下2023-10-10spring如何集成cxf實現(xiàn)webservice接口功能詳解
這篇文章主要給大家介紹了關(guān)于spring如何集成cxf實現(xiàn)webservice接口功能的相關(guān)資料,文中通過示例代碼介紹的非常詳細,對大家 的學習或者工作具有一定的參考學習價值,需要的朋友們下面來一起看看吧2018-07-07淺談Java如何實現(xiàn)一個基于LRU時間復雜度為O(1)的緩存
這篇文章主要介紹了淺談Java如何實現(xiàn)一個基于LRU時間復雜度為O(1)的緩存,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧2020-08-08