前言
作為中國 C# 開源項目中 Watch/Star/Fork 最高的項目之一,Senparc.Weixin SDK 凝聚了盛派微信團隊持續7年的付出,和大量開發者的無私貢獻,以及數萬開發者的使用與反饋。為了紀念 Senparc.Weixin SDK 項目突破 5000 Stars 這個小小的里程碑,盛派微信團隊為大家准備了一份特殊福利:微信接口動態 WebApi 系統(以下簡稱“系統”),在此系統中,您可以使用 WebApi 調用 Senparc.Weixin SDK 已經集成的微信高級接口,用於各項接口測試,或完成緊急情況下的微信功能操作。
訂閱APP
為了確保安全性,此系統已經集成到 NeuChar 系統中作為 APP 進行訂閱,然后進行自動授權訪問,因此您需要首先打開 NeuChar 首頁:https://www.neuchar.com,點擊右上方【登錄 NeuChar 管理中心】:
網頁會跳轉到 https://weixin.senparc.com 域名下進行統一登錄,如果您已經注冊過,可以使用微信掃描二維碼登陸,如果沒有,請進行注冊,並在注冊成功后,再次登陸 https://www.neuchar.com:
登陸成功后,進入 NeuChar 后台:
如果您是新注冊用戶,此時如果您點擊左側,會看到系統已經為您添加了一個微信管理賬號(也叫【NeuChar Cell 賬號】),有了至少一個 NeuChar Cell,就可以進入下一步開始訂閱 App。
您可以用它進行微信菜單設置等操作,希望一進步了解的朋友可以閱讀《NeuChar 平台使用及開發教程 索引》,其他功能和本文無關。
點擊左側菜單按鈕,出現【應用商店】中的 APP 列表:
在【應用商店】中選擇【微信 API Swagger 文檔】應用:
選擇需要訂閱的【NeuChar Cell 賬號】,點擊【立即訂閱】:
因為目前此 APP 限免,您不需要支付任何費用,點擊【確定按鈕】,完成訂閱(您也可以選擇多個月的訂閱時間):
您會看到一個授權通知界面:
系統會為您自動跳到應用首頁:
可以看到,這個站點使用了 SCF 作為模板,今后我們將以 SCF 為模板為大家獻上開源的 NeuChar App Sample,大家可以在此 Sample 基礎上開發類似的 NeuChar App。
本系統所使用的動態 API 核心也將在未來集成到 SCF ,開源給大家。
使用 Swagger 微信 API
點擊頂部【API 文檔】按鈕,稍等片刻,即可看到完整的已被 Senparc.Weixin SDK 集成的接口文檔,並且已經自動按照接口分類進行了分組,點擊任意一個分組標簽,就可以展開下面所有的接口:
為了能夠使用高級接口,我們首先需要調用【CommonApi】下的 【GetToken】,以獲取 AccessToken:
點擊按鈕,自動出現接口參數:
注意:如果您使用的是測試號(https://mp.weixin.qq.com/debug/cgi-bin/sandboxinfo?action=showinfo&t=sandbox/index),不需要進行任何設置,如果您使用的是正式的公眾號,需要在微信后台添加IP白名單:121.201.3.83。
點擊【Execute】按鈕,即可看到微信結果:
上圖紅框中已經獲取到 access_token,將后面字符串中的值復制出來,以備后用。
注意:如果沒有完成之前從 NeuChar 的授權登錄過程,系統將拒絕服務,返回錯誤信息:
有了 AccessToken,我們就可以用其調用任意接口,當然,如果 AccessToken 錯誤,則可能返回 500 錯誤消息。
例如我們使用Url轉短連接的接口:
可以看到接口訪問成功,把 https://www.neuchar.com 轉成了 https://w.url.cn/s/A8qKZEi,大家也可以測試一下。
除了單個 AccessToken 的接口,我們還可以調用多參數的接口,例如嘗試一下客服接口:
如上圖輸入 AccessToken 以及本人的 OpenId,和想要發送的客服消息,微信客戶端立即響應到了這條請求。
可能您也已經發現,Swagger 頁面的右上角,有一個下拉菜單,其中提供了微信公眾號、小程序、開放平台、企業號的接口篩選,且每個選項右側標有當前系統所使用的微信模塊的版本號,方便大家使用!
PS:由於安全問題,微信支付暫時未集成到系統中。
特別說明:在所有參數正確的情況下(包括 AccessToken),調用接口如果出現 500 錯誤,應當首先排除是否為 48001 錯誤,也就是沒有此接口的權限,如果您確定權限無誤,可以加群讓管理員為您排查錯誤。NeuChar 和 SCF 分別有專用QQ群可以加,也歡迎進群交流相關技術: