发送邮件
站点级通用发信(业务通知)。
POST
/api/v1/notify/emailX-Api-Key · email_notify发送邮件
json
{ "to": "a@b.com", "subject": "主题", "html": "<p>正文</p>" }| 字段 | 约束 |
|---|---|
to | 单个合法邮箱地址,3–254,纯 ASCII;不接受显示名(张三 <a@b.com>)、逗号/分号分隔的多地址、mailto: 前缀、含空格或换行的值、本地部分首尾是点的地址(2970844281.@qq.com) |
subject | 1–200 |
html | 非空 |
成功 {"ok": true};收件人地址不合法 → 400 email_invalid(调用方入参问题,改正地址再发,重试无用);收件人被服务商拒收 → 400 email_rejected(地址合法但在发信服务商黑名单里,多半是此前投递硬退信,该邮箱收不了信;换地址,重试永远不会成功);未绑定 SMTP → 503 site_email_unbound;SMTP 失败 → 502 email_send_failed(平台侧故障,可退避重试)。注册验证码等由 auth 服务自行发信,不走此接口。