74 lines
1.6 KiB
Markdown
74 lines
1.6 KiB
Markdown
|
# 后端接口 TODO 清单 - 用户资料模块
|
|||
|
|
|
|||
|
|
## 1. 获取用户资料
|
|||
|
|
**文件**: `ProfileActivity.java`
|
|||
|
|
**接口路径**: `GET /api/users/{userId}/profile`
|
|||
|
|
**请求参数**: userId (路径参数，从token中获取)
|
|||
|
|
**返回数据**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"data": {
|
|||
|
|
"id": "string",
|
|||
|
|
"name": "string",
|
|||
|
|
"avatarUrl": "string",
|
|||
|
|
"bio": "string",
|
|||
|
|
"level": "number",
|
|||
|
|
"badge": "string",
|
|||
|
|
"birthday": "string",
|
|||
|
|
"gender": "string",
|
|||
|
|
"location": "string",
|
|||
|
|
"followingCount": "number",
|
|||
|
|
"fansCount": "number",
|
|||
|
|
"likesCount": "number"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 2. 更新用户资料
|
|||
|
|
**文件**: `ProfileActivity.java`, `EditProfileActivity.java`
|
|||
|
|
**接口路径**: `PUT /api/users/{userId}/profile`
|
|||
|
|
**请求参数**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"name": "string", // 昵称（可选）
|
|||
|
|
"bio": "string", // 个人签名（可选）
|
|||
|
|
"avatarUrl": "string", // 头像URL（可选）
|
|||
|
|
"birthday": "string", // 生日（可选）
|
|||
|
|
"gender": "string", // 性别（可选）
|
|||
|
|
"location": "string" // 所在地（可选）
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
**返回数据**: 同获取用户资料接口
|
|||
|
|
|
|||
|
|
## 3. 上传头像
|
|||
|
|
**文件**: `EditProfileActivity.java`
|
|||
|
|
**接口路径**: `POST /api/upload/avatar`
|
|||
|
|
**请求参数**: multipart/form-data
|
|||
|
|
- file: 图片文件
|
|||
|
|
**返回数据**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"data": {
|
|||
|
|
"url": "string" // 上传后的图片URL
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 4. 获取用户统计数据
|
|||
|
|
**文件**: `ProfileActivity.java`
|
|||
|
|
**接口路径**: `GET /api/users/{userId}/stats`
|
|||
|
|
**请求参数**: userId (路径参数)
|
|||
|
|
**返回数据**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"data": {
|
|||
|
|
"followingCount": "number",
|
|||
|
|
"fansCount": "number",
|
|||
|
|
"likesCount": "number"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|