v1account 上下文
account 上下文总览
v1 account 上下文(基础路径 /v1/account,受众 account)的接口一览与边界。
account 上下文管的是账户资料本身——与「登录凭据」和「授权关系」都无关的那部分数据。它的令牌受众是 account。
基础路径:{origin}/v1/account。
接口
| 方法 | 路径 | 说明 | scope |
|---|---|---|---|
GET | /v1/account/me | 读取账户资料 | account:profile:read |
PATCH | /v1/account/me | 局部修改账户资料 | account:profile:write |
逐字段说明见账户资料。
与 auth 的 profile 有什么区别
| 接口 | 管什么 | 受众 |
|---|---|---|
/v1/auth/profile、/v1/auth/username | 身份资料:显示名、用户名 | auth |
/v1/auth/userinfo | 对外可读的身份字段 | auth |
/v1/account/me | 扩展档案:性别、生日、年龄、语言、时区、简介、metadata | account |
受众不同就是硬隔离:第三方客户端默认只有 auth 受众,拿不到 account 的令牌,因此连 /me 的门都进不去,不需要再额外判断「这是不是第一方客户端」。
认证
Authorization: Bearer <access_token>,受众 account,scope 见上表。
错误形态
资源类接口统一返回 { success, code, message, details?, timestamp };401 与 403 的分界、近期认证未满足时的形态见错误码。