1

zj

8 hours ago f658569891db433854221b80f0a9fa99608cff64

 docs/api/模拟账户-前端对接文档.md

@@ -112,7 +112,8 @@
### 3. 注册（无验证码）

- **地址**：`POST /api/registerNoVerifcode`
- **说明**：注册成功即创建主账户 + 自动创建模拟账户；返回的 token 对应主账户，`data.info` 结构同 2。
- **说明**：注册成功即创建主账户 + 自动创建模拟账户；返回的 token 对应主账户，`data.info` 结构同 2。  
  额外限制：**禁止大陆邮箱注册**，命中时返回业务错误（如：`msg = "大陆邮箱不支持注册"`）。
- **请求体**：JSON

| 参数     | 类型   | 必填 | 说明 |
@@ -129,7 +130,8 @@
### 4. 注册（有验证码）

- **地址**：`POST /api/registerVerifcode`
- **说明**：同上，注册即主账户+模拟账户；返回结构同 2、3。
- **说明**：同上，注册即主账户+模拟账户；返回结构同 2、3。  
  额外限制：**禁止大陆邮箱注册**，命中时返回业务错误（如：`msg = "大陆邮箱不支持注册"`）。
- **请求体**：在 3 的基础上增加 `verifcode`（验证码）等字段，按现有注册接口约定即可。

---
@@ -213,7 +215,10 @@

4. **错误处理**  
   - `msg === "模拟账户不能直接登录，请使用主账户登录后切换"`：提示用户使用主账户登录后再切换。  
   - `msg === "模拟账户不支持充值"` / `"模拟账户不支持提现"`：在模拟账户下隐藏或禁用对应功能即可，一般不应让用户点到。
   - `msg === "模拟账户不支持充值"` / `"模拟账户不支持提现"`：在模拟账户下隐藏或禁用对应功能即可，一般不应让用户点到。  
   - `msg === "大陆IP禁止访问"`：提示当前地区不可用，并阻断后续页面访问。  
   - `msg === "大陆邮箱不支持注册"`：在注册页保持提交按钮可重试，提示用户更换邮箱。  
   - `msg === "请先完成两步认证并设置资金密码后再交易"`：交易页入口/下单按钮置灰，并引导跳转安全设置页。

---

@@ -235,3 +240,6 @@
- 所有上述接口的**基础路径**以实际部署为准（如 `https://your-domain.com`），若有统一网关前缀需自行加上。
- Token 过期或未传时，接口会返回 401 等，前端需按现有逻辑跳转登录（主账户登录页）。
- 模拟账户与主账户**共用同一套业务接口**（交易、资产等），仅充提与登录限制不同；前端通过 `accountType` 控制展示与禁用即可。
- 访问控制：**禁止大陆 IP 访问**，命中后端风控时应返回业务错误（建议文案：`大陆IP禁止访问`），前端需阻断继续使用。
- 注册限制：**禁止大陆邮箱注册**，在注册接口统一拦截并返回业务错误（建议文案：`大陆邮箱不支持注册`）。
- 交易前置条件：用户必须先完成**两步认证（2FA）**并**设置资金密码**，否则不得进行交易下单（建议文案：`请先完成两步认证并设置资金密码后再交易`）。