
使用這些基本 REST API 最佳實踐構建出色的 API
2.根據提示填寫相關信息,進行賬戶認證。
3.登錄成功以后就會進入到控制臺頁面。
4.鼠標懸停到頁面右上角用戶區域,可以看到API密鑰。進入API密鑰頁面。
5.進入API密鑰頁面以后可以看到當前賬戶的密鑰信息。如果是新用戶 可以點擊新建按鈕來新建一個密鑰。
6.新建以后就會出現一個私鑰,將私鑰下載下來。這樣就得到了一個新的API密鑰(公鑰和私鑰)。
在獲取API密鑰后,進行可用性測試是確保其正常工作的重要步驟。以下是使用curl進行測試的一個案例
青云的簽名可以使用 API 密鑰或 IAM 身份來完成。用戶根據需求,任選一種合適的簽名方式即可。
關于如何生成簽名這里不做過多解釋,請參考計算簽名。
以下接口為 青云QingCloud 開放平臺接口中云服務器中的 獲取一個或多個云服務器接口
重要參數:
access_key_id: 公鑰
signature:通過公鑰和私鑰得到的簽名
輸入:
https://api.qingcloud.com/iaas/?access_key_id=QYACCESSKEYIDEXAMPLE
&action=DescribeInstances
&expires=2013-08-29T07%3A42%3A25Z
&limit=20
&signature_method=HmacSHA256
&signature_version=1
&status.1=running
&time_stamp=2013-08-29T06%3A42%3A25Z
&version=1
&zone=pek3b
&signature=ihPnXFgsg5yyqhDN2IejJ2%2Bbo89ABQ1UqFkyOdzRITY%3D
輸出:
你將得到一個JSON格式的響應,其中包含了實例的詳細信息,如當前實例的vCPU數目、實例所關聯的虛擬網絡列表、當前實例的內存、實例的創建時間、關聯的鏡像信息等。
{
"action":"DescribeInstancesResponse",
"instance_set":[
? {
? ? "vcpus_current":1,
? ? "instance_id":"i-ogbndull",
? ? "vxnets":[
? ? ? {
? ? ? ? "vxnet_name":"primary vxnet",
? ? ? ? "vxnet_type":1,
? ? ? ? "vxnet_id":"vxnet-0",
? ? ? ? "nic_id":"52:54:ef:0c:ed:66",
? ? ? ? "private_ip":"10.50.13.54"
? ? ? }
? ? ],
? ? "memory_current":1024,
? ? "sub_code":0,
? ? "transition_status":"",
? ? "instance_name":"",
? ? "instance_type":"c1m1",
? ? "create_time":"2013-08-28T14:26:03Z",
? ? "status":"running",
? ? "status_time":"2013-08-28T14:26:03Z",
? ? "image":{
? ? ? "processor_type":"64bit",
? ? ? "platform":"linux",
? ? ? "image_size":20,
? ? ? "image_name":"CentOS 6.4 64bit",
? ? ? "image_id":"centos64x64",
? ? ? "os_family":"centos",
? ? ? "provider":"system"
? ? },
? ? "description":null
? }
],
"ret_code":0,
"total_count":1
}
在使用 青云QingCloud 開放平臺 API搭建應用時,除了獲取和測試API密鑰外,還需考慮以下因素:
在調用 API 之前,用戶需要先在青云控制臺申請 API 密鑰。API 密鑰由 API 密鑰 ID access_key_id
和 API 密鑰的私鑰 secret_access_key
兩部分組成。
access_key_id
將作為參數包含在每一個請求中發送。secret_access_key
用于生成請求串的簽名。因此,出于安全考慮,青云提醒用戶,需妥善保管 secret_access_key
,請勿外傳。2000次/3600秒
,未來會開放更高的配額。100
,即便你傳了更大的 limit
。因此,當您需要獲取很多的數據時,請根據返回的 total_sum
進行分批獲取。青云的 API 請求主要分為 延遲請求
和 實時請求
兩種。
錯誤類型 | 說明 |
---|---|
客戶端錯誤 | 通常是由于用戶提交的 API 請求不符合規范導致的,請確認用戶提交的 API 請求是否符合標準。 |
License 錯誤 | 授權證書存在問題,請檢查授權證書是否正確。 |
服務器端錯誤 | 問題出在服務器端。 |
配置文件錯誤 | 表示配置文件中的某項配置內容存在問題,請確認配置是否正確。 |
在申請和使用 青云QingCloud 開放平臺 API密鑰過程中,你可能會遇到以下常見問題:
云服務器關機后云服務器是否收費? 當云服務器關機后,只收取系統盤的費用,按照系統盤的占用空間收費,收費標準同硬盤,CPU / 內存則不再收費。
除此以外,青云其他資源的收費規則如下:
公網 IP 是從申請后就開始收費,不論是否處于使用狀態。因為這個 IP 一旦被申請,別人就不能再占用。
硬盤、自有鏡像都是從創建時起開始收費,直到刪除。
路由器、負載均衡器只在啟動后收費,關閉后便停止計費。
防火墻、密鑰、私有網絡都是免費的。
為什么 80 端口被禁用? 根據上級網管要求,對于一些對備案要求較為嚴格的區域,用戶需要完成備案才能使用 80 端口提供服務,在完成備案之前,80 端口將被禁用。在完成備案流程之后,用戶需要將申請到的備案號填入公網 IP 對應的 ICP 備案 信息字段中(具體操作在公網 IP 的右鍵菜單 設置 ICP 備案信息 中),待管理員審核通過之后,才能正常使用 80 端口的服務。
如何上傳較大的文件?
可以使用 PUT 方法上傳,如果文件很大的話,還可以考慮使用分段上傳 API。
PUT 方法上傳的 Object 允許最大 5GB;分段上傳的 Object 最大可達 50TB,每個分段最大為 5GB。如果通過廣域網上傳,對象存儲建議幾百兆以上大小的文件都使用分段上傳。
如何批量取消未完成的分段上傳?
使用對象存儲的應用通常會使用分段上傳,假如初始化了分段上傳后未調用完成分段上傳,或者終止分段上傳的 API 接口,這些未完成的上傳記錄仍然會占用 Bucket 空間。
對于大量的未完成分段上傳,可通過配置生命周期規則自動刪除。
在獲得 青云QingCloud 開放平臺 API密鑰之后,即可使用平臺提供的各種功能,本文整理了多篇使用 青云QingCloud 開放平臺 的案例,幫助讀者更有效的了解青云QingCloud 開放平臺 :
云服務器、VPC 網絡、對象存儲、云硬盤、網絡服務、云解析 DNS
問題1: 什么是冪簡集成平臺?
冪簡集成是蜜堂有信在2023年打造的一款SAAS產品,建設著國內最全的API平臺,為開發者提供全面、高效、易用的API集成管理方案,一站搜索、試用、集成國內和國外API。讓用戶在AI時代全方位接入互聯網,用API連接一切服務和算力,實現價值倍增。
問題2:如何找到 青云QingCloud 開放平臺
冪簡API平臺可以通過以下兩種方式找到所需API:通過關鍵詞搜索API(例如,輸入’ 青云QingCloud 開放平臺 ‘這類品類詞,更容易找到結果)、或者從API hub分類頁進入尋找。
問題3: 青云QingCloud 開放平臺 的替代品有哪些?
市場上存在免費、付費兩種替代者
例如
更多競品可以在 青云QingCloud 開放平臺找到。
本文總結了獲取青云QingCloud開放平臺API密鑰的詳細步驟,從訪問官方網站注冊登錄到個人認證,再到生成和下載API密鑰,并進行初步的可用性測試,幫助開發者了解如何有效集成到平臺中。同時,還探討了在使用過程中需要注意的其他關鍵因素,如請求簽名、數據返回限制、錯誤處理等,確保在構建應用時能夠順利使用API功能。