千问办公企业旗舰版开发者文档:查询积分收支流水。
认证方式见APP开发者文档 → 认证接入。
不使用客户 API Key,不接受 user_id、tenant_id 等身份参数。普通成员无需管理员权限。响应使用
401:未登录或身份缺失;403:身份/业务准入或上游拒绝;422:参数不合法;502:上游响应异常;503:服务未配置或上游不可用/限流;504:上游超时。失败不能解释为零消耗。未知或重复查询参数会被拒绝。
此接口不支持游标,返回上游当前提供的流水集合,页面在前端对返回集合分页。
items 中包含 amount、created_at、detail.title、type;source、session_id 可缺省。type 透传上游,不将其限制为消耗/收入两种。金额可正、负或零,流水可能包含过期记录。
- 接口:GET
/api/openapi/app/v1/billings - 服务:Biz
- operationId:
appListBillingHistory
权限与归属
不使用客户 API Key,不接受 user_id、tenant_id 等身份参数。普通成员无需管理员权限。响应使用 Cache-Control: no-store。
金额 amount 是 Credits 十进制字符串(例如 "-1.2345"),不是 quota 接口的 minor 单位;保留正负号与精度。时间为 RFC 3339 字符串。成功响应直接返回对象,无 data 包装。
错误
401:未登录或身份缺失;403:身份/业务准入或上游拒绝;422:参数不合法;502:上游响应异常;503:服务未配置或上游不可用/限流;504:上游超时。失败不能解释为零消耗。未知或重复查询参数会被拒绝。
请求参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| source | string | all | all、qwenwork_web、desktop |
成功响应
响应字段
| 字段 | 类型 | 必返 | 说明 |
|---|---|---|---|
| items | array<object> | 是 | 上游当前提供的流水集合;不提供服务端分页游标。 |
| items[].amount | string | 是 | Credits 十进制字符串,保留精度及正负号;不是 minor 单位。 |
| items[].created_at | string | 是 | 流水创建时间,RFC 3339。 |
| items[].detail | object | 是 | 流水详情。 |
| items[].detail.title | string | 是 | 流水展示标题。 |
| items[].type | string | 是 | 上游流水类型,不限制为收入/消耗两种。 |
| items[].source | string | 否 | 流水来源,按实际响应返回。 |
| items[].session_id | string | 否 | 关联会话标识;非会话流水可能省略。 |