安全的關(guān)鍵.png)
使用這些基本 REST API 最佳實(shí)踐構(gòu)建出色的 API
2.根據(jù)提示填寫(xiě)相關(guān)信息,進(jìn)行賬戶認(rèn)證。
3.登錄成功以后就會(huì)進(jìn)入到控制臺(tái)頁(yè)面。
4.鼠標(biāo)懸停到頁(yè)面右上角用戶區(qū)域,可以看到API密鑰。進(jìn)入API密鑰頁(yè)面。
5.進(jìn)入API密鑰頁(yè)面以后可以看到當(dāng)前賬戶的密鑰信息。如果是新用戶 可以點(diǎn)擊新建按鈕來(lái)新建一個(gè)密鑰。
6.新建以后就會(huì)出現(xiàn)一個(gè)私鑰,將私鑰下載下來(lái)。這樣就得到了一個(gè)新的API密鑰(公鑰和私鑰)。
在獲取API密鑰后,進(jìn)行可用性測(cè)試是確保其正常工作的重要步驟。以下是使用curl進(jìn)行測(cè)試的一個(gè)案例
青云的簽名可以使用 API 密鑰或 IAM 身份來(lái)完成。用戶根據(jù)需求,任選一種合適的簽名方式即可。
關(guān)于如何生成簽名這里不做過(guò)多解釋,請(qǐng)參考計(jì)算簽名。
以下接口為 青云QingCloud 開(kāi)放平臺(tái)接口中云服務(wù)器中的 獲取一個(gè)或多個(gè)云服務(wù)器接口
重要參數(shù):
access_key_id: 公鑰
signature:通過(guò)公鑰和私鑰得到的簽名
輸入:
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
輸出:
你將得到一個(gè)JSON格式的響應(yīng),其中包含了實(shí)例的詳細(xì)信息,如當(dāng)前實(shí)例的vCPU數(shù)目、實(shí)例所關(guān)聯(lián)的虛擬網(wǎng)絡(luò)列表、當(dāng)前實(shí)例的內(nèi)存、實(shí)例的創(chuàng)建時(shí)間、關(guān)聯(lián)的鏡像信息等。
{
"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 開(kāi)放平臺(tái) API搭建應(yīng)用時(shí),除了獲取和測(cè)試API密鑰外,還需考慮以下因素:
在調(diào)用 API 之前,用戶需要先在青云控制臺(tái)申請(qǐng) API 密鑰。API 密鑰由 API 密鑰 ID access_key_id
和 API 密鑰的私鑰 secret_access_key
兩部分組成。
access_key_id
將作為參數(shù)包含在每一個(gè)請(qǐng)求中發(fā)送。secret_access_key
用于生成請(qǐng)求串的簽名。因此,出于安全考慮,青云提醒用戶,需妥善保管 secret_access_key
,請(qǐng)勿外傳。2000次/3600秒
,未來(lái)會(huì)開(kāi)放更高的配額。100
,即便你傳了更大的 limit
。因此,當(dāng)您需要獲取很多的數(shù)據(jù)時(shí),請(qǐng)根據(jù)返回的 total_sum
進(jìn)行分批獲取。青云的 API 請(qǐng)求主要分為 延遲請(qǐng)求
和 實(shí)時(shí)請(qǐng)求
兩種。
錯(cuò)誤類型 | 說(shuō)明 |
---|---|
客戶端錯(cuò)誤 | 通常是由于用戶提交的 API 請(qǐng)求不符合規(guī)范導(dǎo)致的,請(qǐng)確認(rèn)用戶提交的 API 請(qǐng)求是否符合標(biāo)準(zhǔn)。 |
License 錯(cuò)誤 | 授權(quán)證書(shū)存在問(wèn)題,請(qǐng)檢查授權(quán)證書(shū)是否正確。 |
服務(wù)器端錯(cuò)誤 | 問(wèn)題出在服務(wù)器端。 |
配置文件錯(cuò)誤 | 表示配置文件中的某項(xiàng)配置內(nèi)容存在問(wèn)題,請(qǐng)確認(rèn)配置是否正確。 |
在申請(qǐng)和使用 青云QingCloud 開(kāi)放平臺(tái) API密鑰過(guò)程中,你可能會(huì)遇到以下常見(jiàn)問(wèn)題:
云服務(wù)器關(guān)機(jī)后云服務(wù)器是否收費(fèi)? 當(dāng)云服務(wù)器關(guān)機(jī)后,只收取系統(tǒng)盤(pán)的費(fèi)用,按照系統(tǒng)盤(pán)的占用空間收費(fèi),收費(fèi)標(biāo)準(zhǔn)同硬盤(pán),CPU / 內(nèi)存則不再收費(fèi)。
除此以外,青云其他資源的收費(fèi)規(guī)則如下:
公網(wǎng) IP 是從申請(qǐng)后就開(kāi)始收費(fèi),不論是否處于使用狀態(tài)。因?yàn)檫@個(gè) IP 一旦被申請(qǐng),別人就不能再占用。
硬盤(pán)、自有鏡像都是從創(chuàng)建時(shí)起開(kāi)始收費(fèi),直到刪除。
路由器、負(fù)載均衡器只在啟動(dòng)后收費(fèi),關(guān)閉后便停止計(jì)費(fèi)。
防火墻、密鑰、私有網(wǎng)絡(luò)都是免費(fèi)的。
為什么 80 端口被禁用? 根據(jù)上級(jí)網(wǎng)管要求,對(duì)于一些對(duì)備案要求較為嚴(yán)格的區(qū)域,用戶需要完成備案才能使用 80 端口提供服務(wù),在完成備案之前,80 端口將被禁用。在完成備案流程之后,用戶需要將申請(qǐng)到的備案號(hào)填入公網(wǎng) IP 對(duì)應(yīng)的 ICP 備案 信息字段中(具體操作在公網(wǎng) IP 的右鍵菜單 設(shè)置 ICP 備案信息 中),待管理員審核通過(guò)之后,才能正常使用 80 端口的服務(wù)。
如何上傳較大的文件?
可以使用 PUT 方法上傳,如果文件很大的話,還可以考慮使用分段上傳 API。
PUT 方法上傳的 Object 允許最大 5GB;分段上傳的 Object 最大可達(dá) 50TB,每個(gè)分段最大為 5GB。如果通過(guò)廣域網(wǎng)上傳,對(duì)象存儲(chǔ)建議幾百兆以上大小的文件都使用分段上傳。
如何批量取消未完成的分段上傳?
使用對(duì)象存儲(chǔ)的應(yīng)用通常會(huì)使用分段上傳,假如初始化了分段上傳后未調(diào)用完成分段上傳,或者終止分段上傳的 API 接口,這些未完成的上傳記錄仍然會(huì)占用 Bucket 空間。
對(duì)于大量的未完成分段上傳,可通過(guò)配置生命周期規(guī)則自動(dòng)刪除。
在獲得 青云QingCloud 開(kāi)放平臺(tái) API密鑰之后,即可使用平臺(tái)提供的各種功能,本文整理了多篇使用 青云QingCloud 開(kāi)放平臺(tái) 的案例,幫助讀者更有效的了解青云QingCloud 開(kāi)放平臺(tái) :
云服務(wù)器、VPC 網(wǎng)絡(luò)、對(duì)象存儲(chǔ)、云硬盤(pán)、網(wǎng)絡(luò)服務(wù)、云解析 DNS
問(wèn)題1: 什么是冪簡(jiǎn)集成平臺(tái)?
冪簡(jiǎn)集成是蜜堂有信在2023年打造的一款SAAS產(chǎn)品,建設(shè)著國(guó)內(nèi)最全的API平臺(tái),為開(kāi)發(fā)者提供全面、高效、易用的API集成管理方案,一站搜索、試用、集成國(guó)內(nèi)和國(guó)外API。讓用戶在AI時(shí)代全方位接入互聯(lián)網(wǎng),用API連接一切服務(wù)和算力,實(shí)現(xiàn)價(jià)值倍增。
問(wèn)題2:如何找到 青云QingCloud 開(kāi)放平臺(tái)
冪簡(jiǎn)API平臺(tái)可以通過(guò)以下兩種方式找到所需API:通過(guò)關(guān)鍵詞搜索API(例如,輸入’ 青云QingCloud 開(kāi)放平臺(tái) ‘這類品類詞,更容易找到結(jié)果)、或者從API hub分類頁(yè)進(jìn)入尋找。
問(wèn)題3: 青云QingCloud 開(kāi)放平臺(tái) 的替代品有哪些?
市場(chǎng)上存在免費(fèi)、付費(fèi)兩種替代者
例如
更多競(jìng)品可以在 青云QingCloud 開(kāi)放平臺(tái)找到。
本文總結(jié)了獲取青云QingCloud開(kāi)放平臺(tái)API密鑰的詳細(xì)步驟,從訪問(wèn)官方網(wǎng)站注冊(cè)登錄到個(gè)人認(rèn)證,再到生成和下載API密鑰,并進(jìn)行初步的可用性測(cè)試,幫助開(kāi)發(fā)者了解如何有效集成到平臺(tái)中。同時(shí),還探討了在使用過(guò)程中需要注意的其他關(guān)鍵因素,如請(qǐng)求簽名、數(shù)據(jù)返回限制、錯(cuò)誤處理等,確保在構(gòu)建應(yīng)用時(shí)能夠順利使用API功能。
對(duì)比大模型API的內(nèi)容創(chuàng)意新穎性、情感共鳴力、商業(yè)轉(zhuǎn)化潛力
一鍵對(duì)比試用API 限時(shí)免費(fèi)