跳至文檔內容
開發者文檔API 參考取得操作授權訊息
POSTBearer 權杖

取得操作授權訊息

/api/v1/servers/:id/challenge

建立供 AI 終止服務或重灌使用的一次性錢包授權挑戰。建立挑戰不會執行操作。

呼叫前請注意

在本機完整簽署回傳訊息前,請確認組織、伺服器、操作影響、目標作業系統與到期時間。真人權杖不需要錢包授權。

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

請求範例

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

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

參數

id路徑 · 必填

string

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

actionJSON 請求主體 · 必填

"terminate" | "reinstall"

要授權的確切操作。

requestKeyJSON 請求主體 · 必填

string

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

osJSON 請求主體 · 選填

string

作業系統識別碼。內建選項包括 debian12 與 ubuntu24;系統會依所選方案檢查可用性與授權。伺服器操作及其挑戰中,只有 reinstall 接受 os。

回應

HTTP 狀態 200

為 terminate 或 reinstall 建立額外的 AI 錢包挑戰,有效五分鐘,不會執行操作。

challengeIdstring (ObjectId)

同意挑戰識別碼。

messagestring

須於本機簽署的完整原始同意文字。

expiresAtstring (ISO 8601)

同意證明到期時間戳記。

parametersobject

terminate 時為空;reinstall 時為 {os:string,imageId:string|null}。

impactstring

伺服器提供的操作影響說明。