curl -X POST https://mail.helipod.io/api/email/send \
  -H "Authorization: Bearer hel_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "你的店铺 <noreply@tokoanda.co.id>",
    "to": ["budi@example.com"],
    "subject": "你的验证码",
    "html": "<p>你的验证码: <b>{{kode}}</b></p>",
    "variables": { "kode": "482913" },
    "idempotencyKey": "verify-8812"
  }'

200 { "success": true, "data": { "id": "…" } }

事务邮件

什么是事务邮件?

事务邮件是应用因用户操作而自动发送的邮件:登录时的 OTP 验证码、注册时的验证链接、重置密码、购买收据或订单状态通知。用户在等这封邮件,所以必须快速送达且不能进入垃圾邮件。

通过 PHP 的 mail() 或普通主机的 SMTP 从自己的服务器发送,往往会进入垃圾邮件箱,因为 IP 没有信誉,DNS 记录也不完整。Helipod 通过 Amazon SES 雅加达区域发送,为你的域名配置 SPF、DKIM 和 DMARC,并在发送前检查收件地址。

曾经退信或举报垃圾邮件的收件人会被自动屏蔽,无法接收邮件的域名地址会在一开始就被拒绝,从而保护你的域名信誉。

3 步开始

01
验证域名
添加发件域名,并复制控制台中显示的 DNS 记录。
02
创建 API key
在 API 与 Webhook 菜单中创建 key。key 只显示一次,请保存到应用的环境变量中。
03
发送第一个请求
向 mail.helipod.io/api/email/send 发送 POST,并带上 Authorization: Bearer <api_key> 请求头。

功能

为开发者打造

生产应用所需的功能,配有清晰的文档和错误信息。

简单的 REST API

一个 JSON 端点,可从 PHP、Laravel、Node.js、Python、Go 或任何语言调用。

每批 50 封邮件

一次请求最多发送 50 封不同的邮件,每封有各自的变量。

状态 Webhook

将 sent、delivered、bounced、complained、opened、clicked 等事件带签名地发送到你的服务器。

模板与变量

在控制台保存模板,只需传入 templateId 和数据即可发送,例如 {{nama}} 或 {{kode}}。

幂等键

因超时而重复的请求不会重复发送邮件。

敏感数据模式

标记包含 OTP 或密码的邮件,发送后其内容会从队列中删除。

自动屏蔽名单

退信或举报垃圾邮件的地址不再发送,以保护域名信誉。

雅加达区域

通过 Amazon SES ap-southeast-3 发送,靠近印尼用户。

按项目划分的 API key

创建多个 key 并命名,随时撤销而不影响其他 key。

价格

邮件 API 价格

每天免费 50 封,可用于试用。付费套餐每月 Rp 24.990 起,额度用完后可按封付费继续发送。

Free

免费

50 封邮件/天
100 位联系人
群发 / 广播邮件
无邮箱
1 个域名 · 3 个模板

Starter

Rp 24.990/月

2,500 封邮件/月
1,500 位联系人
群发 / 广播邮件
收件箱:1 个邮箱 + 3 个别名,3 GB
2 个域名 · 20 个模板

Pro

Rp 74.900/月

8,500 封邮件/月
4,500 位联系人
群发 / 广播邮件
收件箱:1 个邮箱 + 3 个别名,7 GB
5 个域名 · 100 个模板

Business

Rp 124.900/月

15,500 封邮件/月
8,500 位联系人
群发 / 广播邮件
收件箱:1 个邮箱 + 3 个别名,15 GB
20 个域名 · 500 个模板

按年付费时的月价。也可按月付费,无合约。续费价格与起始价格相同。支持 QRIS 或银行转账付款,无需信用卡。

FAQ

关于邮件 API 的问题

有免费的邮件 API 吗?

有。Free 套餐通过 API 或 SMTP 每天提供 50 封邮件,无需信用卡,并包含已验证域名、模板和 Webhook。适合试用和小型应用。付费套餐提供更大的每月额度。

什么是事务邮件?

事务邮件是应用因用户操作而自动发送的邮件:账号验证、OTP 验证码、重置密码、购买收据或订单通知。这类邮件必须快速送达且不能进入垃圾邮件,与营销邮件不同。

如何通过 Helipod API 发送邮件?

在控制台创建 API key,验证发件域名,然后向 https://mail.helipod.io/api/email/send 发送 POST 请求,带上 Authorization: Bearer <api_key> 请求头,以及包含 from、to、subject 和 html 或 text 的 JSON 请求体。响应包含发送 id,可在控制台或通过 Webhook 跟踪。

可以一次发送多封邮件吗?

可以。/send/batch 端点在一次请求中最多接受 50 封不同的邮件,每封有各自的收件人和变量。如需向数千联系人发送新闻邮件,请使用控制台中的 broadcast(群发)功能。

如何知道邮件已送达或被退回?

注册 Webhook URL 并选择要接收的事件:sent、delivered、bounced、complained、opened、clicked、rejected、failed 和 received。每个 Webhook 请求都带有签名,方便你确认来源是 Helipod。

可以发送附件吗?

暂不支持。目前 API 会拒绝附件并返回清晰的错误信息。对于发票等文档,请在邮件正文中提供下载链接。

提供 SMTP 吗?

提供。只支持 SMTP 的应用(WordPress、Laravel、PHPMailer、Nodemailer)可通过 smtp.helipod.io 的 587 或 465 端口发送,以 API key 作为密码。通过 SMTP 发送与 API 使用相同的检查和额度,并记录在同一份日志中。

请求因超时而重发会怎样?

在请求体中带上 idempotencyKey。如果使用相同的 key 重发同一请求,Helipod 会返回原来的发送记录,不会重复发送邮件。

Helipod Email

Helipod 其他邮件服务

Helipod Email

Helipod 的全部邮件服务及价格。

邮箱托管

使用自己域名的邮箱:邮箱账户、别名和现代化网页邮箱。

群发邮件

向你的联系人列表群发邮件,支持分组、模板和报告。

SMTP Relay

印尼本地 SMTP 服务器,适用于 WordPress、Laravel 和任何应用。

发送你的第一封事务邮件

免费注册,验证域名,几分钟内即可通过 API 发送。