千问办公企业旗舰版开发者文档:查询当前用户个人余额。
认证方式见APP开发者文档 → 认证接入。
普通用户可以查询本人额度,不要求管理员配额管理权限。
无路径参数、查询参数或请求体。用户、组织与团队均来自可信身份;不能传入
HTTP 200,响应体直接返回以下对象,不包裹
1 Credit = 10000 minor units。上述示例分别为 100、25、75 Credits。使用字符串保留整数精度,避免直接转换为 JavaScript Number 后丢失大整数精度。
真实零余额仍返回 HTTP 200 和
- 接口:GET
/api/openapi/app/v1/quota - 服务:Biz
- operationId:
consoleGetPersonalQuota - 范围:当前用户个人额度。
权限与归属
普通用户可以查询本人额度,不要求管理员配额管理权限。
请求参数
无路径参数、查询参数或请求体。用户、组织与团队均来自可信身份;不能传入 user_id、team_id 查询他人额度,任何查询参数均返回 422。
调用示例:
成功响应
HTTP 200,响应体直接返回以下对象,不包裹 data;响应头为 Cache-Control: no-store。
| 字段 | 类型 | 必填 | 含义 |
|---|---|---|---|
allowance_minor | string | 是 | 个人总额度,非负十进制整数字符串 |
used_minor | string | 是 | 个人已用额度,非负十进制整数字符串 |
remaining_minor | string | 是 | 个人剩余额度,max(allowance_minor - used_minor, 0) |
错误与展示
| HTTP 状态 | 含义 | 调用方处理 |
|---|---|---|
| 401 | 未登录或可信用户、组织、团队身份不完整 | 按认证接入处理 |
| 403 | 入口身份或 audience 校验拒绝 | 核对当前 员工登录入口 |
| 422 | 携带查询参数,personal_quota_query_invalid | 去掉查询参数 |
| 503 | 配额缺失、上游失败或超时等,personal_quota_unavailable | 显示“余额暂不可用”,不沿用旧余额 |
remaining_minor: "0"。查询失败不表示零余额或无限额度。余额查询只用于展示,不预扣额度,也不替代 Session 在创建会话、后续消息和定时执行时的后台校验。