静态住宅IP / API接口 / 节点切换
节点切换
推荐阅读时长：4分钟节点切换接口用于为已有静态住宅IP订单更换新的节点资源。适合业务需要调整城市、运营商，或当前节点状态异常时使用。
接口信息
| 请求方式 | POST |
|---|---|
| 接口路径 | /api/v1/family/change |
| 鉴权要求 | Authorization: Bearer {token} |
| Content-Type | application/json |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
orderNo | array<string> | 是 | 订单编号数组。 |
items | array | 是 | 新节点信息数组，元素结构按节点列表返回数据传递。 |
items[].cityid | integer | 是 | 城市 ID。 |
items[].isp | string | 是 | 运营商，例如电信、移动、联通、随机。 |
items[].count | integer | 是 | 切换数量。 |
请求示例
{
"orderNo": [
"NOR65f1234567890"
],
"items": [
{
"cityid": 10002,
"count": 1,
"isp": "随机"
}
]
}响应说明
| 字段 | 类型 | 说明 |
|---|---|---|
code | integer | 业务状态码，成功为 200。 |
msg | string | 响应消息。 |
data.list | array | 切换后的订单或节点信息。 |
建议：节点切换会影响出口身份连续性。账号养护、长期登录等稳定性要求高的业务，应谨慎执行切换。
