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)同意證明到期時間戳記。
parametersobjectterminate 時為空;reinstall 時為 {os:string,imageId:string|null}。
impactstring伺服器提供的操作影響說明。