静态代理
静态代理

获取静态代理购买报价

POST /open-api/v1/static/purchase-quotes 接口参考。

获取静态代理购买报价

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

Base URL:https://api.ipfbs.com/gin。

认证

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

JSON 请求体

字段 类型 必填 约束 说明
static_type string 是 enum: ISP, ISP_NATIVE, ISP_CARRIER_NATIVE 平台静态代理类型
region_code string 是 — 平台静态地区编码
duration_days integer 是 format: int32; minimum: 1 购买时长(天),正整数;三种静态类型均按当前用户对应类型和地区的启用价格目录确定周期,非正整数或格式错误返回 400009,缺少可用报价返回 300320
quantity integer 是 format: int32; minimum: 1 采购数量,必须为正整数且不超过实时可用库存

请求示例

curl --request POST \
  --url 'https://api.ipfbs.com/gin/open-api/v1/static/purchase-quotes' \
  --header 'Accept: application/json' \
  --header 'X-API-Key: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "static_type": "ISP",
  "region_code": "107",
  "duration_days": 30,
  "quantity": 2
}'

成功响应中的 data

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

字段 类型 必填 约束 说明
data.order_amount string 否 — 当前总费用,四位小数字符串;正式下单时重新计价
data.currency string 否 — 币种

接口说明

按当前库存和价格计算总费用;报价不创建订单、不扣款且不锁定价格,正式下单时会重新计价

相关约定

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

On this page

获取静态代理购买报价