查询动态流量订单详情

GET /open-api/v1/dynamic/traffic/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/dynamic/traffic/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: PROCESSING, COMPLETED, FAILED	订单状态
data.product_code	string	否	—	动态流量产品编码
data.traffic_gb	string	否	—	采购流量 GB
data.order_amount	string	否	—	订单金额，USD 十进制字符串
data.currency	string	否	—	结算币种
data.traffic_lot_id	string	否	—	完成后生成的流量批次 ID；未完成时为空
data.finish_time	string	否	format: date-time	订单完成时间；未完成时为空
data.create_time	string	否	format: date-time	订单创建时间
data.valid_days	integer	否	format: int32	产品有效天数；空值表示永久有效
data.traffic_lot	object	否	—	有效动态流量批次
data.traffic_lot.id	string	否	—	流量批次 ID
data.traffic_lot.purchased_traffic_gb	string	否	—	本批次购买流量 GB
data.traffic_lot.consumed_traffic_gb	string	否	—	本批次已消费流量 GB
data.traffic_lot.expired_traffic_gb	string	否	—	本批次已过期流量 GB
data.traffic_lot.remaining_traffic_gb	string	否	—	本批次剩余流量 GB
data.traffic_lot.status	string	否	—	批次状态
data.traffic_lot.effective_time	string	否	format: date-time	生效时间，GMT+8 带偏移 ISO-8601
data.traffic_lot.expire_time	string	否	format: date-time	到期时间；空值表示永久有效
data.traffic_lot.create_time	string	否	format: date-time	批次创建时间，GMT+8 带偏移 ISO-8601

接口说明

按订单号查询当前用户的动态流量订单；完成态同时返回对应历史流量批次

相关约定

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