微信如何擷取以及儲存介面調用憑證,下面就為大家進行介紹
一、說明
*詳細說明請參考前兩篇文章。
*本文分為三部分:
介面調用憑證access_token的作用以及解釋
如何擷取介面調用憑證access_token
如何?微信文檔所說的“中控伺服器”的實現以儲存access_token
* 本文結束會給出包括本文前三篇文章的所有示範源碼
為什麼要擷取和儲存介面調用憑證access_token
•開始開發-擷取介面調用憑據
◦文檔地址:http://mp.weixin.qq.com/wiki/14/9f9c82c1af308e3b14ba9b973f99a8ba.html
•官網文檔給出這樣解釋:
◦access_token是公眾號的全域唯一票據,公眾號調用各介面時都需使用access_token。開發人員需要進行妥善儲存。access_token的儲存至少要保留512個字元空間。access_token的有效期間目前為2個小時,需定時重新整理,重複擷取將導致上次擷取的access_token失效。
•理解:
◦我們簡單翻閱文檔可以發現,許多進階功能,例如:自訂菜單、素材管理、使用者管理、帳號管理等各種進階功能請求的連結中都有“?access_token=TOKEN”這個參數,這是全域調用參數,微信後台需要根據這個參數確定身份,保證我們的微信公眾號的安全。
◦為了防止公眾號的程式錯誤而引發微信伺服器負載異常,預設情況下,每個公眾號調用介面都不能超過一定限制,這裡微信限制每天2000次。所以,如果我們想要頻繁調用這個參數,需要我們開發人員手動儲存,每個access_token有效期間是2個小時。
擷取介面調用憑證access_token
•官網文檔給出這樣解釋:
◦介面調用請求說明
http請求方式: GET
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
■返回說明
正常情況下,微信會返回下述JSON資料包給公眾號:
{“access_token”:”ACCESS_TOKEN”,”expires_in”:7200}
錯誤時微信會返回錯誤碼等資訊,JSON資料包樣本如下(該樣本為AppID無效錯誤):
{“errcode”:40013,”errmsg”:”invalid appid”}
•理解:
◦GET請求,該方式直接在本地就可以實現。因為只是一個普通的GET請求,類似於訪問網址。所以,不需要上傳該部分代碼到伺服器就可以直接操作。
◦http請求協議是GET請求,說明我們需要通過GET請求擷取返迴流,返迴流是json形式。調用時我們需要攜帶三個參數:grant_type、appid、secret。其中appid和secret是我們微信公眾號關鍵的參數,在前文已經闡述。返回結果分為正確和錯誤兩種結果。【百度:json】
◦其實,我們可以直接在地址欄輸入文檔給的樣本:https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET,我們會看到這樣的資訊:“{“errcode”:40013,”errmsg”:”invalid appid hint: [pQKl0120ic11]”}”,因為這是一個無效的請求,返回的是錯誤的結果。
◦當我們把自己的測試號APPID和APPSECRET替換上面的那兩個參數,會看到這樣的資訊:“{“access_token”:”XrllR3fNf…bADAMIO”,”expires_in”:7200}”,代表擷取成功。
◦現在我們通過java 代碼擷取返迴流,拿取access_token。
•實現
private static final long MAX_TIME = 7200 * 1000;// 微信允許最長Access_token有效時間(ms)private static final String TAG = "WeixinApiTest";// TAGprivate static final String APPID = "wx889b****b3666b0b8";// APPIDprivate static final String SECERT = "6da7676***f0a9f15fbf06027856bb";// 秘鑰/* * 該測試案例示範了如何擷取access_token。 * access_token是公眾號的全域唯一票據,公眾號調用各介面時都需使用access_token。 */@Testpublic void getAccess_token() throws IOException { // 拼接api要求的httpsurl連結 String urlString = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=" + APPID + "&secret=" + SECERT; // 建立一個url URL reqURL = new URL(urlString); // 拿取連結 HttpsURLConnection httpsConn = (HttpsURLConnection) reqURL .openConnection(); // 取得該串連的輸入資料流,以讀取響應內容 InputStreamReader isr = new InputStreamReader( httpsConn.getInputStream()); // 讀取伺服器的響應內容並顯示 char[] chars = new char[1024]; String reslut = ""; int len; while ((len = isr.read(chars)) != -1) { reslut += new String(chars, 0, len); } isr.close(); /* * 轉化json成javabean。引入了第三方jar:GSON */ Gson gson = new Gson();// 將擷取的json轉化為java中的bean // 注意:Access_token access_token是一個自己建立的javabean Access_token access_token = gson.fromJson(reslut, new Access_token().getClass()); if (access_token.getAccess_token() != null) { System.out.println("擷取的access_token是:" + access_token.getAccess_token()); System.out.println("該access_token的有效時間是:" + access_token.getExpires_in() + "s"); } else { System.out.println(TAG + "擷取access_token失敗,請檢查"); }}
儲存介面調用憑證access_token
•思路
將擷取到的Access_token和目前時間儲存到file裡, 取出時判斷目前時間和儲存裡面的記錄的時間的時間差,如果大於MAX_TIME,重新擷取,並且將擷取到的儲存到file替換原來的內容,如果小於MAX_TIME,直接擷取。
•實現
/* * 該方法實現擷取Access_token、儲存並且只儲存2小時Access_token。如果超過兩個小時重新擷取;如果沒有超過兩個小時,直接擷取。該方法依賴 * :public static String getAccessToken(); * * 思路:將擷取到的Access_token和目前時間儲存到file裡, * 取出時判斷目前時間和儲存裡面的記錄的時間的時間差,如果大於MAX_TIME,重新擷取,並且將擷取到的儲存到file替換原來的內容 * ,如果小於MAX_TIME,直接擷取。 */ @Test public void getSavedAccess_token() throws IOException { Gson gson = new Gson(); String mAccess_token = null;// 需要擷取的Access_token; File file = new File("temp_access_token.temp");// Access_token儲存的位置 // 如果檔案不存在,建立 if (!file.exists()) file.createNewFile(); // 如果檔案大小等於0,說明第一次使用,存入Access_token if (file.length() == 0) { mAccess_token = getAccessToken(); FileOutputStream fos = new FileOutputStream(file, false);// 不允許追加 Access_token at = new Access_token(); at.setAccess_token(mAccess_token); at.setExpires_in(System.currentTimeMillis() + ""); String json = gson.toJson(at); fos.write((json).getBytes()); fos.close(); } else { // 讀取檔案內容 FileInputStream fis = new FileInputStream(file); byte[] b = new byte[2048]; int len = fis.read(b); String mJsonAccess_token = new String(b, 0, len);// 讀取到的檔案內容 Access_token access_token = gson.fromJson(mJsonAccess_token, new Access_token().getClass()); if (access_token.getExpires_in() != null) { long saveTime = Long.parseLong(access_token.getExpires_in()); long nowTime = System.currentTimeMillis(); long remianTime = nowTime - saveTime; // System.out.println(TAG + "時間差:" + remianTime); if (remianTime < MAX_TIME) { Access_token at = gson.fromJson(mJsonAccess_token, new Access_token().getClass()); mAccess_token = at.getAccess_token(); } else { mAccess_token = getAccessToken(); FileOutputStream fos = new FileOutputStream(file, false);// 不允許追加 Access_token at = new Access_token(); at.setAccess_token(mAccess_token); at.setExpires_in(System.currentTimeMillis() + ""); String json = gson.toJson(at); fos.write((json).getBytes()); fos.close(); } } } System.out.println("擷取到的Access_token是:" + mAccess_token); } /* * 擷取微信伺服器AccessToken。該部分和getAccess_token() 一致,不再加註釋 */ public static String getAccessToken() { String urlString = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=" + APPID + "&secret=" + SECERT; String reslut = null; try { URL reqURL = new URL(urlString); HttpsURLConnection httpsConn = (HttpsURLConnection) reqURL .openConnection(); InputStreamReader isr = new InputStreamReader( httpsConn.getInputStream()); char[] chars = new char[1024]; reslut = ""; int len; while ((len = isr.read(chars)) != -1) { reslut += new String(chars, 0, len); } isr.close(); } catch (IOException e) { e.printStackTrace(); } Gson gson = new Gson(); Access_token access_token = gson.fromJson(reslut, new Access_token().getClass()); if (access_token.getAccess_token() != null) { return access_token.getAccess_token(); } else { return null; } }
前三篇文章示範源碼:http://xiazai.jb51.net/201606/yuanma/WeixinApiDemo(jb51.net).rar
以上就是本文的全部內容,希望對大家的學習有所協助,也希望大家多多支援雲棲社區。