邮箱服务

邮件发送与虚拟邮箱收发能力。当前接入 3 条线路,后续可继续扩展更多平台/线路。

/api/email/

服务说明

邮箱服务把「发信」和「收信」拆成三条线路:邮箱 v1 用平台邮箱发送业务邮件,适合验证码、通知、告警等场景;VMEmail 与 VMEmail(mail.cx) 提供临时邮箱(虚拟邮箱)能力,可随机生成一个邮箱地址并接收来信,常用于注册验证、接口联调、自动化测试等需要一次性邮箱的场合。

三条线路的认证口径不同:VMEmail 线路为开放接口,可不带签名直接调试;邮箱 v1 与 mail.cx 线路需要项目签名。

临时邮箱的收件是长轮询:没有新邮件时请求会挂起约 25 秒后返回空列表,属正常行为,请不要按短超时判定为失败;邮件有留存期限,重要内容请及时取回。

邮箱 v1

发送邮件(默认线路) 需签名

发送文本/HTML 邮件,支持多个收件人。需项目签名调用。

POST /api/email/v1/send 累计调用 2 次

发送邮件

发送一封邮件,可指定多个收件人。

邮件标题(必填)

邮件正文内容(必填)

收件人邮箱(必填,支持多个)

多值写法:多个邮箱用逗号或换行分隔,也可通过同一字段多次传递

  • 收件人支持两种写法:同一字段重复传多次,或单个字段内用逗号分隔。
  • 成功返回 data 含 subject / recipients / count;发送失败归为外部服务错误。
小影API · 通用 API 聚合服务