身份兼容性
身份兼容性
以接口合同为准
每个公开接口在 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；完整处理方法见 错误与重试。