## 验证码 (`verify-codes`)

无需认证。发送邮件或短信验证码,用于注册绑定、找回密码和登录二次验证;短信须带图形验证码。

鉴权: 无需鉴权 · 文档: https://www-demo.kuxitong.com/zh/docs/api/verify-codes

### POST `/api/v2/verify-codes`

发邮件/短信验证码 · 鉴权: 无需鉴权

请求体:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `account` | string |  | 登录名(login 必填)。 |
| `captcha_code` | string |  | 图形验证码上显示的字符(发短信必填)。 |
| `captcha_id` | string |  | 图形验证码 id(发短信必填)。 |
| `channel` | string | 有 | 发送通道:email 邮件,sms 短信。 可选值: ["email","sms"] |
| `purpose` | string | 有 | 用途:bind 注册或改绑,reset_password 找回密码,login 登录二次验证。 可选值: ["bind","reset_password","login"] |
| `target` | string |  | 邮箱或手机号(bind、reset_password 必填)。 |

```sh
curl -X POST "https://panel.example.com/api/v2/verify-codes" \
  -H "Content-Type: application/json" \
  -d '{"channel":"email","purpose":"bind","target":"alice@example.com"}'
```

验证码对象:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `account` | string |  | 登录名(login 必填)。 |
| `captcha_code` | string |  | 图形验证码上显示的字符(发短信必填)。 |
| `captcha_id` | string |  | 图形验证码 id(发短信必填)。 |
| `channel` | string | 有 | 发送通道:email 邮件,sms 短信。 可选值: ["email","sms"] |
| `expires_in` | integer |  | 有效期,秒。 |
| `purpose` | string | 有 | 用途:bind 注册或改绑,reset_password 找回密码,login 登录二次验证。 可选值: ["bind","reset_password","login"] |
| `resend_in` | integer |  | 多少秒后可以重发。 |
| `target` | string |  | 邮箱或手机号(bind、reset_password 必填)。 |
| `to` | string |  | 打码后的收件地址。 |