應用版本管理
把整個應用的配置變更作為一個可審核的版本發佈,而不是就地編輯一個線上客戶端。 你提交一份完整的配置快照 —— 名稱、重定向 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。