跳转到正文

用户、好友与申请 ​

查看资料、管理好友,以及处理好友申请、入群申请和群邀请。

每个接口独立列出请求参数、返回字段和示例。点击下方接口名称即可查看。

接口列表 ​

接口方法路径
修改当前用户资料POST/app/sdk/users/me
获取用户资料GET/app/sdk/users/profile
按账号精确查找用户GET/app/sdk/users/search
读取好友目录GET/app/sdk/friends
设置好友备注POST/app/sdk/friends/remark
设置拉黑状态POST/app/sdk/friends/block
删除好友POST/app/sdk/friends/delete
发送好友申请POST/app/sdk/friends/request
读取申请列表GET/app/sdk/notices
读取申请详情GET/app/sdk/notices/detail
同意或拒绝申请POST/app/sdk/notices/handle

当前用户资料 ​

修改当前用户资料时,省略的字段保持原值。如果资料由宿主管理,应统一从宿主后端同步。

获取用户资料 ​

一次返回资料、好友关系和允许执行的操作,资料页可据此显示按钮。

精确搜索账号 ​

完整账号使用精确查找;名称、备注或聊天内容使用统一搜索。

好友目录 ​

支持首字母分组和名称、备注筛选。继续翻页只传游标,不重复提交筛选条件。

好友关系操作 ​

备注只影响本人看到的名称。拉黑和删除后,以回包中的关系和权限更新界面。

发送好友申请 ​

申请使用 request_id 去重。服务器可能因已有反向申请而直接建立好友关系。

申请列表与处理 ​

好友申请、入群申请和群邀请共用申请中心。只有待处理且本人有权限的申请可以同意或拒绝。