xiaozhang/zhibo

xiao12feng8 ecaed42912 添加Log文档目录：后端接口分析报告

2025-12-26 16:17:47 +08:00

12 KiB

Raw Blame History

直播社交接口完整分析报告

生成时间: 2024年12月26日 分析范围: Android App 与 Zhibo-H 后端直播社交接口对比说明: 本报告只分析直播社交相关接口，不包含电商接口

📊 总体概况

一、后端接口状态统计

分类	后端已实现	后端未实现	App已对接	App未对接
用户认证	6	0	2	4
用户资料	4	3	1	3
直播间	10	3	4	6
私聊消息	10	1	8	2
好友管理	6	0	6	0
礼物打赏	5	0	0	5
在线状态	7	0	0	7
离线消息	6	0	0	6
通话功能	10	0	0	10
文件上传	2	0	0	2
社交功能	0	8	0	0
通知推送	0	5	0	0
作品管理	0	6	0	0
搜索功能	0	4	0	0

二、关键数据

指标	数量
后端已实现接口	66 个
后端未实现接口	30 个
App已对接接口	21 个
App未对接(后端已有)	45 个
后端完成度	69%
App对接完成度	32%

✅ 第一部分：后端已实现 + App已对接（21个）

1. 用户认证 (2个)

接口	后端路径	App调用位置
账号密码登录	`POST /api/front/login`	LoginActivity
用户注册	`POST /api/front/register`	RegisterActivity

2. 用户资料 (1个)

接口	后端路径	App调用位置
获取用户信息	`GET /api/front/user/info`	ConversationActivity

3. 直播间 (4个)

接口	后端路径	App调用位置
获取直播间列表	`GET /api/front/live/public/rooms`	MainActivity
获取直播间详情	`GET /api/front/live/public/rooms/{id}`	RoomDetailActivity
创建直播间	`POST /api/front/live/rooms`	MainActivity
删除直播间	`DELETE /api/front/live/rooms/{id}`	ApiService

4. 私聊消息 (8个)

接口	后端路径	App调用位置
获取会话列表	`GET /api/front/conversations`	MessagesActivity
获取/创建会话	`POST /api/front/conversations/with/{userId}`	MyFriendsActivity
标记会话已读	`POST /api/front/conversations/{id}/read`	ConversationActivity
删除会话	`DELETE /api/front/conversations/{id}`	MessagesActivity
获取消息列表	`GET /api/front/conversations/{id}/messages`	ConversationActivity
发送私信	`POST /api/front/conversations/{id}/messages`	ConversationActivity
删除消息	`DELETE /api/front/conversations/messages/{id}`	ConversationActivity
撤回消息	`POST /api/front/conversations/messages/{id}/recall`	ConversationActivity

5. 好友管理 (6个) ✅ 完全对接

接口	后端路径	App调用位置
搜索用户	`GET /api/front/users/search`	AddFriendActivity
发送好友请求	`POST /api/front/friends/request`	AddFriendActivity
获取好友请求列表	`GET /api/front/friends/requests`	MyFriendsActivity
处理好友请求	`POST /api/front/friends/requests/{id}/handle`	MyFriendsActivity
获取好友列表	`GET /api/front/friends`	MyFriendsActivity
删除好友	`DELETE /api/front/friends/{friendId}`	MyFriendsActivity

⚠️ 第二部分：后端已实现 + App未对接（45个）

1. 用户认证 (4个)

接口	后端路径	App需要修改
手机号登录	`POST /api/front/login/mobile`	LoginActivity
发送验证码	`POST /api/front/sendCode`	RegisterActivity
退出登录	`GET /api/front/logout`	SettingsPageActivity
Token校验	`POST /api/front/token/is/exist`	MainActivity

2. 用户资料 (3个)

接口	后端路径	App需要修改
获取用户中心	`GET /api/front/user`	ProfileActivity
修改个人资料	`POST /api/front/user/edit`	EditProfileActivity
修改密码	`POST /api/front/register/reset`	SettingsPageActivity

3. 直播间 (6个)

接口	后端路径	App需要修改
获取弹幕消息	`GET /api/front/live/public/rooms/{roomId}/messages`	RoomDetailActivity
发送弹幕消息	`POST /api/front/live/public/rooms/{roomId}/messages`	RoomDetailActivity
获取观看人数	`GET /api/front/live/public/rooms/{roomId}/viewers/count`	RoomDetailActivity
关注/取消关注主播	`POST /api/front/live/follow`	RoomDetailActivity
SRS推流回调	`POST /api/front/live/srs/on_publish`	服务端回调
SRS停流回调	`POST /api/front/live/srs/on_unpublish`	服务端回调

4. 私聊消息 (2个)

接口	后端路径	App需要修改
搜索会话	`GET /api/front/conversations/search`	MessagesActivity
获取消息详情	`GET /api/front/conversations/messages/{id}`	ConversationActivity

5. 礼物打赏 (5个) ⚠️ 完全未对接

接口	后端路径	App需要修改
获取礼物列表	`GET /api/front/gift/list`	RoomDetailActivity
获取用户余额	`GET /api/front/gift/balance`	RoomDetailActivity
赠送礼物	`POST /api/front/gift/send`	RoomDetailActivity
获取充值选项	`GET /api/front/gift/recharge/options`	新建RechargeActivity
创建充值订单	`POST /api/front/gift/recharge/create`	新建RechargeActivity

6. 在线状态 (7个) ⚠️ 完全未对接

接口	后端路径	App需要修改
检查用户在线	`GET /api/front/online/status/{userId}`	MyFriendsActivity
批量检查在线	`POST /api/front/online/status/batch`	MyFriendsActivity
获取房间在线用户	`GET /api/front/online/room/{roomId}/users`	RoomDetailActivity
获取房间在线人数	`GET /api/front/online/room/{roomId}/count`	RoomDetailActivity
获取离线消息数量	`GET /api/front/online/offline/count/{userId}`	MainActivity
获取离线消息	`GET /api/front/online/offline/messages/{userId}`	MainActivity
清除离线消息	`DELETE /api/front/online/offline/messages/{userId}`	MainActivity

7. 离线消息 (6个) ⚠️ 完全未对接

接口	后端路径	App需要修改
获取离线消息数量	`GET /api/front/offline-messages/count/{userId}`	MainActivity
获取离线消息列表	`GET /api/front/offline-messages/list/{userId}`	MainActivity
获取所有离线消息	`GET /api/front/offline-messages/all/{userId}`	MainActivity
清除离线消息	`DELETE /api/front/offline-messages/clear/{userId}`	MainActivity
删除指定数量	`DELETE /api/front/offline-messages/remove/{userId}`	MainActivity
保存离线消息	`POST /api/front/offline-messages/save`	测试接口

8. 通话功能 (10个) ⚠️ 完全未对接（刚实现）

接口	后端路径	App需要修改
发起通话	`POST /api/front/call/initiate`	新建CallActivity
接听通话	`POST /api/front/call/accept/{callId}`	新建CallActivity
拒绝通话	`POST /api/front/call/reject/{callId}`	新建CallActivity
取消通话	`POST /api/front/call/cancel/{callId}`	新建CallActivity
结束通话	`POST /api/front/call/end/{callId}`	新建CallActivity
获取通话记录	`GET /api/front/call/history`	新建CallHistoryActivity
删除通话记录	`DELETE /api/front/call/record/{recordId}`	新建CallHistoryActivity
获取未接来电数	`GET /api/front/call/missed/count`	MainActivity
获取通话状态	`GET /api/front/call/status`	新建CallActivity
获取通话详情	`GET /api/front/call/detail/{callId}`	新建CallActivity

9. 文件上传 (2个)

接口	后端路径	App需要修改
图片上传	`POST /api/front/upload/image`	EditProfileActivity, ConversationActivity
文件上传	`POST /api/front/upload/file`	ConversationActivity

❌ 第三部分：后端未实现（30个）

1. 用户资料 (3个)

接口	期望路径	优先级
获取其他用户资料	`GET /api/front/user/profile/{userId}`	高
获取登录设备列表	`GET /api/front/user/devices`	低
注销账号	`POST /api/front/user/delete`	低

2. 直播间 (3个)

接口	期望路径	优先级
获取房间分类列表	`GET /api/front/live/categories`	中
获取关注主播直播间	`GET /api/front/live/following/rooms`	高
获取推荐直播间	`GET /api/front/live/recommend`	中

3. 私聊消息 (1个)

接口	期望路径	优先级
获取未读消息总数	`GET /api/front/messages/unread/count`	高

4. 社交功能 (8个) ⚠️ 重要

接口	期望路径	优先级
关注用户	`POST /api/front/follow/{userId}`	高
取消关注	`DELETE /api/front/follow/{userId}`	高
获取关注列表	`GET /api/front/following`	高
获取粉丝列表	`GET /api/front/fans`	高
获取获赞列表	`GET /api/front/likes`	中
获取附近用户	`GET /api/front/users/nearby`	中
检查关注状态	`GET /api/front/follow/status/{userId}`	高
获取社交数量	`GET /api/front/user/social/count`	高

5. 通知推送 (5个) ⚠️ 重要

接口	期望路径	优先级
获取通知列表	`GET /api/front/notifications`	高
标记通知已读	`POST /api/front/notifications/{id}/read`	高
标记全部已读	`POST /api/front/notifications/read/all`	中
获取通知设置	`GET /api/front/notifications/settings`	中
更新通知设置	`PUT /api/front/notifications/settings`	中

6. 作品管理 (6个)

接口	期望路径	优先级
发布作品	`POST /api/front/works`	高
获取作品列表	`GET /api/front/works`	高
获取作品详情	`GET /api/front/works/{id}`	高
删除作品	`DELETE /api/front/works/{id}`	中
点赞作品	`POST /api/front/works/{id}/like`	中
收藏作品	`POST /api/front/works/{id}/collect`	中

7. 搜索功能 (4个)

接口	期望路径	优先级
综合搜索	`GET /api/front/search`	高
搜索直播间	`GET /api/front/search/rooms`	中
搜索作品	`GET /api/front/search/works`	中
获取热门搜索	`GET /api/front/search/hot`	低

🎯 开发优先级建议

第一优先级：App对接已有接口（工作量小，见效快）

模块	接口数	预计工时
礼物打赏	5	2天
在线状态	7	1天
离线消息	6	1天
用户资料	3	1天
直播间弹幕	4	1天
文件上传	2	0.5天
小计	27	6.5天

第二优先级：后端开发新接口

模块	接口数	预计工时
社交功能	8	3-4天
通知推送	5	2-3天
作品管理	6	3-4天
搜索功能	4	2天
小计	23	10-13天

第三优先级：通话功能App对接

模块	接口数	预计工时
通话功能	10	5-7天

📊 总结

类型	数量	状态
后端已实现 + App已对接	21	✅ 已完成
后端已实现 + App未对接	45	⚠️ 需App开发
后端未实现	30	❌ 需后端+App开发
总计	96

总预计工时: 21-26 天

报告生成时间: 2024年12月26日