更新記錄
值得關注的平台與 API 變更,最新在前。要追蹤機器可讀的規範版本,
請關注 /openapi.json 裡的 OpenAPI
info.version —— 它為開發者 API 的每一個已發佈版本打上戳記。
破壞性變更會被顯式標出,並附帶遷移說明。增量變更(新端點、新的可選欄位、 新的回應標頭)不算破壞性 —— 請把客戶端寫成能容忍未知欄位的,這樣介面範圍 擴大時它們仍能繼續工作。
如何追蹤變更
- 規範版本 ——
info.version(帶日期戳,例如2026-06-17),開發者 API 介面範圍變化時遞增。對規範做 diff 就能準確看出改了什麼。 - 發現 ——
/.well-known/oauth-authorization-server反映當前的 OAuth 端點集合;請讀取它,而不要把 URL 寫死。 - 本頁 —— 對值得知曉的變更給出的人類可讀摘要,現已建立,並隨平台演進 持續增補。
近期變更
API 規範 2026-06-17
- 應用版本管理端點已發佈。
POST/GET /developer/clients/{clientId}/versions(以及審核人員端點) 現已進入 OpenAPI 規範 —— 提交整個應用的配置快照送審,而不是就地編輯 一個線上客戶端。參見 應用版本管理。
更早的版本奠定了核心介面範圍:OAuth 2.0 + PKCE 及 refresh / revoke / introspect、OpenID Connect、動態客戶端註冊、受權限範圍管控的 數據 API(配方 / 基因 / 複用)、配方建立 + 發佈、webhook,以及 已連結應用和開發者計劃相關端點。