雲計算

CDN之API以及SDK的調用

簡介

阿里雲CDN提供了豐富的API接口,除了控制檯,CDN還開發了多樣化的接口。目前我們推薦用戶使用新版API,詳情請參見新版API參考。同時CDN提供了多語言SDK工具包,並且準備了SDK使用說明,以便用戶瞭解如何獲取、安裝和調用阿里雲SDK。用戶可以單擊CDN SDK下載,並參考文檔去集成。目前CDN提供的SDK如下:Java、Python、PHP、.NET、C或C++、Go。

API調用

CDN的API是RPC風格,用戶可以通過發送HTTP GET請求調用API,並按照接口說明在請求中加入相應請求參數,調用後系統會返回處理結果。CDN支持通過HTTP或HTTPS通道進行請求通信,為了獲得更高的安全性,推薦使用HTTPS通道發送請求。我們提供了API的調用規則,並且提供了使用Java、Python封裝API的示例,具體可以參見API調用方式

SDK調用

由於API調用需要按照調用規則去計算簽名,經常會遇到一些開發者計算簽名錯誤導致無法正常調用API的情況,建議用戶直接使用SDK來調用接口,SDK裡封裝了接口,會自動計算簽名,免去自己計算簽名的困擾。用戶可以直接在OpenAPI Explorer中運行接口,填寫接口私有參數運行成功後,OpenAPI Explorer可以自動生成SDK代碼示例,集成SDK以後調用示例代碼即可。如下圖,在API接口文檔裡單擊"調試"按鈕即可進入調試模式,設置參數以後調試成功可以查看示例代碼。
image.png

注:接口文檔提供了調用接口的錯誤碼,如果出現錯誤時,可以根據具體的錯誤碼以及錯誤解釋查找原因,確認是否是哪個參數傳的不正確。也可以參見這個CDN錯誤代碼彙總匹配錯誤信息。

控制檯查看接口參數

由於CDN控制檯也是通過調用CDN的API接口來實現對CDN的相關操作,因此如果對於調試時調用接口的參數有疑問的時候,可以通過控制檯先去設置相關的功能,然後通過打開瀏覽器Network去看控制檯具體調用了什麼接口,傳了什麼參數,這樣方便理解以便進一步完成自己的開發工作。以刷新功能為例,在控制檯刷新功能頁面下打開Network,然後執行刷新工作,可以看到控制檯調用了RefreshObjectCaches接口,並且在Form Data下面可以看到控制檯調用該接口發的參數。具體可以看下面的圖一和圖二。

image.png

image.png

Leave a Reply

Your email address will not be published. Required fields are marked *