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