API接口 / 隧道代理IP / 修改密码
隧道代理IP · 修改密码
推荐阅读时长：3分钟修改代理账号的登录密码，支持单个订单或多个订单。
接口信息
| 项目 | 内容 |
|---|---|
| 请求方式 | POST |
| 接口路径 | /api/v1/tunnel/setPassword |
| Authorization | Bearer YOUR_TOKEN（替换为登录后取得的Token） |
| Content-Type | application/json |
| Accept | application/json |
鉴权配置见鉴权方式。以下均为说明性示例，未执行真实业务请求；示例订单号、账号及密码均为占位值。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
orderNo |
string / string[] | 是 | 单个订单号或订单号数组。 |
pass |
string | 是 | 新密码，校验长度4–20位；校验后去除首尾空格再保存，建议不要包含首尾空格。 |
请求示例：单个订单
{
"orderNo": "TUN_EXAMPLE_001",
"pass": "ExamplePwd123"
}请求示例：多个订单
{
"orderNo": [
"TUN_EXAMPLE_001",
"TUN_EXAMPLE_002"
],
"pass": "ExamplePwd123"
}响应与确认方式
当前方法正常结束时没有明确返回值，因此没有可承诺的成功JSON结构。不能仅凭HTTP 200或空响应断言密码已经修改。
请求完成后请通过订单查询核对结果。参数验证失败会抛出业务异常（code=500）；携带Accept: application/json以接收JSON错误响应。
参数错误示例
{
"code": 500,
"msg": "密码不能为空"
}代理密码和API Token均为敏感信息，请勿写入公开日志或分享给无关人员。
