个人资料模块
个人资料模块提供用户管理自己账户信息的功能，包括获取个人资料和编辑个人信息等接口。
接口说明
获取个人资料
路径: /api/profile
方法: GET
认证: 需要 JWT 认证
请求字段
| 字段名 | 必需 | 类型 | 说明 |
|---|---|---|---|
| - | - | - | 无需请求参数 |
响应字段
| 字段名 | 必需 | 类型 | 说明 |
|---|---|---|---|
| user | 是 | User | 用户信息对象 |
编辑个人资料
路径: /api/profile
方法: POST
认证: 需要 JWT 认证
请求字段
| 字段名 | 必需 | 类型 | 说明 |
|---|---|---|---|
| name | 否 | string | 新的用户昵称 |
| head_id | 否 | string | 新的头像 ID |
响应字段
| 字段名 | 必需 | 类型 | 说明 |
|---|---|---|---|
| success | 是 | boolean | 更新成功状态 |
| message | 是 | string | 操作结果消息 |
| user | 是 | User | 更新后的用户信息对象 |
获取推荐信息
路径: /api/profile/referral
方法: GET
认证: 需要 JWT 认证
请求字段
| 字段名 | 必需 | 类型 | 说明 |
|---|---|---|---|
| - | - | - | 无需请求参数 |
响应字段
| 字段名 | 必需 | 类型 | 说明 |
|---|---|---|---|
| referral_link | 是 | string | 推荐链接 |
| total_referrals | 是 | number | 推荐总人数 |
| successful_referrals | 是 | number | 已成功推荐的人数（已参与游戏） |
| token_rewards | 是 | string | 推荐获得的奖金奖励（ETH，以wei为单位） |
| point_rewards | 是 | number | 推荐获得的积分奖励 |
使用说明
- 所有接口都需要通过 JWT token 进行身份认证
- 编辑资料时，name 和 head_id 字段都是可选的，可以只更新其中一个
- head_url 由系统根据 head_id 自动生成，无需客户端传递
- point 积分由系统管理，用户无法直接修改
- 用户只能查看和修改自己的个人资料
- 推荐信息接口返回当前用户的推荐统计和收益数据
- 推荐链接可用于分享给其他用户进行推荐
- 成功推荐人数指已通过推荐链接注册并参与游戏的用户数量