获取静态代理购买报价

按静态代理类型、地区、时长和数量获取当前购买报价。报价时会实时核对库存并使用当前可用价格；本接口无副作用，不创建订单，也不扣款。

接口信息

项目	内容
Method	POST
Path	/open-api/v1/static/purchase-quotes
认证	X-API-Key
Content-Type	application/json
处理方式	同步
副作用	无；不创建订单、不扣款

请求体

字段	类型	必填	说明	约束
static_type	string	是	静态代理类型	ISP 或 ISP_NATIVE
region_code	string	是	地区编码	使用静态代理地区接口返回的值
duration_days	integer	是	购买时长，天	仅 7、30、90；还必须符合下方类型与时长组合
quantity	integer	是	购买数量	正整数，不能超过报价时的实时可用库存，并需符合当前购买规格

静态类型支持的购买时长如下：

static_type	可用的 duration_days
ISP	7、30
ISP_NATIVE	7、30、90

duration_days 不是 7、30 或 90 时返回 400009。返回 300320 表示资源价格不存在或与请求规格不匹配；实际 msg 按 X-LANG 返回，省略或不支持时使用 en_US。

请求体只能包含上表中的四个字段，不接受 request_no、callback_url、报价金额或其他未列出的字段。

请求示例

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

类型和地区示例只说明格式。调用时请使用查询静态代理地区返回的值。

响应参数

data 仅包含以下字段：

字段	类型	说明
order_amount	string	当前报价总金额，固定保留 4 位小数
currency	string	固定为 USD

成功响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "order_amount": "20.0000",
    "currency": "USD"
  },
  "next": null
}

示例金额只说明字段格式，不代表实际价格。

报价有效性

报价不预留库存，也不锁定价格。正式调用创建静态代理购买订单时，会重新核对库存并按当时价格计算订单金额，实际金额可能与本次报价不同。

可能的错误码

code	说明
300320	资源价格不存在或与请求规格不匹配。
300323	指定类型和地区当前不可购买
300324	未能取得实时库存
300325	购买数量超过当前库存
400001	认证失败
400009	时长不是 7、30、90，或其他请求参数不符合要求
500000	系统处理失败，本次未取得报价