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 true 或 false,不能使用字符串 "true"、数字 1 或 0。
ID 和订单号
资源 ID、账号 ID 和订单号都按字符串处理。即使内容全部为数字,也不要转换为 JavaScript Number 等可能丢失精度的类型。