模块说明
email 提供邮件订阅能力：访客/会员提交邮箱加入订阅列表（服务端做格式与重复校验）。
鉴权级别：可选（未登录也可订阅，登录时记录会员 ID）。
接口一览
| 方法 |
URL |
鉴权 |
说明 |
| GET |
/api/email |
可选 |
订阅表单数据 |
| POST |
/api/email |
可选 |
提交订阅 |
订阅表单 GET /api/email
{
"code": "OK",
"message": "",
"data": { "title": "邮件订阅" },
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
提交订阅 POST /api/email
{
"code": "OK",
"message": "订阅成功",
"data": {},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
| 场景 |
响应 |
| 邮箱格式非法 |
422 INVALID_PARAMS（email_cue） |
| 业务拒绝（重复订阅等） |
422 BUSINESS_RULE_VIOLATION |
注意事项
- 提交记录会员 ID（登录态）与 IP，便于后台归因；
- 本模块限流 5 次/300 秒（超限
429）。