产品介绍 / 独享代理IP / API接口 / 下单购买
下单购买
推荐阅读时长：4分钟下单接口用于创建独享代理IP订单。调用前需要准备购买时长、带宽、数量和购买节点信息。
接口信息
| 请求方式 | POST |
|---|---|
| 接口路径 | /api/v1/custom/buy |
| 鉴权要求 | Authorization: Bearer {token} |
| Content-Type | application/json |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
time | integer | 是 | 购买时长，单位按系统月卡逻辑处理。 |
band | integer | 是 | 带宽，固定值通常为 5、10、20。 |
count | integer | 是 | 购买数量。 |
list | array | 是 | 购买节点信息数组。 |
list[].cityid | integer | 是 | 城市 ID。 |
list[].isp | string | 是 | 运营商，例如 电信、移动、联通、随机。 |
list[].count | integer | 是 | 该节点购买数量。 |
请求示例
{
"time": 1,
"band": 10,
"count": 1,
"list": [
{
"cityid": 10001,
"count": 1,
"isp": "电信"
}
]
}响应说明
| 字段 | 类型 | 说明 |
|---|---|---|
code | integer | 业务状态码，成功为 200。 |
msg | string | 响应消息。 |
data.payNo | string | 支付/订单流水号。 |
data.result | mixed | 下单时可能返回的创建结果。 |
响应示例
{
"code": 200,
"msg": "success",
"data": {
"payNo": "PNO65f1234567890"
}
}建议：下单前先确认账号余额、城市库存、运营商和带宽规格，避免因库存变化或规格不匹配导致下单失败。
