从这里开始

谁调用谁

管理员 → 千问办公控制台 → 千问办公服务 → 企业 SPI 适配服务 → 企业额度与用量系统
                                         ← HTTP 200 + JSON ←

你需要实现右侧的 HTTP 接口。千问办公发起请求，企业服务验证 Token 与组织、执行操作并返回约定的 JSON。浏览器不直接调用企业 SPI。

接入方式	调用方向	凭据与用途
OpenAPI	企业应用 → 千问办公	开放平台应用 API Key；调用办公能力
本手册的业务 SPI	千问办公 → 企业服务	独立 SPI Token；读取统计、设置及读取限额
模型 BYOK	千问办公 → 模型 Provider	模型配置中的 Endpoint 与可选 API Key；执行模型请求

模型仍在模型管理中单独配置。业务 SPI 不代理模型请求，也不替企业模型完成计量与限额拦截。启用客户额度后，模型请求需要有效的第三方用户身份，企业模型服务应使用同一身份关联消费。

八个接口共用一个服务地址、Token 和启用开关，不能在控制台分别开启统计或额度。下表“调用时机”说明当前宿主行为；不要仅凭连通性检测通过判断全部接口已完成。

接口名称	Method 与路径	职责	调用时机
获取最新统计日期	`GET /spi/v1/usage/meta`	最新完整数据日期	统计刷新、手动连通性检测
查询组织用量概览	`GET /spi/v1/usage/overview`	组织历史用量	按日期和五个周期构建快照
查询成员用量列表	`GET /spi/v1/usage/members`	成员历史用量	构建快照，读取全部分页
查询成员每日用量趋势	`GET /spi/v1/usage/members/{external_user_id}/trend`	成员每日趋势	查看成员趋势时按需读取
查询额度规则与周期	`GET /spi/v1/quota/context`	额度约束与当前周期	校验额度、确定周期边界
查询成员额度	`POST /spi/v1/quota/users/query`	已应用的成员额度	SDK 显式查询；当前产品不强制写后回读
设置成员限额	`PUT /spi/v1/quota/users`	设置单个成员的绝对限额	后台派发与重试额度变更
查询组织额度	`GET /spi/v1/quota/org`	实时组织总额度与已用量	查询组织额度

示例中的域名、身份和数据仅用于说明。真实联调应使用测试组织、已绑定的测试用户及独立测试凭据。