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

读取本人关系统计

请求参数

无参数,要求注册完成且通过VIP准入ROLE_USER。返回following、followers、friends、visitors、blocked非负整数。friends为互相关注,visitors为独立最近访客数;禁用/注销/未完成账号不计入,不返回伪造增量。

所有调用发送八项公共头,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/relationships/counts', 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按当前会话注入。

成功响应

新增非空followerNotifications:{unreadCount,lastSequence,readSequence},三个值均为非负整数,readSequence≤lastSequence;无记录为0。它表示本人持久粉丝提示,不用总数差值推算。历史关注基线为已读,普通GET不清零;完整字段、取关/屏蔽/注销及并发确认语义见确认粉丝列表已读。

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

{"following":0,"followers":0,"friends":0,"visitors":0,"blocked":0,"followerNotifications":{"unreadCount":0,"lastSequence":0,"readSequence":0}}

失败响应

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 依赖或投递不可用,不伪装成功

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

接入说明

访客查询、统计及主页访客预览共用有效账号及双向屏蔽过滤;历史残留访问也不会使已屏蔽、禁用、注销或未完成注册的账号进入访客列表或总数。预览最多3位,独立访客总数不受预览上限影响。

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

验证:373项服务器Java回归通过,覆盖账号安全/注销、通知并发与JWE、关系及归属、钱包、反馈及审计回滚、迁移和媒体清理。另41项真实dev HTTP闭环通过,仅使用本次创建的2个合成账号,完成后均已注销,未发真实短信邮件或支付。后台反馈处理、七天到期任务和媒体物理删除仍以隔离库测试为验证范围。完整对照见我的与设置接入。