2.6 KiB
2.6 KiB
后端接口 TODO 清单 - 社交功能模块
1. 关注/取消关注主播
文件: RoomDetailActivity.java
接口路径: POST /api/follow 或 DELETE /api/follow
请求参数:
{
"streamerId": "string",
"action": "follow|unfollow"
}
返回数据:
{
"code": 200,
"data": {
"success": true,
"message": "string"
}
}
2. 获取关注列表
文件: FollowingListActivity.java
接口路径: GET /api/users/{userId}/following
请求参数:
- userId: 用户ID(路径参数)
- page (可选): 页码
- pageSize (可选): 每页数量 返回数据:
{
"code": 200,
"data": [
{
"userId": "string",
"username": "string",
"avatarUrl": "string",
"bio": "string",
"isLive": "boolean"
}
]
}
3. 获取粉丝列表
文件: FansListActivity.java
接口路径: GET /api/users/{userId}/fans
请求参数: 同上
返回数据: 同上
4. 获取好友列表
文件: MyFriendsActivity.java
接口路径: GET /api/users/{userId}/friends
请求参数: 同上
返回数据: 同上
5. 添加好友
文件: MyFriendsActivity.java
接口路径: POST /api/friends/add
请求参数:
{
"friendId": "string"
}
返回数据:
{
"code": 200,
"data": {
"success": true
}
}
6. 删除好友
文件: MyFriendsActivity.java
接口路径: DELETE /api/friends/{friendId}
请求参数: friendId (路径参数)
返回数据:
{
"code": 200,
"data": {
"success": true
}
}
7. 获取附近的人
文件: MainActivity.java
接口路径: GET /api/users/nearby
请求参数:
- latitude: 纬度
- longitude: 经度
- radius (可选): 半径(公里),默认10 返回数据:
{
"code": 200,
"data": [
{
"userId": "string",
"username": "string",
"avatarUrl": "string",
"distance": "number",
"bio": "string"
}
]
}
8. 搜索好友
文件: MyFriendsActivity.java
接口路径: GET /api/friends/search
请求参数:
- userId: 当前用户ID(从token中获取)
- keyword: 搜索关键词
- page (可选): 页码
- pageSize (可选): 每页数量 返回数据:
{
"code": 200,
"data": [
{
"userId": "string",
"username": "string",
"avatarUrl": "string",
"subtitle": "string",
"isOnline": "boolean",
"lastOnlineTime": "number"
}
]
}
说明:
- 搜索范围包括:好友昵称、备注、共同关注等
- 支持模糊搜索