应用版本管理
把整个应用的配置变更作为一个可审核的版本发布,而不是就地编辑一个线上客户端。 你提交一份完整的配置快照 —— 名称、重定向 URI、权限范围以及声明的 webhook 事件 —— 并附上变更说明和申请理由;在审核人员批准之前,线上客户端继续以当前配置提供服务。 批准后,该快照会被原子性地应用。
- 提交一个新版本,包含更新后的配置快照、变更说明和申请理由。
- 版本处于
pending审核状态期间,线上应用继续按当前配置运行 —— 只有批准才会把它提升到生产环境。 - 每个应用同一时间最多只能有一个未关闭(
draft/pending)的版本。 - 快照可以携带自助权限范围与审核级权限范围(
account:read、a2a、recipe:express);审核级权限范围由审核人员在批准时授权 —— 与单个权限范围申请 完全一样。node:manage之类需团队审批的权限范围会从快照中剔除。
端点
拥有者端点使用会话认证(开发者门户)。审核端点需要审核人员权限。
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /developer/clients/{clientId}/versions | 提交新版本 —— { config, changelog, justification };速率限制为 20 次/小时 |
| GET | /developer/clients/{clientId}/versions | 列出该应用的各个版本,最新的在前 |
| GET | /admin/oauth/client-versions | 审核人员:审核队列 · ?status=pending|approved|rejected|all ?limit |
| PATCH | /admin/oauth/client-versions/{id} | 审核人员:{ decision: approved|rejected, reject_reason? } —— 批准即应用该快照 |
完整的请求/响应结构见 OpenAPI 规范中的 App versions 标签:OpenAPI 3.1 (JSON) · YAML。