【5000 Stars 福利】微信接口動態 WebApi 使用說明


前言

 

  作為中國 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群可以加,也歡迎進群交流相關技術:

  • NeuChar 技術交流群:618605800 NeuChar 開發交流群
  • SCF 技術交流群:147054579 SCF 開發交流群


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM