创建静态代理购买订单

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

Base URL：https://api.ipfbs.com/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.ipfbs.com/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 小时

相关约定

请求规范 · 响应结构 · 错误码 · API 接口目录