## 发信通道 (`message-channels`)

邮件(SMTP)与短信发信通道的配置及测试。

鉴权: 仅管理员 · 文档: https://www-demo.kuxitong.com/zh/docs/api/message-channels

### GET `/api/v2/message-channels`

发信通道 · 鉴权: 仅管理员

```sh
curl "https://panel.example.com/api/v2/message-channels" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### PUT `/api/v2/message-channels`

修改发信通道 · 鉴权: 仅管理员

请求体:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `sms` | SmsChannel | 有 | 短信通道配置。 |
| `smtp` | SmtpChannel | 有 | SMTP 邮件通道配置。 |

```sh
curl -X PUT "https://panel.example.com/api/v2/message-channels" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### POST `/api/v2/message-channels/test`

测试发信通道 · 鉴权: 仅管理员

请求体:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `channel` | string | 有 | 要测试的通道(email 邮件、sms 短信)。 可选值: ["email","sms"] |
| `draft` | ChannelTestDraft |  | 未保存的通道设置草稿;字段形状同保存接口,没给的字段、留空的密钥沿用已存值。 |
| `template_id` | string |  | 腾讯云短信须给已审核的模板 id(短信宝不需要)。 |
| `to` | string | 有 | 收件邮箱或手机号。 |

```sh
curl -X POST "https://panel.example.com/api/v2/message-channels/test" \
  -H "X-API-Key: $GOCDN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channel":"email","to":"admin@example.com"}'
```

发信通道对象:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `channel` | string | 有 | 要测试的通道(email 邮件、sms 短信)。 可选值: ["email","sms"] |
| `draft` | ChannelTestDraft |  | 未保存的通道设置草稿;字段形状同保存接口,没给的字段、留空的密钥沿用已存值。 |
| `error` | string |  | 失败时的错误信息。 |
| `ok` | boolean |  | 测试发送是否成功。 |
| `sms` | SmsChannel |  | 短信通道配置。 |
| `smtp` | SmtpChannel |  | SMTP 邮件通道配置。 |
| `template_id` | string |  | 腾讯云短信须给已审核的模板 id(短信宝不需要)。 |
| `to` | string | 有 | 收件邮箱或手机号。 |