版本管理

依照文件化的 v1 契約串接,不要假設 OAuth 相容性。

目前的 Partner Auth consent 契約在平台內部標識為 partner-auth-v1。Endpoint 路徑尚未加入 URL 版本號。

第三方串接必須:

  • 只解析文件化的欄位,並忽略新增的欄位;
  • 將未文件化的行為視為不穩定;
  • 把 callback 與 token 邏輯隔離在 integration adapter 之後;
  • 在採用變更後的 scope 或回應契約之前,先檢視 release notes。

破壞性的契約變更需要新的文件化版本與遷移指引。S256 PKCE 為選用功能:App 會傳遞 challenge,token exchange 會強制驗證對應的 verifier;未提供 challenge 的既有 client secret 流程維持相容。目前的協定不得宣傳為符合 OAuth 2.1 或 OpenID Connect。