查询静态代理库存

批量查询同一静态代理类型下多个地区的实时可用数量。返回顺序与请求中的地区顺序一致。

接口信息

项目	内容
Method	POST
Path	/open-api/v1/static/inventory
认证	X-API-Key
Content-Type	application/json
处理方式	同步

请求体

字段	类型	必填	说明
static_type	string	是	ISP（静态住宅代理）或 ISP_NATIVE（静态原生代理）
region_codes	string[]	是	使用静态代理地区接口返回的地区编码；不能为空、包含空值或重复地区

旧版 GET 请求和单个 region_code 字段不再支持。请求体不能包含未列出的字段。

请求示例

curl --request POST \
  --url 'https://api.puraroute.com/gin/open-api/v1/static/inventory' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <YOUR_API_KEY>' \
  --data '{
    "static_type": "ISP",
    "region_codes": ["US_CA", "JP_TK"]
  }'

响应参数

data 为数组，元素顺序与 region_codes 一致。

字段	类型	说明
static_type	string	ISP 或 ISP_NATIVE
region_code	string	地区编码
available_quantity	integer	实时可用数量；0 表示当前无可用库存或本次未能取得该地区库存
in_stock	boolean	是否有可用库存
checked_time	string	库存检查时间，GMT+8 ISO-8601

成功响应示例

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "static_type": "ISP",
      "region_code": "US_CA",
      "available_quantity": 25,
      "in_stock": true,
      "checked_time": "2026-08-24T15:30:00.000+08:00"
    },
    {
      "static_type": "ISP",
      "region_code": "JP_TK",
      "available_quantity": 0,
      "in_stock": false,
      "checked_time": "2026-08-24T15:30:00.000+08:00"
    }
  ],
  "next": null
}

库存会变化，查询不会预留库存。创建订单时会重新检查。

可能的错误码

code	说明
300323	指定类型或地区当前不可用
400001	认证失败
400009	请求方式、类型、地区列表或请求体不符合要求
500000	系统处理失败，请求未完成