1. 程式人生 > >【5000 Stars 福利】微信介面動態 WebApi 使用說明

【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 做一個介紹,可以略過。希望一進步瞭解的朋友可以閱讀《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 錯誤,應當首先排除是否為 40001 錯誤,也就是沒有此介面的許可權,如果您確定許可權無誤,可以加群讓管理員為您排查錯誤。NeuChar 和 SCF 分別有專用QQ群可以加,也歡迎進群交流相關技術:

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