注册与认证

本文档介绍注册新账号和绑定用户名密码的公开接口。

注册账号

接口

POST /token/reg

请求体

{
  "username": "new-user",
  "password": "a-strong-password",
  "cf_token": "<TURNSTILE_TOKEN>"
}

字段	类型	必填	说明
username	string	是	新用户名
password	string	是	新密码
cf_token	string	是	页面人机验证结果，不能复用旧值

响应示例

{
  "success": true,
  "msg": "success",
  "token": "<TOKEN>"
}

注册成功后会直接返回 Token。客户端应立即使用 Token 完成一次验证，不要把它写入构建产物。

绑定或修改用户名密码

二维码登录成功后，可以为当前 Token 绑定用户名密码。

接口

POST /token/bind

请求体

{
  "token": "<TOKEN>",
  "username": "my-user",
  "old_password": "<OLD_PASSWORD>",
  "new_password": "a-new-strong-password"
}

字段	类型	必填	说明
token	string	是	当前有效 Token
username	string	是	要绑定的用户名
old_password	string	否	首次设置可省略，修改已有密码时填写
new_password	string	是	新密码

响应使用通用格式：

{
  "success": true,
  "msg": "success"
}

安全建议

• 注册和绑定都应在 HTTPS 页面中完成；
• 人机验证令牌只用于当前请求；
• 密码不要与 Token、访问码或机台密钥相同；
• 修改密码后重新验证 Token，并更新本地账号备注。