VPS API，用 JSON REST 自動化雲端伺服器

是的，VPS API 對所有會員免費。發放 API 金鑰和發出請求免費，使用 API 建立的伺服器和選項的價格與在控制面板中建立的伺服器相同。任何完成首次付款的會員都可以立即在 API 金鑰頁面建立金鑰。

完成首次付款後，API 金鑰頁面 (/api-key) 將開放，您可以在那裡建立金鑰。使用 Bearer 方案將金鑰放入每個請求的 Authorization 標頭中。金鑰解鎖您的整個帳戶，因此請不要將其提交到程式碼儲存庫；將其保存在環境變數或金鑰管理工具中。

可以讀取在售列表(GET /catalog)、讀取伺服器列表和單台資訊(GET /servers、GET /servers/{id})、建立伺服器(POST /servers)、開機、關機和重啟(start、stop、reboot)、續費一個月(renew)、刪除(DELETE /servers/{id})。請求示例和回應格式見 API 文件。

一個金鑰每分鐘最多可請求300次。超出限制會返回 429 狀態碼和 rate_limited 錯誤，在腳本中處理為稍等後重新傳送即可。查詢伺服器列表和電源管理等日常自動化在此限制內執行綽綽有餘。不按請求次數收費。

當 POST /servers 請求成功時，您所選的付款週期將被處理，伺服器將被建立。建立失敗的伺服器的付款將退回到您的帳戶餘額。

建立伺服器請求的回應中會包含一次 root_password 值。收到回應後請立即儲存到安全的地方。在控制面板中也可在7天內再次檢視，同時傳送 SSH 金鑰編號的話，無需密碼即可用金鑰直接連線。可以用回應中的 ipv4 值立即開始 SSH 連線，便於與部署腳本銜接。

可以。在建立伺服器請求的 ssh_key_id 中填入已新增的 SSH 金鑰編號，新伺服器就會放入該金鑰。金鑰只需在控制面板的 SSH 金鑰頁面新增一次，指紋以與 ssh-keygen 相同的方式顯示，一眼就能確認是哪個金鑰。金鑰編號定好後可以重複使用。

只要能傳送 HTTP 請求，任何語言和工具都可以。可以用 curl 直接測試，在 Python 的 requests、Node.js 的 fetch、GitLab CI 的腳本步驟、Terraform 的 HTTP 請求功能中，用相同的地址和請求標頭呼叫。回應都是 JSON，結果易於讀取。

錯誤會以非 2xx 的狀態碼加含 error 值的 JSON 返回。金鑰錯誤為 unauthorized，缺少值為 bad_request，餘額不足為 not_enough_balance，請求與伺服器狀態不符為 wrong_state，原因清晰區分，程式可按情況處理。

會。API 和控制面板操作的是同一個帳戶和同一批伺服器。透過 API 建立的伺服器會直接顯示在控制面板列表中，可在控制面板中重灌作業系統或檢視密碼。每個帳戶10台伺服器的上限也同時適用於兩種方式。手動操作和程式碼操作混用，狀態和付款日也始終一致。