每日账单查询
接口模块
每日账单查询
按日期查询账单消费明细与日汇总数据,供对账、成本分析与账单采集使用
GET
每日账单查询
按日期查询账单的消费明细与日汇总数据,供客户侧对账、成本分析与账单采集使用。
接口信息
接口清单
用户鉴权
所有请求必须在 HTTP Header 中携带 Bearer 凭证。支持两种凭证,任选其一:string
必填
格式
Bearer <凭证>,填入上述任一凭证即可401,业务码 40100。
通用响应结构
所有接口返回统一结构:业务错误码
消费明细查询
(账单日 × 账号 × 模型 × Token 类型) 返回消费明细。
查询参数
string
必填
开始日期,格式
yyyy-MM-ddstring
必填
结束日期,格式
yyyy-MM-dd;与 startDate 跨度不超过 92 天string
必填
分页大小,正整数字符串;取值
1 ~ 100,超过 100 按 100 处理string
必填
当前页码,正整数字符串,从
1 开始分页粒度为「消费明细条目」,
data.total 为满足条件的明细总条数。响应行字段(data.rows[])
tokenType 枚举
排序规则:
billDay 降序,其次 account、modelName、tokenType、currency 升序。请求示例
响应示例
日汇总查询
查询参数
string
必填
开始日期,格式
yyyy-MM-ddstring
必填
结束日期,格式
yyyy-MM-dd;与 startDate 跨度不超过 366 天string
必填
分页大小,正整数字符串;取值
1 ~ 400,超过 400 按 400 处理string
必填
当前页码,正整数字符串,从
1 开始分页粒度为「账单日 × 账号」,
data.total 为满足条件的组合总数。响应行字段(data.rows[])
排序规则:
billDay 降序,其次 account 升序。请求示例
响应示例
业务规则与约定
- 金额精度:所有金额字段以
string传输,保留 8 位小数,避免 JSON number 精度丢失。 - 金额一致性:同一账单日、同一账号下,日汇总的各金额字段等于该日消费明细对应金额字段之和(跨页累加)。
- 零消费日:查询区间内无消费的日期不返回记录。
- 数据延迟:账单数据为 T+1,即最新一天的数据在次日可查询。
- 账号范围与企业管理:默认情况下,凭证只能查询自身账号的账单数据。若该账号已开通「企业管理」并作为主账号,则可见其名下全部子账号的账单——此时不传
userId/userName返回全部子账号,传入则筛选到指定子账号(子账号自身的凭证仅能查询自己)。开通企业管理请联系平台管理员。 - 分页越界:当
pageNum超过总页数时,返回空rows,total仍为真实总数。
