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 部伺服器的上限亦同時適用於兩種方式。人手操作與程式碼操作混合使用，狀態及收費日亦始終一致。