Skip to main content
GET
每日账单查询
按日期查询账单的消费明细日汇总数据,供客户侧对账、成本分析与账单采集使用。

接口信息

接口清单

用户鉴权

所有请求必须在 HTTP Header 中携带 Bearer 凭证。支持两种凭证,任选其一
string
必填
格式 Bearer <凭证>,填入上述任一凭证即可
认证失败返回 HTTP 401,业务码 40100
不要在 URL、前端代码、日志或工单中明文记录完整 Key。

通用响应结构

所有接口返回统一结构:

业务错误码


消费明细查询

(账单日 × 账号 × 模型 × Token 类型) 返回消费明细。

查询参数

string
必填
开始日期,格式 yyyy-MM-dd
string
必填
结束日期,格式 yyyy-MM-dd;与 startDate 跨度不超过 92 天
string
账号 ID 筛选(多子账号可见需开通「企业管理」,详见业务规则);不传返回当前凭证可见的账号
string
账号名筛选,精确匹配(多子账号可见需开通「企业管理」,详见业务规则);不传返回当前凭证可见的账号
string
必填
分页大小,正整数字符串;取值 1 ~ 100,超过 100 按 100 处理
string
必填
当前页码,正整数字符串,从 1 开始
分页粒度为「消费明细条目」,data.total 为满足条件的明细总条数。

响应行字段(data.rows[]

tokenType 枚举

排序规则:billDay 降序,其次 accountmodelNametokenTypecurrency 升序。

请求示例

响应示例


日汇总查询

返回按天粒度的消费净额汇总,响应体较明细接口轻量,适用于账单概览、日趋势、月度报表等场景。

查询参数

string
必填
开始日期,格式 yyyy-MM-dd
string
必填
结束日期,格式 yyyy-MM-dd;与 startDate 跨度不超过 366 天
string
账号 ID 筛选(多子账号可见需开通「企业管理」,详见业务规则);不传返回当前凭证可见的账号
string
账号名筛选,精确匹配(多子账号可见需开通「企业管理」,详见业务规则);不传返回当前凭证可见的账号
string
必填
分页大小,正整数字符串;取值 1 ~ 400,超过 400 按 400 处理
string
必填
当前页码,正整数字符串,从 1 开始
分页粒度为「账单日 × 账号」,data.total 为满足条件的组合总数。

响应行字段(data.rows[]

排序规则:billDay 降序,其次 account 升序。

请求示例

响应示例


业务规则与约定

  1. 金额精度:所有金额字段以 string 传输,保留 8 位小数,避免 JSON number 精度丢失。
  2. 金额一致性:同一账单日、同一账号下,日汇总的各金额字段等于该日消费明细对应金额字段之和(跨页累加)。
  3. 零消费日:查询区间内无消费的日期不返回记录。
  4. 数据延迟:账单数据为 T+1,即最新一天的数据在次日可查询。
  5. 账号范围与企业管理:默认情况下,凭证只能查询自身账号的账单数据。若该账号已开通「企业管理」并作为主账号,则可见其名下全部子账号的账单——此时不传 userId/userName 返回全部子账号,传入则筛选到指定子账号(子账号自身的凭证仅能查询自己)。开通企业管理请联系平台管理员。
  6. 分页越界:当 pageNum 超过总页数时,返回空 rowstotal 仍为真实总数。