注册 (action=register)
创建新用户账号。根据软件配置,可能需要卡密才能注册,也可能有注册赠送。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
| action | string | 是 | 固定值 register |
| username | string | 是 | 用户名,不能与已有用户重复 |
| password | string | 是 | 密码 |
| card_no | string | 视设置 | 注册卡密(register_need_card=1时必填) |
| inviter | string | 可选 | 推广人用户名(用于推广奖励) |
| super_pwd | string | 可选 | 超级密码(用于找回密码) |
| timestamp | int | 是 | 时间戳 |
成功响应 (code=10)
| 字段名 | 类型 | 说明 |
| timestamp | int | 服务器时间戳 |
| username | string | 用户名 |
| expire_time | string | 到期时间 |
| points | int | 初始点数 |
| card_hours | int | 卡密充值小时数(天数已折算,使用卡密注册时) |
| card_points | int | 卡密充值点数 |
| register_gift_hours | int | 注册赠送小时数(天数已折算,无卡密注册时) |
| register_gift_points | int | 注册赠送点数 |
| promo_reward_hours | int | 推广奖励小时数(天数已折算,被邀请人获得) |
| promo_reward_points | int | 推广奖励点数 |
| reward_details | array | 奖励明细列表,如["卡密充值: 30天", "推广奖励: 3天"] |
可能的错误码
| 错误码 | 说明 | 处理建议 |
| 10001 | 注册参数错误 | 检查必填参数 |
| 10002 | 用户名已存在 | 提示更换用户名 |
| 10003 | 该软件需要卡密才能注册 | 提示输入卡密 |
| 10004 | 推广人不存在 | 检查推广人用户名 |
| 10005 | 未配置注册赠送时间 | 联系开发者配置 |
| 10006 | 用户数已达上限 | 联系开发者 |
| 10010 | 卡密不存在 | 检查卡密 |
| 10011 | 卡密已被使用 | 使用新卡密 |
| 10012 | 卡密已被冻结 | 联系管理员 |
| 10013 | 卡密与软件不匹配 | 检查卡密 |
| 10014 | 卡密没有时间 | 使用包含时间的卡密 |
请求示例
// 使用卡密注册
action=register&card_no=XXXX-XXXX&password=123456×tamp=1700000000&username=newuser
// 无卡密注册(需软件允许)
action=register&password=123456×tamp=1700000000&username=newuser
// 带推广人注册
action=register&inviter=olduser&password=123456×tamp=1700000000&username=newuser
响应示例
{
"code": 10,
"msg": "注册成功",
"timestamp": 1700000001,
"username": "newuser",
"expire_time": "2024-12-31 23:59:59",
"points": 100,
"card_hours": 720,
"card_points": 100,
"reward_details": ["卡密充值: 30天 + 100点"]
}