查询静态代理购买订单详情

GET /open-api/v1/static/purchase-orders/{order_no}

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

认证

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

路径与查询参数

字段	位置	类型	必填	约束	说明
order_no	path	string	是	—	静态采购订单号

请求示例

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

成功响应中的 data

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

字段	类型	必填	约束	说明
data.order_no	string	否	—	静态采购订单号
data.status	string	否	enum: UNFULFILLED, PROCESSING, SUCCESS, PARTIAL_SUCCESS, FAILED	采购订单履约状态
data.static_type	string	否	enum: ISP, ISP_NATIVE, ISP_CARRIER_NATIVE	平台静态代理类型
data.duration_days	integer	否	format: int32; minimum: 1	购买时长（天）
data.quantity	integer	否	format: int32; minimum: 1	订单采购数量
data.fulfilled_quantity	integer	否	format: int32; minimum: 0	已经成功落库的资源数量
data.order_amount	string	否	—	订单金额，USD 十进制字符串
data.currency	string	否	—	结算币种
data.create_time	string	否	format: date-time	订单创建时间
data.finish_time	string	否	format: date-time	订单首次进入终态的时间；处理中为空
data.regions	object[]	否	—	地区履约详情及各地区已交付资源
data.regions[].region_code	string	否	—	—
data.regions[].quantity	integer	否	format: int32	—
data.regions[].fulfilled_quantity	integer	否	format: int32	—
data.regions[].order_amount	string	否	—	—
data.regions[].status	string	否	—	—
data.regions[].resources	object[]	否	—	—
data.regions[].resources[].id	string	否	—	静态资源 ID
data.regions[].resources[].static_type	string	否	enum: ISP, ISP_NATIVE, ISP_CARRIER_NATIVE	平台静态代理类型
data.regions[].resources[].region_code	string	否	—	平台静态地区编码
data.regions[].resources[].region_name	string	否	—	按 X-LANG 返回的地区名称
data.regions[].resources[].host	string	否	—	代理连接主机
data.regions[].resources[].ip	string	否	—	静态代理 IP
data.regions[].resources[].port	integer	否	format: int32	代理连接端口
data.regions[].resources[].account	string	否	—	代理连接账号；敏感字段
data.regions[].resources[].password	string	否	—	代理连接密码；敏感字段
data.regions[].resources[].protocol	string	否	enum: HTTP	代理协议；Open 静态采购固定为 HTTP
data.regions[].resources[].resource_status	string	否	enum: ACTIVE, EXPIRED	资源状态
data.regions[].resources[].buy_time	string	否	format: date-time	购买时间，GMT+8 带偏移 ISO-8601
data.regions[].resources[].expire_time	string	否	format: date-time	当前权威到期时间，GMT+8 带偏移 ISO-8601
data.regions[].resources[].create_time	string	否	format: date-time	资源创建时间，GMT+8 带偏移 ISO-8601
data.regions[].resources[].update_time	string	否	format: date-time	资源更新时间，GMT+8 带偏移 ISO-8601

接口说明

查询当前用户的一笔采购订单；返回主单五态，成功地区在整单成功或部分成功时展开已交付资源

相关约定

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