3.0獲取介面調用憑據 ①介面說明 access_token是公眾號的全局唯一票據,公眾號調用各介面時都需使用access_token。開發者需要進行妥善保存。access_token的存儲至少要保留512個字元空間。access_token的有效期目前為2h(7200s),需定時刷新,重覆獲取將導
3.0獲取介面調用憑據
①介面說明
access_token是公眾號的全局唯一票據,公眾號調用各介面時都需使用access_token。開發者需要進行妥善保存。access_token的存儲至少要保留512個字元空間。access_token的有效期目前為2h(7200s),需定時刷新,重覆獲取將導致上次獲取的access_token失效。
公眾平臺的API調用所需的access_token的使用及生成方式說明:
1、為了保密appsecrect,第三方需要一個access_token獲取和刷新的中控伺服器。而其他業務邏輯伺服器所使用的access_token均來自於該中控伺服器,不應該各自去刷新,否則會造成access_token覆蓋而影響業務;
2、目前access_token的有效期通過返回的expire_in來傳達,目前是7200秒之內的值。中控伺服器需要根據這個有效時間提前去刷新新access_token。在刷新過程中,中控伺服器對外輸出的依然是老access_token,此時公眾平臺後臺會保證在刷新短時間內,新老access_token都可用,這保證了第三方業務的平滑過渡;
3、access_token的有效時間可能會在未來有調整,所以中控伺服器不僅需要內部定時主動刷新,還需要提供被動刷新access_token的介面,這樣便於業務伺服器在API調用獲知access_token已超時的情況下,可以觸發access_token的刷新流程。
怎麼獲取AppID和AppSecret!?
公眾號可以使用AppID和AppSecret調用本介面來獲取access_token。AppID和AppSecret可在微信公眾平臺官網-開發者中心頁中獲得。(需要已經成為開發者,且帳號沒有異常狀態)
註意:在調用所有微信介面時均使用https協議;還有就是如果第三方不使用中控伺服器,而是使選擇各個業務邏輯點各自去刷新access_taken,那麼就有可能會產生衝突,導致服務不穩定。
②請求介面
介面調用請求說明:
http請求方式:GET
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
介面參數配置:
具體實現代碼如下:
1 /// <summary> 2 /// 獲取公眾號的ACCESS_TOKEN 3 /// </summary> 4 /// <returns>返回操作憑據</returns> 5 public string GetAccessToken() 6 { 7 if (HttpContext.Current.Cache["access_token"] == null) 8 { 9 string para = string.Format("grant_type=client_credential&appid={0}&secret={1}", AppID, AppSecret); 10 string results = SendHTTPRequest("POST", "https://api.weixin.qq.com/cgi-bin/token", para); 11 JObject obj = (JObject)JsonConvert.DeserializeObject(results); 12 13 //*******************************設置access_token的過期機制************************** 14 15 Cache cache = HttpContext.Current.Cache; 16 cache.Insert("access_token", obj["access_token"].ToString(), null, DateTime.Now.AddSeconds(7000),
System.Web.Caching.Cache.NoSlidingExpiration); 17 18 //******************************************end************************************* 19 return HttpContext.Current.Cache["access_token"].ToString(); 20 } 21 else 22 { 23 return HttpContext.Current.Cache["access_token"].ToString(); 24 } 25 }
返回參數說明:
返回說明:
正常情況下,微信會返回下述JSON數據包給公眾號:
{"access_token":"ACCESS_TOKEN","expires_in":7200}
錯誤時微信會返回錯誤碼信息,JSON數據包實示例如下(該示例為AppID無效錯誤):
{"errcode":40013,"errmsg":"invalid appid"}
註意:使用access_token的時候要註意此介面是有調用頻率限制的,當超過了每日最大的調用頻率微信伺服器就會對當前公眾號做介面限制,具體詳情請閱讀官方文檔(微信公眾號介面頻率限制說明)
如果你對《C#微信開發系列》這個系列感興趣的話,可以關註我的其他文章(持續更新中...),系列隨筆地址如下: