OpenAPI 接口文档
OpenAPI 接口文档

字段格式

请求中的数值

请求中的流量值以 GB 为单位,使用普通十进制字符串,最多 6 位小数:

{
  "traffic_gb": "100.000000"
}

本版接口的流量请求字段不接受科学计数法、负数、NaN 或无穷值。字段是否允许 0,以对应接口文章为准。整数请求字段必须使用 JSON integer,不能使用带引号的字符串。

响应中的金额和单价

金额和单价均以十进制字符串返回。金额固定保留 4 位小数,单价固定保留 6 位小数:

{
  "order_amount": "12.5000",
  "unit_price": "0.850000"
}

不要使用二进制浮点数保存或计算金额与单价。

响应中的流量

响应中的流量值固定保留 6 位小数:

{
  "traffic_gb": "100.000000",
  "adjusted_traffic_gb": "-1.250000"
}

adjusted_traffic_gb 表示累计调整量,因此响应值可以为负数。其他字段的业务含义和取值范围以对应接口文章为准。

时间

时刻使用 GMT+8 且带偏移的 ISO-8601 字符串,例如:

2026-08-24T15:30:00.000+08:00

筛选参数必须带 Z 或显式时区偏移。日期字段使用 Asia/Shanghai 自然日的 yyyy-MM-dd,例如 2026-08-24

布尔值

布尔字段使用 JSON truefalse,不能使用字符串 "true"、数字 10

ID 和订单号

资源 ID、账号 ID 和订单号都按字符串处理。即使内容全部为数字,也不要转换为 JavaScript Number 等可能丢失精度的类型。

On this page