跳转到内容

发送邮件

先验证 Runtime、完成发件域名认证、创建仅发送密钥,并向已验证地址测试。向任意正式收件人发送需要 Cloudflare Workers Paid。请明确选择 essentialtransactionalsubscription;订阅类必须指定主题。

Terminal window
curl "$ALL2CF_SEND_URL/emails" -H "Authorization: Bearer $ALL2CF_SEND_KEY" -H "Content-Type: application/json" -H "Idempotency-Key: order-1048" -d '{"from":"hello@example.com","to":"buyer@example.net","subject":"收据","html":"<h1>已付款</h1>"}'

幂等密钥应使用订单号等稳定业务 ID;同一次请求重试必须复用,同一密钥配不同内容会拒绝。POST /emails/batch 支持严格或宽松校验,scheduled_at 可定时并在派发前更新或取消。附件支持 Base64 或公网 HTTPS;远程下载上限 25 MiB,最终邮件受 5 MiB 限制。429 和可重试 5xx 使用退避并保留相同密钥。