产品介绍 / 家庭拨号IP / API接口 / 下单购买
下单购买
推荐阅读时长：4分钟下单购买接口用于创建家庭拨号IP订单。接口内部按余额支付处理，调用前请确认账号余额充足、账号状态正常，并准备好项目 ID、购买时长、带宽、数量和资源列表。
接口信息
| 请求方式 | POST |
|---|---|
| 接口路径 | /api/v1/dialIp/buy |
| 鉴权要求 | Authorization: Bearer {token} |
| Content-Type | application/json |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project_id | integer | 是 | 项目编号。 |
time | integer | 是 | 购买时长数值，最小值为 1。 |
timeType | string | 是 | 时长类型，可选 天卡、月卡。 |
band | integer | 是 | 带宽，单位 M。 |
count | integer | 是 | 购买总数量。 |
list | array | 是 | 节点/地区选择列表。 |
list[].mapid | integer | 是 | 城市 ID 或资源 ID，以资源列表接口返回为准。 |
list[].count | integer | 是 | 该资源下单数量。 |
请求示例
{
"project_id": 31,
"time": 1,
"timeType": "天卡",
"band": 5,
"count": 1,
"list": [
{
"mapid": 29,
"count": 1
}
]
}响应说明
| 字段 | 类型 | 说明 |
|---|---|---|
code | integer | 状态码，成功为 200。 |
msg | string | 响应消息。 |
data.payNo | string | 支付/订单流水号。 |
响应示例
{
"code": 200,
"data": {
"payNo": "DORD66aabbccddeef"
},
"msg": "购买成功"
}建议：提交下单前先调用资源列表接口确认
mapid 与库存，避免资源变化导致下单失败。
