隧道代理IP下单购买API接口文档

API接口 / 隧道代理IP / 下单购买

隧道代理IP · 下单购买

推荐阅读时长：3分钟

通过账户余额购买隧道代理IP。调用前请完成实名认证，并确认余额及所选规格可用。本页介绍天卡、月卡两种常规购买方式。

项目	内容
请求方式	POST
接口路径	`/api/v1/tunnel/buy`
Authorization	`Bearer YOUR_TOKEN`（替换为登录后取得的Token）
Content-Type	`application/json`
Accept	`application/json`

鉴权配置见鉴权方式。以下均为说明性示例，未执行真实业务请求；示例订单号、账号及密码均为占位值。

参数	类型	必填	说明
`timeType`	string	否	天卡或月卡；省略时默认月卡。time的单位随此字段变化。
`time`	integer	是	购买天数或月数，请填写正整数。当前参数校验为必填整数。
`band`	integer	是	带宽，单位M。常见5、10、20，实际可用规格取决于价格配置，并非任意整数均可购买。
`concurrent`	integer	是	并发数，请填写可用规格中的正整数。
`ipCycle`	integer	是	IP更换周期，单位秒，必须大于或等于60。

{
  "timeType": "月卡",
  "time": 1,
  "band": 5,
  "concurrent": 10,
  "ipCycle": 300
}

{
  "timeType": "天卡",
  "time": 3,
  "band": 5,
  "concurrent": 10,
  "ipCycle": 300
}

{
  "code": 200,
  "msg": "购买成功",
  "data": {
    "payNo": "ORD_EXAMPLE_PAYMENT_001"
  }
}

HTTP状态不等于业务结果，应检查JSON中的code和msg。必填缺失、类型错误或周期不足60秒可能返回业务码500；余额不足、未实名或规格不可用按实际错误消息处理，不要反复重试。

{
  "code": 500,
  "msg": "购买时间不能为空"
}