注册客服商户

POST /agent/login/join

注册一个新商户，并同时创建该商户的首个管理员客服账号。系统关闭注册功能或未安装数据库时，接口返回业务错误。

请求参数

字段	位置	类型	必填	用途
username	body	string	是	登录用户名；仅允许字母、数字、下划线和连字符，最长 60 位。
nickname	body	string	是	管理员客服展示昵称。
password	body	string	是	登录密码。服务端使用密码哈希保存。
captcha	body	string	是	注册图形验证码。
avatar	body	string	否	头像地址；未传时使用系统默认头像。
state	body	string	否	传 online 时新账号初始在线；其他值为离线。
mobile	body	string	条件必填	短信验证码开启时必填。
sms_captcha	body	string	条件必填	短信验证码开启时必填，且须与当前会话和手机号匹配。

成功响应

{
  "code": 0,
  "msg": "ok",
  "data": {
    "bid": "<新商户 ID>",
    "agent_id": 1
  }
}

字段	类型	用途
data.bid	string	新建商户 ID。
data.agent_id	number	首个管理员客服 ID。

注册接口限流：每分钟 10 次、每小时 20 次、每天 30 次。

前端调用建议

1. 先加载注册图形验证码，并在提交前读取用户输入。
2. 提交期间禁用重复点击；密码确认由前端先校验，服务端仍会进行最终校验。
3. 收到 code: 0 后跳转到登录页并使用新账号登录。注册成功响应不等同于浏览器已建立客服工作台 Session。
4. 短信验证开启时，手机号、短信验证码和图形验证码必须来自同一浏览器 Session；刷新验证码后应要求用户重新输入。

不要在浏览器保存密码

密码只用于本次注册/登录提交。不要写入 localStorage、URL 参数、埋点事件或前端错误日志。