统一响应格式
{
"code": 0,
"msg": "success",
"data": {}
}
一、用户模块 /api/user
POST/api/user/login
说明: 微信登录
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | string | 是 | 微信登录code |
| encryptedData | string | 否 | 加密用户信息 |
| iv | string | 否 | 加密向量 |
响应示例:
{
"code": 0,
"msg": "success",
"data": {
"user": {
"id": 1,
"openid": "xxx",
"nickname": "昵称",
"avatar_url": "/static/avatars/xxx.png",
"points": 100
},
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
}
POST/api/user/verify_token
请求头: Authorization: Bearer <token>
GET/api/user/info需认证
说明: 获取用户信息
POST/api/user/update需认证
说明: 更新用户信息
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| nickname | string | 否 | 昵称 |
| gender | int | 否 | 性别(0/1/2) |
| birthday | string | 否 | 生日(YYYY-MM-DD) |
| real_name | string | 否 | 真实姓名 |
POST/api/user/bind_phone需认证
说明: 绑定手机号
POST/api/user/upload_avatar需认证
说明: 上传头像
二、积分模块 /api/points
POST/api/points/add需认证
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| amount | int | 是 | 积分数量 |
| source | string | 否 | 来源 |
| remark | string | 否 | 备注 |
POST/api/points/deduct需认证
说明: 扣除积分
GET/api/points/balance需认证
说明: 查询余额
GET/api/points/records需认证
说明: 积分记录
三、支付模块 /api/pay
POST/api/pay/create_order需认证
说明: 创建订单
POST/api/pay/prepay需认证
说明: 预支付
POST/api/pay/notify无需认证
说明: 支付回调
GET/api/pay/query需认证
说明: 查询订单
四、文件模块 /api/file
POST/api/file/upload需认证
说明: 上传文件
POST/api/file/upload_save需认证
说明: 保存上传
POST/api/file/upload_from_url需认证
说明: URL上传
GET/api/file/list需认证
说明: 文件列表
五、账号模块 /api/account
GET/api/account/list需认证
说明: 账号列表
GET/api/account/valid需认证
说明: 有效账号
POST/api/account/add需认证
说明: 添加账号
POST/api/account/update需认证
说明: 更新账号
六、AI数字人模块 /api/aihuman
POST/api/aihuman/train需认证
说明: 训练形象
POST/api/aihuman/voice/train需认证
说明: 训练声音
GET/api/aihuman/video/result?taskId=xxx需认证
说明: 获取视频结果
POST/api/aihuman/video/generate需认证
说明: 生成视频
错误码说明
| 错误码 | 说明 |
|---|---|
| 0 | 成功 |
| -1 | 通用错误 |
| 401 | 未授权/Token无效 |