创建静态代理购买订单

POST /open-api/v1/static/purchase-orders

Base URL：https://api.ipbunker.online/gin。

认证

在请求头传入 X-API-Key。

JSON 请求体

字段	类型	必填	约束	说明
`request_no`	`string`	是	minLength: 1; maxLength: 64; pattern: ^[A-Za-z0-9_-]{1,64}$	调用方幂等请求号，1～64 位，仅允许字母、数字、下划线和连字符
`static_type`	`string`	是	enum: ISP, ISP_NATIVE, ISP_CARRIER_NATIVE	平台静态代理类型
`duration_days`	`integer`	是	format: int32; minimum: 1	购买时长（天），正整数；ISP、ISP_NATIVE、ISP_CARRIER_NATIVE 均按当前用户对应类型和地区的启用价格目录确定周期；非正整数或格式错误返回 400009，当前产品/周期暂无可用报价时返回 300320，请联系客户支持
`regions`	`object[]`	是	—	采购地区集合；地区不得重复，单地区也必须传一个元素
`regions[].region_code`	`string`	是	—	平台静态地区编码；同一订单内不得重复
`regions[].quantity`	`integer`	是	format: int32; minimum: 1; maximum: 300	该地区采购数量，范围 1～300
`callback_url`	`string`	否	maxLength: 2048	可选终态回调地址；仅允许通过 SSRF 校验的 HTTP/HTTPS 绝对地址，最长 2048 字符

请求示例

curl --request POST \
  --url 'https://api.ipbunker.online/gin/open-api/v1/static/purchase-orders' \
  --header 'Accept: application/json' \
  --header 'X-API-Key: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "request_no": "static_buy_20260824_001",
  "static_type": "ISP",
  "duration_days": 30,
  "regions": [
    {
      "region_code": "US_CA",
      "quantity": 2
    }
  ]
}'

成功响应中的 data

接口使用 code、msg、data、next 响应结构。HTTP 200 也可能包含非零业务错误码；先检查 code。

字段	类型	必填	约束	说明
`data.order_no`	`string`	否	—	静态采购订单号
`data.status`	`string`	否	enum: UNFULFILLED, PROCESSING	异步采购订单履约状态
`data.static_type`	`string`	否	enum: ISP, ISP_NATIVE, ISP_CARRIER_NATIVE	平台静态代理类型
`data.duration_days`	`integer`	否	format: int32; minimum: 1	购买时长（天）
`data.quantity`	`integer`	否	format: int32; minimum: 1	全部地区采购数量
`data.order_amount`	`string`	否	—	订单金额，USD 十进制字符串
`data.currency`	`string`	否	—	结算币种
`data.create_time`	`string`	否	format: date-time	订单创建时间，GMT+8 带偏移 ISO-8601
`data.regions`	`object[]`	否	—	全部采购地区摘要
`data.regions[].region_code`	`string`	否	—	—
`data.regions[].quantity`	`integer`	否	format: int32	—
`data.regions[].order_amount`	`string`	否	—	—

接口说明

使用钱包全额支付并异步履约；ISP、ISP_NATIVE、ISP_CARRIER_NATIVE 均按当前用户对应类型和地区的启用价格目录确定正整数周期；创建响应仅表示订单已受理，request_no 在当前用户和本操作内保留 24 小时

创建静态代理购买订单

创建静态代理购买订单

认证

JSON 请求体

请求示例

成功响应中的 data

接口说明

相关约定

On this page