更新分組名稱
按分組 ID 修改分組名稱。
介面定義:ApiFox POST · 核對日期:2026-10-21。
請求
http
POST /api/updateGroup使用客戶端 API 頁面顯示的服務地址和 api-key。示例埠 9000 僅作演示,必須替換為實際埠;認證說明見 概述。
JSON 請求體
| 引數 | 型別 | 必填 | 說明 |
|---|---|---|---|
id | integer | 是 | 從分組清單取得數字 ID;嚴格比對,不能傳數字字串 |
name | string | 是 | 建議傳非空字串;介面未嚴格驗證,省略可能寫入不完整資料 |
cURL 示例
bash
curl --request POST 'http://127.0.0.1:9000/api/updateGroup' \
--header 'api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"id": 1,
"name": "new name"
}'響應示例
json
{
"success": true
}目前客戶端回應欄位
| 欄位 | 型別 | 用法 |
|---|---|---|
success | boolean | 請求處理成功標記;不代表每筆資料均已寫入 |
請求失敗時同時檢查 HTTP 狀態碼與響應中的錯誤資訊,見 錯誤碼與排查。
請使用數字 id 和非空字串 name。目前實作沒有完整檢查名稱,省略名稱不保證回傳 400,可能寫入不完整資料。
臨時分組與環境歸屬
分組清單會合併設定中儲存的分組,以及從現有環境 group 名稱推導出的分組。後者的 ID 可能只是臨時產生,並未寫入分組設定;不能保證穩定,以其更新或刪除分組可能回傳 404。更新或刪除分組只修改分組設定,不會同步修改環境的 group;舊名稱若仍被環境引用,之後可能再次出現在清單。需要遷移環境歸屬時,請先查詢並逐個更新相關環境設定。



