产品介绍 / 独享代理IP / API接口 / 节点切换
节点切换
推荐阅读时长：4分钟切换节点接口用于按订单编号批量切换独享代理IP节点。新节点信息通过 items 数组传入，字段结构以后端节点列表返回为准。
接口信息
| 请求方式 | POST |
|---|---|
| 接口路径 | /api/v1/custom/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": "移动"
}
]
}响应说明
接口返回切换后的订单或节点信息，具体字段以后端实际返回为准。
提示：独享资源切换前建议先查询可用节点，确认目标城市和运营商仍有可用资源。
