4.3 ext API 端點總覽（cogwork 實際會呼叫的）
| Method | Path | Scope | cogwork 對應功能 |
|---|---|---|---|
| GET | /api/ext/releases | releases:read | 上線清單列表 |
| GET | /api/ext/releases/{id} | releases:read | 上線單細項 |
| PUT | /api/ext/releases/{id}/status | releases:write-status | （cogwork 未使用；為 Jenkins pipeline 自動回報部署結果保留） |
| PUT | /api/ext/releases/{id}/feedback | releases:write-feedback | 上線回填（狀態/急上/退版） |
| GET | /api/ext/systems/{systemId}/jenkins-jobs | jenkins-jobs:read | Jenkins 執行面板的 job 清單 |
| GET | /api/ext/config-server-changes | config-server:read | Config Server 待處理清單 |
| PUT | /api/ext/config-server-changes/{id} | config-server:write | Config Server 套用後標記完成 |
cogwork 使用的 API Key 需要同時具備 releases:read、releases:write-feedback、jenkins-jobs:read、config-server:read、config-server:write 這幾個 scope，於 Admin → 憑證設定 → API 金鑰 設定。