跳到正文
MuoCeon 文档中心
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扩展档案:性别、生日、年龄、语言、时区、简介、metadataaccount

受众不同就是硬隔离:第三方客户端默认只有 auth 受众,拿不到 account 的令牌,因此连 /me 的门都进不去,不需要再额外判断「这是不是第一方客户端」。

认证

Authorization: Bearer <access_token>,受众 account,scope 见上表。

错误形态

资源类接口统一返回 { success, code, message, details?, timestamp };401 与 403 的分界、近期认证未满足时的形态见错误码。

本页目录