用户 API
用户 API 负责处理所有与特定用户相关的数据,包括个人资料、会员升级和使用情况统计。所有端点都需要有效的身份验证。
API 端点详情
升级会员计划
POST /user/upgrade
为当前登录用户升级会员计划。通常在支付成功后调用。
请求体:
{
"plan_id": "monthly", // 'monthly' or 'yearly'
"lang": "zh"
}响应 (200 OK):
{
"success": true,
"message": "会员升级成功"
}获取用户使用统计
GET /user/usage-stats
获取当前用户的详细使用统计,包括历史总量、今日使用量以及最近30天的每日数据。
响应 (200 OK):
{
"total_stats": {
"total_messages": 150,
"total_tokens": 75000,
"total_chats": 10
},
"today_stats": {
"today_messages": 20,
"today_tokens": 12000
},
"daily_usage": [
{ "date": "2024-07-20", "messages": 15, "tokens": 8000 },
{ "date": "2024-07-21", "messages": 20, "tokens": 12000 }
]
}获取用户总统计(简化版)
GET /user/total-stats
获取用户的核心总统计数据,用于在界面中快速展示。
响应 (200 OK):
{
"total_messages": 150,
"total_tokens": 75000,
"total_chats": 10
}