查询静态代理资源

GET /open-api/v1/static/resources

Base URL：https://api.ipbunker.online/gin。

认证

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

路径与查询参数

字段	位置	类型	必填	约束	说明
static_type	query	string	否	enum: ISP, ISP_NATIVE, ISP_CARRIER_NATIVE	平台静态代理类型
region_code	query	string	否	—	平台静态地区编码
resource_status	query	string	否	enum: ACTIVE, EXPIRED	资源状态
expire_time_start	query	string	否	format: date-time	到期时间下限（含），带时区 ISO-8601
expire_time_end	query	string	否	format: date-time	到期时间上限（含），带时区 ISO-8601
ip_keyword	query	string	否	—	IP 地址关键字
page_no	query	integer	否	format: int64; minimum: 1	页码，从 1 开始
page_size	query	integer	否	format: int64; minimum: 1; maximum: 100	每页条数，范围 1～100

请求示例

curl --request GET \
  --url 'https://api.ipbunker.online/gin/open-api/v1/static/resources' \
  --header 'Accept: application/json' \
  --header 'X-API-Key: <YOUR_API_KEY>'

成功响应中的 data

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

字段	类型	必填	约束	说明
data.list	object[]	否	—	当前页数据列表
data.list[].id	string	否	—	静态资源 ID
data.list[].static_type	string	否	enum: ISP, ISP_NATIVE, ISP_CARRIER_NATIVE	平台静态代理类型
data.list[].region_code	string	否	—	平台静态地区编码
data.list[].region_name	string	否	—	按 X-LANG 返回的地区名称
data.list[].host	string	否	—	代理连接主机
data.list[].ip	string	否	—	静态代理 IP
data.list[].port	integer	否	format: int32	代理连接端口
data.list[].account	string	否	—	代理连接账号；敏感字段
data.list[].password	string	否	—	代理连接密码；敏感字段
data.list[].protocol	string	否	enum: HTTP	代理协议；Open 静态采购固定为 HTTP
data.list[].resource_status	string	否	enum: ACTIVE, EXPIRED	资源状态
data.list[].buy_time	string	否	format: date-time	购买时间，GMT+8 带偏移 ISO-8601
data.list[].expire_time	string	否	format: date-time	当前权威到期时间，GMT+8 带偏移 ISO-8601
data.list[].create_time	string	否	format: date-time	资源创建时间，GMT+8 带偏移 ISO-8601
data.list[].update_time	string	否	format: date-time	资源更新时间，GMT+8 带偏移 ISO-8601
data.total	integer	否	format: int64	符合筛选条件的总条数
data.page_no	integer	否	format: int64; minimum: 1	当前页码，从 1 开始
data.page_size	integer	否	format: int64; minimum: 1; maximum: 100	每页条数，范围 1～100

接口说明

分页查询当前用户已交付的静态代理资源；响应包含账号和密码，请按敏感信息处理

相关约定

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