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