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"
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
**说明**:
|
|||
|
|
- 搜索范围包括：好友昵称、备注、共同关注等
|
|||
|
|
- 支持模糊搜索
|