跳至文檔內容
開發者文檔API 參考讀取團隊防火牆建立紀錄
GETBearer 權杖

讀取團隊防火牆建立紀錄

/api/v1/firewall-requests/:requestKey

讀取目前固定團隊已提交的防火牆建立紀錄,保留原操作人。

呼叫前請注意

僅讀取業務紀錄,不提交、重試、解鎖或呼叫供應商。找不到紀錄不代表未建立;歷史成功不代表目前防護已驗證。保留既有認證使用稽核。

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

請求範例

cURL
curl "https://tovahub.com/api/v1/firewall-requests/undefined" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

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

回應示例
JSON
{
  "requestKey": "original_create_1",
  "actorUserId": "507f1f77bcf86cd799439013",
  "name": "Office",
  "state": "pending",
  "createdAt": "2026-11-01T00:00:00.000Z",
  "updatedAt": "2026-11-01T00:00:00.000Z",
  "resource": null
}

參數

requestKey路徑 · 必填

string

原建立請求的 requestKey,恢復不產生新鍵。

回應

HTTP 狀態 200

僅為已存紀錄,不核查供應商也不重試操作。

requestKeystring | null

原請求鍵;舊紀錄不完整時為 null。

namestring | null

已存建立名稱或 null,不回傳規則及供應商原始資料。

statestring

已存狀態:new、started、pending、succeeded、failed 或 unknown,任何狀態都不授權重新提交。

createdAtstring | null

已存 ISO 時間戳,無資料時為 null;讀取不更新時間。

updatedAtstring | null

已存 ISO 時間戳,無資料時為 null;讀取不更新時間。

resource{ id: string, state: string } | null

同組織的本機資源 {id, state} 或 null;不重建已刪除或缺失資源。

actorUserIdstring (ObjectId) | null

原操作人帳號編號;歷史缺失為null。目前讀者須為同一固定團隊的有效成員。