105 lines
1.8 KiB
Markdown
105 lines
1.8 KiB
Markdown
|
# 后端接口 TODO 清单 - 礼物打赏模块
|
|||
|
|
|
|||
|
|
## 1. 获取礼物列表
|
|||
|
|
**文件**: `RoomDetailActivity.java`
|
|||
|
|
**接口路径**: `GET /api/gifts`
|
|||
|
|
**返回数据**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"data": [
|
|||
|
|
{
|
|||
|
|
"id": "string",
|
|||
|
|
"name": "string",
|
|||
|
|
"price": "number",
|
|||
|
|
"iconUrl": "string",
|
|||
|
|
"description": "string",
|
|||
|
|
"level": "number"
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 2. 获取用户金币余额
|
|||
|
|
**文件**: `RoomDetailActivity.java`
|
|||
|
|
**接口路径**: `GET /api/user/balance`
|
|||
|
|
**请求参数**: userId（从token中获取）
|
|||
|
|
**返回数据**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"data": {
|
|||
|
|
"coinBalance": "number"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 3. 赠送礼物
|
|||
|
|
**文件**: `RoomDetailActivity.java`
|
|||
|
|
**接口路径**: `POST /api/gifts/send`
|
|||
|
|
**请求参数**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"roomId": "string",
|
|||
|
|
"streamerId": "string",
|
|||
|
|
"giftId": "string",
|
|||
|
|
"count": "number"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
**返回数据**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"data": {
|
|||
|
|
"success": true,
|
|||
|
|
"newBalance": "number",
|
|||
|
|
"message": "string"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 4. 获取充值选项列表
|
|||
|
|
**文件**: `RoomDetailActivity.java`
|
|||
|
|
**接口路径**: `GET /api/recharge/options`
|
|||
|
|
**返回数据**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"data": [
|
|||
|
|
{
|
|||
|
|
"id": "string",
|
|||
|
|
"coinAmount": "number",
|
|||
|
|
"price": "number",
|
|||
|
|
"discountLabel": "string"
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 5. 发起充值请求
|
|||
|
|
**文件**: `RoomDetailActivity.java`
|
|||
|
|
**接口路径**: `POST /api/recharge/create`
|
|||
|
|
**请求参数**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"optionId": "string",
|
|||
|
|
"coinAmount": "number",
|
|||
|
|
"price": "number"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
**返回数据**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"data": {
|
|||
|
|
"orderId": "string",
|
|||
|
|
"paymentUrl": "string"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
**后续步骤**:
|
|||
|
|
1. 集成支付SDK（微信支付、支付宝等）
|
|||
|
|
2. 调用支付SDK发起支付
|
|||
|
|
3. 监听支付结果回调
|
|||
|
|
4. 支付成功后更新用户金币余额
|