Skip to main content
GET
账单聚合

端点

认证:需要 API Key(Authorization: Bearer <API Key>)。 一段时间花了多少、钱花在哪:区间合计加按维度拆分。与账户信息互相独立。 时间范围与运行列表共用词汇:created_from / created_to 为 ISO-8601 绝对时间,起点包含、终点不包含,按运行发起时间归属。把同样的参数带进 运行列表,得到的就是任一分组数字背后的运行。tz_offset 只影响按日分桶时一次运行落到哪一天,不改变金额,也不改变时间范围本身。 只聚合数据费。按日分组升序,便于从前往后对账;按 App 与按凭证分组按金额降序,先看钱主要花在哪、哪把 Key 在花。 credential 分组回答「我的每把凭证各花了多少」:键是发起凭证的非敏感稳定标识,与运行列表的 credential 筛选值相同。归属始终以账号为范围,凭证只是账号内部的拆分,永远看不到别人的凭证。

请求

查询参数

string
默认值:"day"
拆分维度。day 按日(默认)、data_app 按 App、credential 按发起凭证。取值:day / data_app / credential。
string
起点,包含。不传则从最早的运行算起。
string
终点,不包含。不传则算到现在。
integer
默认值:"0"
按日分桶的时区偏移,单位分钟,相对 UTC。北京时间传 480;默认 0 按 UTC 日切分。固定偏移,不处理夏令时;钻取时的 created_from / created_to 必须用同一偏移换算成绝对时间。范围 -720 到 840。

示例请求

响应

200 成功

响应包在 data 字段中,其内容如下。
number
时间范围内的合计,等于各组 amount 之和。
string
币种。
string
本次实际使用的维度。
object[]
分组列表。每个分组对象都带全部维度字段,未用到的维度为 null。

错误

错误响应统一为 {"error": {code, category, message, retryable}},见错误。

客户端库

注意事项

  • 计费口径对所有接入方式一致:失败不计费;部分成功和取消只按已产出记录计费;取量由平台从入库数据派生;作者调试运行照常计费;平台健康巡检不计费。
  • 单次运行的费用构成在运行对象的 billing 块里,见查询运行。
  • 按本地日对账时,tz_offset 与钻取用的时间范围必须使用同一个偏移,否则分桶边界和筛选边界对不上。