修改帳密
修改已購買靜態 IP 的帳號或密碼,支援批量(單次最多 10 個)。
介面資訊
POST /client/ip/pool/item/changeCredential
請求頭
| 參數名稱 | 類型 | 說明 |
|---|---|---|
| x-merchant-token | String | 商戶令牌 |
| x-merchant-code | String | 商戶代碼 |
請求參數
| 參數名稱 | 必選 | 類型 | 說明 |
|---|---|---|---|
| ipList | 是 | Array[String] | IP 列表 |
| account | 否 | String | 新帳號,不修改可不傳 |
| password | 否 | String | 新密碼,不修改可不傳 |
帳號、密碼至少填寫一項。
填寫時須滿足:首位為字母(不能為數字),長度 8-12 位,且同時包含大寫字母、小寫字母與數字。
請求示例
const response = await fetch('/client/ip/pool/item/changeCredential', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-merchant-token': 'your-token-here',
'x-merchant-code': 'your-merchant-code'
},
body: JSON.stringify({
ipList: ['156.252.8.76', '156.252.8.77'],
account: 'newuser',
password: 'newpass123'
})
});
const result = await response.json();
回應示例
{
"msg": "操作成功",
"code": 200,
"data": {
"successCount": 2,
"failCount": 0,
"successIPList": ["156.252.8.76", "156.252.8.77"],
"failIPList": []
}
}
回應字段
| 參數名稱 | 類型 | 說明 |
|---|---|---|
| data.successCount | Integer | 成功修改的 IP 數量 |
| data.failCount | Integer | 修改失敗的 IP 數量 |
| data.successIPList | Array[String] | 成功修改的 IP 列表 |
| data.failIPList | Array[String] | 修改失敗的 IP 列表 |
說明
- 僅支援狀態為「已生效」的 IP
- 單次最多 10 個 IP
- 部分 IP 可能不支援修改帳號或密碼,以介面返回為準