GET/api/v1/me/account
本人Bearer及八项App公共头JSON 响应接入指南 ↗

读取本人账号与安全

请求参数

无参数。返回userId、publicId数字字符串、bindings数组(type、maskedAccount、changeSupported)、canVerifyAccount、deletionState、deletionExecuteAt。只有本人可读;号码和邮箱脱敏,三方主体不返回。

脱敏展示

bindings[].maskedAccount由服务端直接生成,客户端逐字展示,不使用登录输入或设计示例补齐。国内E.164手机号单列真实+86前缀,号码保留前三位与末四位,例如+86 138****1234;其他11–15位数字号码保留原有+及前三位/末四位,中间按实际长度隐藏且至少四位。历史8–10位短号仅返回***加末四位,无法识别的号码返回***。邮箱仍保留首字符和域名。旧版只返回尾四位的响应由客户端兼容显示为“尾号1234”,不能推测已被隐藏的号段。

当前验证挑战、新绑定挑战及换绑成功响应的同名字段复用此规则;不会增加完整手机号字段,也不改变验证码目的、身份核验或换绑权限。

所有调用发送八项公共头,app/android或ios及当前包渠道,安装ID与会话一致。未知字段拒绝或按本文明确范围处理,身份只来自Bearer。JSON沿用统一响应和AES/JWE,正式要求HTTPS和真实JWE;GET密文放X-Budyoo-JWE。当前固定码dev仅供隔离账号联调,prod禁止HTTP和固定码。message四语,缺省/未知语言英文,code不翻译。

请求示例

以下方法路径为契约,UUID/数据为合成示例;通过既有统一客户端发送动态语言、完整元数据和Bearer,禁止记录凭据。

await api.request({path: '/api/v1/me/account', method: 'GET'});

统一层必须提供Accept-Language、X-Client-Type=app、X-Platform、X-App-Version、X-App-Build、X-Channel、持久X-Device-Id及每次新X-Request-Id/X-Request-Timestamp,Authorization按当前会话注入。

成功响应

HTTP200,外层code=SUCCESS、message为当前语言、data为本页说明的对象(无返回时null)、errors=[]。

{"userId":"11111111-1111-4111-8111-111111111111","publicId":"10000001","bindings":[{"type":"email","maskedAccount":"a***@example.test","changeSupported":true}],"canVerifyAccount":true,"deletionState":"NONE","deletionExecuteAt":null}

失败响应

HTTP code 处理
400 BAD_REQUEST/VALIDATION_FAILED/INVALID_CLIENT_HEADERS 参数或公共头不合法
401 UNAUTHORIZED 无效凭据、安装不一致或会话已撤销
403 FORBIDDEN/ACCOUNT_DISABLED/VIP_REQUIRED 按角色、账号状态及VIP准入处理
404 NOT_FOUND 目标不存在、不可见或不属于本人
426 HTTPS_REQUIRED 当前模式要求安全传输
503 SERVICE_UNAVAILABLE 依赖或投递不可用,不伪装成功

各错误仅在对应操作适用;加密失败沿用公共协议。写请求超时不等于没有执行,不自动盲目重试敏感操作。

接入说明

本人UI以真实返回为准,失败保留输入并显示重试;只有成功空结果可显示空态,不以设计昵称、余额、列表补数据。切换账号或退出后取消旧请求,迟到响应不能写入新会话。

验证:2026-11-06服务器812项clean verify全部通过,失败/错误/跳过均为0。新增11项脱敏边界与1项真实HTTP测试,覆盖国内/国际/历史短号、开发身份、邮箱兼容,以及手机号认证后账号读取和二次验证挑战返回一致掩码且不含完整号码。换绑、验证码、会话撤销、注销及权限继续由既有回归覆盖。以上使用隔离数据库与投递测试适配器;真实短信/邮件投递按供应商配置另行验收。完整对照见我的与设置接入。