批量查询静态代理库存

POST /open-api/v1/static/inventory

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

认证

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

JSON 请求体

字段	类型	必填	约束	说明
static_type	string	是	enum: ISP, ISP_NATIVE, ISP_CARRIER_NATIVE	必填，所有地区共用的静态类型
region_codes	string[]	是	—	必填，本地地区编码列表；不能为空、包含空值或重复地区，结果按此顺序返回
duration_days	integer	否	format: int32	可选，库存对应购买时长；省略时默认 90 天

请求示例

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

成功响应中的 data

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

字段	类型	必填	约束	说明
data	object[]	否	—	业务数据；失败时为 null
data[].static_type	string	否	enum: ISP, ISP_NATIVE, ISP_CARRIER_NATIVE	平台静态代理类型
data[].region_code	string	否	—	平台静态地区编码
data[].available_quantity	integer	否	format: int32; minimum: 0	实时可用数量；0 表示当前无库存或对应供应商库存查询失败
data[].in_stock	boolean	否	—	是否有可用库存
data[].checked_time	string	否	format: date-time	成功时为库存快照时间，查询失败回零时为本地检查时间；GMT+8 带偏移 ISO-8601

接口说明

按本地类型和地区列表查询，按请求顺序返回；适配层查询失败的供应商组按零库存返回，不影响其他组；不锁库存，不兼容旧 GET 接口

相关约定

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