购买动态流量

POST /open-api/v1/dynamic/traffic/purchases

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

认证

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

JSON 请求体

字段	类型	必填	约束	说明
request_no	string	是	minLength: 1; maxLength: 64; pattern: ^[A-Za-z0-9_-]{1,64}$	调用方幂等请求号，1～64 位，仅允许字母、数字、下划线和连字符
product_code	string	是	—	动态流量产品编码
traffic_gb	string	是	—	采购流量 GB，必须符合产品固定数量或自定义数量范围，使用字符串避免精度丢失

请求示例

curl --request POST \
  --url 'https://api.ipfbs.com/gin/open-api/v1/dynamic/traffic/purchases' \
  --header 'Accept: application/json' \
  --header 'X-API-Key: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "request_no": "req_20260824_001",
  "product_code": "DYNAMIC_1GB",
  "traffic_gb": "1.0"
}'

成功响应中的 data

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

字段	类型	必填	约束	说明
data.order_no	string	否	—	动态流量订单号；作为不透明字符串原样使用
data.status	string	否	enum: COMPLETED	同步采购成功后的订单状态
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	同步完成时间，GMT+8 带偏移 ISO-8601

接口说明

使用钱包全额同步采购动态流量；request_no 在当前用户和本操作内保留 24 小时，重复提交返回 300006

相关约定

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