查询动态流量余额

GET /open-api/v1/dynamic/traffic/balance

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

认证

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

请求示例

curl --request GET \
  --url 'https://api.ipfbs.com/gin/open-api/v1/dynamic/traffic/balance' \
  --header 'Accept: application/json' \
  --header 'X-API-Key: <YOUR_API_KEY>'

成功响应中的 data

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

字段	类型	必填	约束	说明
data.purchased_traffic_gb	string	否	—	累计购买流量 GB
data.consumed_traffic_gb	string	否	—	累计消费流量 GB
data.expired_traffic_gb	string	否	—	累计过期流量 GB
data.adjusted_traffic_gb	string	否	—	累计人工调整流量 GB，可为负数
data.available_traffic_gb	string	否	—	当前可用流量 GB
data.balance_state	string	否	—	余额状态
data.last_calc_time	string	否	format: date-time	余额最近计算时间，GMT+8 带偏移 ISO-8601
data.update_time	string	否	format: date-time	余额记录更新时间，GMT+8 带偏移 ISO-8601

接口说明

查询当前用户动态流量的采购、消耗、过期、调整和可用余额汇总

相关约定

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