外观
用户、好友与申请
查看资料、管理好友,以及处理好友申请、入群申请和群邀请。
每个接口独立列出请求参数、返回字段和示例。点击下方接口名称即可查看。
接口列表
| 接口 | 方法 | 路径 |
|---|---|---|
| 修改当前用户资料 | 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 去重。服务器可能因已有反向申请而直接建立好友关系。
申请列表与处理
好友申请、入群申请和群邀请共用申请中心。只有待处理且本人有权限的申请可以同意或拒绝。
