跳至文檔內容
開發者文檔API 參考設定自動續約偏好
POSTBearer 權杖

設定自動續約偏好

/api/v1/servers/:id/autorenew

儲存本站的自動續約偏好。

呼叫前請注意

此操作不會續訂或取消供應商合約。目前尚無可用的供應商續約整合。

API 欄位名稱、型別與程式碼在所有語言中保持原樣。

請求範例

cURL
curl "https://tovahub.com/api/v1/servers/507f1f77bcf86cd799439012/autorenew" -X POST \
  -H "Authorization: Bearer $TOVAHUB_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
  "enabled": true,
  "requestKey": "docs_example_001"
}'

僅提供範例,此頁不會發送 API 請求。

回應示例
JSON
{
  "ok": true,
  "enabled": true,
  "supplierRenewalReady": false
}

參數

id路徑 · 必填

string

資源 ID:24 個十六進位字元。請使用對應列表端點回傳的平台 ID,而非供應商的執行個體 ID。

enabledJSON 請求主體 · 必填

boolean

新的啟用狀態。

requestKeyJSON 請求主體 · 必填

string

8–100 個字元,僅限 A–Z、a–z、0–9、底線或連字號。重試同一操作時,請沿用相同的鍵值與完全相同的輸入。

回應

HTTP 狀態 200

儲存網站的自動續約偏好,不會續約供應商合約。

okboolean (true)

偏好已儲存,或已回傳原請求結果。

enabledboolean

原始儲存的偏好值。

replayboolean (true, optional)

僅在重播相同請求時出現。

supplierRenewalReadyboolean (false)

目前無法使用供應商續約整合。