Java公眾號開發（一）：獲取access_token

2024-04-02資訊

1、 access_token介紹

access_token是公眾號的全域唯一介面呼叫憑據，公眾號開發呼叫各介面時都需使用access_token。access_token的儲存至少要保留512個字元空間。有效期目前為2個小時，如果超時需要重復獲取新的token，那麽上次獲取的access_token也會失效，其實這也是一種安全機制，只允許有一個有效的token。

2、請求說明

https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

參數名稱	是否必須	說明
grant_type	是	預設值client_credential
appid	是	第三方使用者唯一憑證，appid
secret	是	第三方使用者唯一憑證金鑰，即appsecret

3、響應說明

正常返回

{ "access_token":"ACCESS_TOKEN", "expires_in":7200 }

說明：expires_in返回值為7200秒，就是有效期兩個小時

錯誤返回

{ "errcode":40013, "errmsg":"invalid appid" }

4、請求錯誤編碼介紹

返回碼	說明
-1	系統繁忙，此時請開發者稍候再試
0	請求成功
40001	AppSecret錯誤或者AppSecret不屬於這個公眾號，請開發者確認AppSecret的正確性
40002	請確保grant_type欄位值為client_credential
40164	呼叫介面的IP地址不在白名單中，請在介面IP白名單中進行設定。
89503	此IP呼叫需要管理員確認,請聯系管理員
89501	此IP正在等待管理員確認,請聯系管理員
89506	24小時內該IP被管理員拒絕呼叫兩次，24小時內不可再使用該IP呼叫
89507	1小時內該IP被管理員拒絕呼叫一次，1小時內不可再使用該IP呼叫

5、開發範例

5.1 參照依賴包

首先開啟公眾號建立一個maven計畫，建立完成後引入hutool依賴包，方面後續http請求和字串操作。

內容如下：

 <dependencies> <dependency> <groupId>cn.hutool</groupId> <artifactId>hutool-all</artifactId> <version>5.8.22</version> </dependency> </dependencies>

5.2 程式碼範例

import cn.hutool.core.util.StrUtil; import cn.hutool.http.HttpUtil; import cn.hutool.json.JSONObject; import cn.hutool.json.JSONUtil; /** * 小程式開發第一步獲取微信Token */ public class Demo01_GetToken { // 建議放在配置檔裏面，這裏只是演示 private static String token_url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={}&secret={}"; private final static String appid = "你的appid"; private final static String secret = "你的secret"; public static void main(String[] args) { // 獲取完整的tokenURL String url = StrUtil.format(token_url, appid, secret); // 獲取token String tokenResult = HttpUtil.get(url); System.out.println("獲取token返回結果： " + tokenResult); JSONObject tokenJson = JSONUtil.parseObj(tokenResult); String token = tokenJson.get("access_token").(); System.out.println("輸出公眾號token： " + token); } }