更新平臺賬號列表
以傳入陣列整體替換環境內的平臺賬號列表。
介面定義:ApiFox POST · 核對日期:2026-10-21。
請求
http
POST /api/updateAccountList使用客戶端 API 頁面顯示的服務地址和 api-key。示例埠 9000 僅作演示,必須替換為實際埠;認證說明見 概述。
JSON 請求體
ApiFox 透過示例給出這些欄位,下表的必填要求補充自當前客戶端。
| 引數 | 型別 | 必填 | 說明 |
|---|---|---|---|
id | integer | 是 | 環境 ID |
accounts | object[] | 是 | 替換後的完整賬號列表 |
cURL 示例
bash
curl --request POST 'http://127.0.0.1:9000/api/updateAccountList' \
--header 'api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"id": 63,
"accounts": [
{
"origin_url": "https://www.example.com",
"username_value": "user001_new@example.com",
"password_value": "NewP@ssw0rd123",
"display_name": "示例賬號1(已更新)"
},
{
"origin_url": "https://www.myapp.com",
"username_value": "admin@myapp.com",
"password_value": "NewAdmin@789",
"display_name": "管理員賬號(最新)"
}
]
}'響應示例
json
{
"success": true
}賬號物件欄位
| 欄位 | 型別 | 說明 |
|---|---|---|
accounts[].origin_url | string | 賬號所屬站點 URL |
accounts[].username_value | string | 使用者名稱 |
accounts[].password_value | string | 密碼 |
accounts[].display_name | string | 顯示名稱 |
呼叫說明
- 此介面整體覆蓋原有賬號,並非按使用者名稱增量修改;未傳入的賬號不會保留。請先備份原列表並關閉環境。僅追加請用 新增平臺賬號。
請求失敗時同時檢查 HTTP 狀態碼與響應中的錯誤資訊,見 錯誤碼與排查。



