Skip to content

更新分組名稱 ​

按分組 ID 修改分組名稱。

介面定義:ApiFox POST · 核對日期:2026-10-21。

請求 ​

http
POST /api/updateGroup

使用客戶端 API 頁面顯示的服務地址和 api-key。示例埠 9000 僅作演示,必須替換為實際埠;認證說明見 概述。

JSON 請求體 ​

引數型別必填說明
idinteger是從分組清單取得數字 ID;嚴格比對,不能傳數字字串
namestring是建議傳非空字串;介面未嚴格驗證,省略可能寫入不完整資料

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
}

目前客戶端回應欄位 ​

欄位型別用法
successboolean請求處理成功標記;不代表每筆資料均已寫入

請求失敗時同時檢查 HTTP 狀態碼與響應中的錯誤資訊,見 錯誤碼與排查。

請使用數字 id 和非空字串 name。目前實作沒有完整檢查名稱,省略名稱不保證回傳 400,可能寫入不完整資料。

臨時分組與環境歸屬

分組清單會合併設定中儲存的分組,以及從現有環境 group 名稱推導出的分組。後者的 ID 可能只是臨時產生,並未寫入分組設定;不能保證穩定,以其更新或刪除分組可能回傳 404。更新或刪除分組只修改分組設定,不會同步修改環境的 group;舊名稱若仍被環境引用,之後可能再次出現在清單。需要遷移環境歸屬時,請先查詢並逐個更新相關環境設定。