身份兼容性
身份兼容性
以接口合同為準
每個公開接口在 API 參考 中列出允許的身份、憑證和 scopes。不要使用歷史版本的靜態接口表推斷當前授權條件。
| 接口 | 接入條件 |
|---|---|
| GET /v1/users/me | USER；OAuth2 或 API Key；user:profile |
| GET /v1/scopes | 無需憑證 |
| POST /v1/creative/assets | USER 或 ORG；creative；其他字段按 API 參考 |
OAuth 瀏覽器入口是 accounts 的 /oauth2/authorize，token 入口是 /oauth2/token。不要把業務 API 的受保護 RPC 當作瀏覽器登錄入口。
發生鑑權或權限錯誤時讀取真實 HTTP 狀態與 error.details 中的 reason。公開 REST 錯誤採用嵌套 error envelope；完整處理方法見 錯誤與重試。