143 lines
2.6 KiB
Markdown
143 lines
2.6 KiB
Markdown
# 后端接口 TODO 清单 - 社交功能模块
|
||
|
||
## 1. 关注/取消关注主播
|
||
**文件**: `RoomDetailActivity.java`
|
||
**接口路径**: `POST /api/follow` 或 `DELETE /api/follow`
|
||
**请求参数**:
|
||
```json
|
||
{
|
||
"streamerId": "string",
|
||
"action": "follow|unfollow"
|
||
}
|
||
```
|
||
**返回数据**:
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": {
|
||
"success": true,
|
||
"message": "string"
|
||
}
|
||
}
|
||
```
|
||
|
||
## 2. 获取关注列表
|
||
**文件**: `FollowingListActivity.java`
|
||
**接口路径**: `GET /api/users/{userId}/following`
|
||
**请求参数**:
|
||
- userId: 用户ID（路径参数）
|
||
- page (可选): 页码
|
||
- pageSize (可选): 每页数量
|
||
**返回数据**:
|
||
```json
|
||
{
|
||
"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`
|
||
**请求参数**:
|
||
```json
|
||
{
|
||
"friendId": "string"
|
||
}
|
||
```
|
||
**返回数据**:
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": {
|
||
"success": true
|
||
}
|
||
}
|
||
```
|
||
|
||
## 6. 删除好友
|
||
**文件**: `MyFriendsActivity.java`
|
||
**接口路径**: `DELETE /api/friends/{friendId}`
|
||
**请求参数**: friendId (路径参数)
|
||
**返回数据**:
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": {
|
||
"success": true
|
||
}
|
||
}
|
||
```
|
||
|
||
## 7. 获取附近的人
|
||
**文件**: `MainActivity.java`
|
||
**接口路径**: `GET /api/users/nearby`
|
||
**请求参数**:
|
||
- latitude: 纬度
|
||
- longitude: 经度
|
||
- radius (可选): 半径（公里），默认10
|
||
**返回数据**:
|
||
```json
|
||
{
|
||
"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 (可选): 每页数量
|
||
**返回数据**:
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": [
|
||
{
|
||
"userId": "string",
|
||
"username": "string",
|
||
"avatarUrl": "string",
|
||
"subtitle": "string",
|
||
"isOnline": "boolean",
|
||
"lastOnlineTime": "number"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
**说明**:
|
||
- 搜索范围包括：好友昵称、备注、共同关注等
|
||
- 支持模糊搜索
|