千问办公企业旗舰版开发者文档:查询网盘容量。
认证方式见APP开发者文档 → 认证接入。
当前用户身份由 IAM 验证,Barn 执行文件归属与业务校验。不使用管理 API Key、Agent Token 或 OAuth 凭据替代,不自行设置 X-Gw 身份头。
容量和单文件上限来自 Barn 配置;已用空间读取根目录累计 size。单位均为字节,零配额是真实限制。禁止提交 user_id;读取失败应显示容量不可用,不以 100 GiB 或零用量代替。响应为 Cache-Control: no-store。
200 返回裸 JSON 对象。
401 表示认证失败,403 表示资源权限拒绝;400/422 表示参数无效,404 表示当前用户资源不存在,409 表示冲突。依赖故障保持原错误,不伪造成功;503 为维护或依赖不可用,504 为请求超时。写操作结果未知时先查询资源状态,不盲目重复执行。
- 模块:文件
- 接口:GET
/api/openapi/app/v1/drive/quota - operationId:
app-get-quota
接口说明
当前用户身份由 IAM 验证,Barn 执行文件归属与业务校验。不使用管理 API Key、Agent Token 或 OAuth 凭据替代,不自行设置 X-Gw 身份头。
容量和单文件上限来自 Barn 配置;已用空间读取根目录累计 size。单位均为字节,零配额是真实限制。禁止提交 user_id;读取失败应显示容量不可用,不以 100 GiB 或零用量代替。响应为 Cache-Control: no-store。
请求参数
| 字段 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| 无 | — | — | — | 无 query/body,用户从登录态取得 |
响应
200 返回裸 JSON 对象。
响应字段
| 字段 | 类型 | 必返 | 约束 | 说明 |
|---|---|---|---|---|
| max_file_size_bytes | integer | 是 | int64 | 单文件允许的最大字节数。 |
| max_storage_bytes | integer | 是 | int64 | 当前用户存储配额,单位字节;0 是真实限制。 |
| used_storage_bytes | integer | 是 | int64 | 当前用户已使用空间,取根目录累计大小,单位字节。 |