Senparc.Weixin.MP SDK 微信公衆平臺開發教程(八):通用接口說明

1、基礎說明

    這裏說的「通用接口(CommonAPIs)」是使用微信公衆帳號一系列高級功能的必備驗證功能(應用於開發模式)。html

    咱們經過微信後臺惟一的憑證,向通用接口發出請求,獲得訪問令牌(AccessToken),而後使用訪問令牌去使用各項須要身份驗證的高級功能,例如自定義菜單、獲取用戶信息、單發消息、羣發消息等等。git

    目前所有的服務號經過認證的訂閱號,均可以在微信公衆帳號後臺的【功能】>【高級功能】>【開發模式】下的「開發者憑據」一欄找到AppId和AppSecret兩個字符串,這兩個字符串就是得到AccessToken的依據,所以須要嚴格保密,若是發現有泄露的可能,或者出於安全策略,應當使用邊上的「重置」按鈕對AppSecret進行隨機生成(注意AppId不會變化),而且同時修改程序中的對應參數。github

 

2、接口使用

    在Senparc.Weixin.MP SDK中,通用接口的基本方法都在Senparc.Weixin.MP.CommonAPIs命名空間下:web

    文件說明以下:小程序

  AccessTokenContainer.cs - 一個AccessToken容器(幫助自動更新AccessToken,由於每個AccessToken都有一個有效期)安全

  CommonApi.cs - 提供獲取AccessToken的通用方法微信

  CommonApi.Menu.cs - 自定義菜單全部接口websocket

  CommonJsonSend.cs - 對通用接口返回類型的一些封裝處理app

    有關上述類的詳細方法及說明能夠看開源代碼的註釋: https://github.com/JeffreySu/WeiXinMPSDK/tree/master/Senparc.Weixin.MP/Senparc.Weixin.MP/CommonAPIs微信公衆平臺

    有了AccessTokenContainer,咱們能夠直接這樣獲取AccessToken:

if (!AccessTokenContainer.CheckRegistered(appId))//檢查是否已經註冊
{
    AccessTokenContainer.Register(appId, appSecret);//若是沒有註冊則進行註冊
}
var result = AccessTokenContainer.GetAccessTokenResult(appId); //獲取AccessToken結果

  固然也能夠更加簡單地一步到位:

var result = AccessTokenContainer.TryGetAccessToken(appId, appSecret);

  上述獲取到的result有access_token和expires_in兩個屬性,分別儲存了AccessToken字符串和過時時間(秒),若是使用AccessTokenContainer.TryGetAccessToken()方法,則能夠完全忽略的expires_in存在,若是過時,系統會自動從新獲取。

    有了AccessToken,咱們就能夠進行一系列豐富的高級功能操做了,固然也包括自定義菜單,請看隨後文章的介紹(見《Senparc.Weixin.MP SDK 微信公衆平臺開發教程(九):自定義菜單接口說明》)。

    固然,SDK也已經提供了全自動的AccessToken處理機制,包括自動處理(預期外的)AccessToken過時狀況,開發者在調用高級接口的時候只須要提供AppId,忽略AccessToken的存在,相關內容請見《Senparc.Weixin.MP SDK 微信公衆平臺開發教程(十六):AccessToken自動管理機制》。

 

    注意:在v14.2.1中,全部Senparc.Weixin.MP下的Container,命名空間已經從 Senparc.Weixin.MP.CommonAPIs 改成了 Senparc.Weixin.MP.Containers[公告]Senparc.Weixin.MP v14.2.1 升級說明

 

系列教程索引

地址:http://www.cnblogs.com/szw/archive/2013/05/14/weixin-course-index.html

  1. Senparc.Weixin.MP SDK 微信公衆平臺開發教程(一):微信公衆平臺註冊
  2. Senparc.Weixin.MP SDK 微信公衆平臺開發教程(二):成爲開發者
  3. Senparc.Weixin.MP SDK 微信公衆平臺開發教程(三):微信公衆平臺開發驗證
  4. Senparc.Weixin.MP SDK 微信公衆平臺開發教程(四):Hello World
  5. Senparc.Weixin.MP SDK 微信公衆平臺開發教程(五):使用Senparc.Weixin.MP SDK
  6. Senparc.Weixin.MP SDK 微信公衆平臺開發教程(六):瞭解MessageHandler
  7. Senparc.Weixin.MP SDK 微信公衆平臺開發教程(七):解決用戶上下文(Session)問題
  8. Senparc.Weixin.MP SDK 微信公衆平臺開發教程(八):通用接口說明
  9. Senparc.Weixin.MP SDK 微信公衆平臺開發教程(九):自定義菜單接口說明
  10. Senparc.Weixin.MP SDK 微信公衆平臺開發教程(十):多客服接口說明
  11. Senparc.Weixin.MP SDK 微信公衆平臺開發教程(十一):高級接口說明
  12. Senparc.Weixin.MP SDK 微信公衆平臺開發教程(十二):OAuth2.0說明
  13. Senparc.Weixin.MP SDK 微信公衆平臺開發教程(十三):地圖相關接口說明
  14. Senparc.Weixin.MP SDK 微信公衆平臺開發教程(十四):請求消息去重
  15. Senparc.Weixin.MP SDK 微信公衆平臺開發教程(十五):消息加密
  16. Senparc.Weixin.MP SDK 微信公衆平臺開發教程(十六):AccessToken自動管理機制
  17. Senparc.Weixin.MP SDK 微信公衆平臺開發教程(十七):個性化菜單接口說明
  18. Senparc.Weixin.MP SDK 微信公衆平臺開發教程(十八):Web代理功能
  19. Senparc.Weixin.MP SDK 微信公衆平臺開發教程(十九):MessageHandler 的未知類型消息處理
  20. Senparc.Weixin.MP SDK 微信公衆平臺開發教程(二十):使用菜單消息功能
  21. Senparc.Weixin.MP SDK 微信公衆平臺開發教程(二十一):在小程序中使用 WebSocket (.NET Core)
  22. Senparc.Weixin.MP SDK 微信公衆平臺開發教程(二十二):如何安裝 Nuget(dll) 後使用項目源代碼調試
相關文章
相關標籤/搜索