如何使用Postman調試HMS Core推送介面？
- 2022 年 9 月 5 日
- 筆記
HMS Core推送服務支援開發者使用HTTPS協議接入Push服務端。Postman是一款介面測試工具，它可以模擬用戶發起的各類HTTP請求，將請求數據發送至服務端，獲取對應的響應結果。Postman可以模擬開發者伺服器申請Access Token，調用鑒權等介面的請求。
因此有很多開發者在測試端側推送效果或定位推送問題時都會選擇使用Postman測試推送介面。例如，開發者想使用介面推送測試消息但又不方便直接使用應用正式服務端推送時，就可以使用Postman模擬服務端的推送請求。或者服務端介面調試不通，又不確定是不是參數有問題，就可以用postman驗證一下請求是否成功。本文將介紹使用Postman調用HMS Core推送介面的具體操作步驟。
一、Postman下載安裝
下載地址：//www.postman.com/downloads/，點擊Download，下載對應版本，然後安裝。本文使用的是v7.36.1版本。
如果網路使用了代理，需要給Postman配置代理（如網路沒有代理，請忽略）：
- 打開File菜單，點擊Settings菜單，彈出設置介面。
- 在設置介面選中Proxy，配置您的網路代理。
二、調用鑒權介面，獲取Access Token。
- 在Postman新建一個Tab，輸入介面地址，選擇POST方式：
post地址：//oauth-login.cloud.huawei.com/oauth2/v3/token
- 選擇body，勾選「x-www-form-urlencoded」，然後在下方列表裡輸入參數名稱和對應的值。
三個參數說明如下：
grant_type——固定值「client_credentials」。
client_id——對於AppGallery Connect類應用，該值為應用中OAuth 2.0客戶端ID（憑據）的Client ID。
client_secret——對於AppGallery Connect類應用，該值為應用中OAuth 2.0客戶端ID（憑據）的Client Secret。
- 點擊send，就可以調用介面返回access_token了，如下圖所示：
- 保存調試配置，按下ctrl+s，輸入名字「Get Token」，新建目錄「push」，即可保存。
三、調用消息推送介面發送Push消息
- 在Postman新建一個Tab，輸入介面地址（將[appid]替換為實際的appid），選擇POST方式：
post地址：//push-api.cloud.huawei.com/v1/[appId]/messages:send
- 選擇Authorization，TYPE選擇「Bearer Token」，然後在Token輸入框中輸入二中獲取的access_token，如下圖：
- 選擇Body，選中「raw」，下拉框選擇「JSON」，然後在下方輸入框中複製消息內容，點擊send，就可以發送消息了，如下圖：
- 保存調試配置，按下ctrl+s，輸入名字「Send Message」，保存在目錄「push」下即可。
四、使用Postman生成其他常用工具/語言的命令
使用Postman已有的調試成功的介面，可以自動生成其他工具的命令，如常用的cURL、Nodejs、Python、Ruby等，可以直接複製使用。
獲取方式：在窗口右邊，點擊Code，即可彈出命令頁面，可以選擇自己需要的語言的命令。
最後附上使用Postman導出的實例文件，有需要的開發者可以直接導入測試。
了解更多詳情>>
訪問華為開發者聯盟官網
獲取開發指導文檔
華為移動服務開源倉庫地址：GitHub、Gitee
關注我們，第一時間了解 HMS Core 最新技術資訊~
