查询静态代理库存

按静态代理类型和地区查询实时可用数量。

接口信息

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

Query 参数

参数	类型	必填	说明
static_type	string	是	ISP（静态住宅代理）或 ISP_NATIVE（静态原生代理）
region_code	string	是	使用静态代理地区接口返回的地区编码

请求示例

curl --request GET \
  --url 'https://api-test.puraroute.com/gin/open-api/v1/static/inventory?static_type=ISP&region_code=107' \
  --header 'Accept: application/json' \
  --header 'X-API-Key: <YOUR_API_KEY>'

响应参数

字段	类型	说明
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": "107",
    "available_quantity": 25,
    "in_stock": true,
    "checked_time": "2026-08-24T15:30:00.000+08:00"
  },
  "next": null
}

库存会变化。查询结果不能预留库存，创建订单时会再次检查。

可能的错误码

code	说明
300323	指定类型和地区当前不可用
300324	暂时无法取得实时库存
400001	认证失败
400009	类型、地区或其他参数不符合要求
500000	系统处理失败，请求未完成