步驟一：查看OpenAPI文檔

在調用OpenAPI前，建議您先閱讀對應接口文檔，了解、學習調用該接口所需要的參數及權限等，更多信息請參見API概覽。

步驟二：創建RAM用戶并完成授權

如您已創建RAM用戶且已完成授權，可跳過此步驟。

• 使用阿里云賬號登錄RAM控制臺。

• 創建RAM用戶。

  • 在左側導航欄，選擇身份管理 > 用戶。

  • 在用戶頁面，單擊創建用戶。

  • 在創建用戶頁面，設置登錄名稱和顯示名稱，設置訪問方式為控制臺訪問和OpenAPI調用訪問 ，單擊確定。

    重要

    RAM用戶的AccessKey Secret只在創建時顯示，不支持查看，請下載CSV文件后妥善保管。

    創建RAM用戶成功后，請記錄用戶登錄名稱和密碼。在調用OpenAPI時，需要使用該RAM用戶登錄阿里云OpenAPI開發者門戶，并使用該RAM用戶的AccessKey進行代碼調試。

• 為RAM用戶授權。

  說明

  創建RAM用戶后，該RAM用戶無任何操作CDN的權限。您需要為該RAM用戶授予系統策略（AliyunCDNFullAccess、AliyunCDNReadOnlyAccess）或自定義策略。本案例以授予RAM用戶AliyunCDNReadOnlyAccess策略為例，AliyunCDNReadOnlyAccess策略具備CDN資源的只讀權限。

  • 在用戶頁面，單擊目標RAM用戶對應的添加權限。

  • 在新增授權面板，在系統策略中搜索選中AliyunCDNReadOnlyAccess，然后單擊確認新增授權。

  • 確認授權結果，單擊關閉。

步驟三：調用OpenAPI

• 使用RAM用戶登錄阿里云OpenAPI門戶。

• 選擇云產品為內容分發。

• 在頂部菜單欄，選擇工具中心>在線調試。

• 在左側導航欄，找到并單擊DescribeUserDomains接口，服務地址選擇華東1（杭州），DomainName參數輸入要查詢的域名，如果不輸入會顯示此賬號下所有的域名。

  

• 單擊發起調用。

  在調用結果區域，您可以看到查詢結果、Request Header、Response Header等信息，狀態碼200表示調用成功。

  

步驟四：獲取SDK示例代碼

OpenAPI平臺提供了多種編程語言（Java、Go、Python、Node.js、TypeScript、PHP、C++ 等）的SDK。開發者只需要集成SDK，通過SDK暴露的方法直接調用OpenAPI 。SDK統一封裝了簽名邏輯、超時機制、重試機制，并根據文檔返回結構化 Response 對象，易于開發。

以獲取Java SDK示例代碼為例，其他語言獲取方式相同。

• 在SDK示例頁簽，選擇SDK版本和SDK語言。推薦使用V2.0版本。關于V2.0和V1.0的區別，請參見V1.0 SDK和V2.0 SDK區別。

• 單擊下載完整工程可以下載完整的SDK工程。下載完后完成解壓

  說明

  • 在SDK示例顯示區域的右上角，單擊圖標可以復制SDK示例代碼。

  • 單擊SDK信息，可以獲取SDK包名稱、SDK包版本、SDK包管理平臺、SDK安裝命令等基礎信息，便于您集成開發。

  

步驟五：運行SDK示例代碼

以運行Java SDK示例代碼為例。

1. 打開IntelliJ IDEA，單擊File->Open，選擇解壓后的工程文件夾，等待Maven自動安裝依賴信息。

2. 在調用之前，需要先獲取訪問憑證AccessKey，建議使用前面創建的RAM用戶AccessKey。更多信息，請參見創建RAM用戶的AccessKey。

   重要

   獲取RAM用戶的AccessKey之后，還需要在環境變量中設置AccessKey，具體操作步驟請參見在Linux、macOS和Windows系統配置環境變量。

3. 運行示例代碼。

   雙擊打開Sample，確認無報錯后，運行代碼。

   

4. 查看運行結果。在底部控制臺按下ctrl+f，搜索statusCode，如果看到"statusCode":200表示調用成功。