跳到主要内容

事务邮件

每一封收据、重置邮件和提醒,都稳稳送达

为你的应用提供 REST API、SDK 和 SMTP 中继,从你自己已认证的域名发信,每封邮件的去向都有完整日志可查。

REST API 与 SDK

一个请求即可发送。出错时,原因一清二楚。

带上 Bearer 密钥,向 /api/v1/emails POST 一段 JSON。你会立即拿到一个 ID,所有错误都采用相同的结构——类型、消息、错误码以及出错的参数。
  • 官方 SDK:Node.js(@hulakimail/node)和 PHP(hulakimail/hulakimail-php)
  • Idempotency-Key 请求头确保重试绝不重复发送
  • 批量端点,每个请求最多 100 封邮件
  • 按套餐设定速率限制,并返回标准的 Retry-After 响应头
curl https://hulakimail.com/api/v1/emails \
  -H "Authorization: Bearer $HULAKIMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <[email protected]>",
    "to": ["[email protected]"],
    "subject": "Welcome to Acme",
    "html": "<p>Thanks for signing up, Ada!</p>"
  }'

SMTP 中继

不想写代码?把任何应用指向我们的 SMTP 中继即可。

WordPress、Magento、Ghost、你的客服系统,甚至网络打印机——只要能通过 SMTP 发信,就能通过 Hulaki 发信,并享有与 API 相同的日志、抑制和追踪功能。
  • 587 和 2525 端口使用 STARTTLS,465 端口使用隐式 TLS
  • 每个应用使用独立凭据——吊销其中一个不影响其他
  • 可将每个凭据限制在指定的发信域名
SMTP 设置
Host       smtp.hulakimail.com
Port       587 (STARTTLS) · 465 (TLS) · 2525 (alternate)
Username   your SMTP credential username
Password   shown once when you create the credential
From       any address on a verified domain

投递日志

每封邮件的去向,尽在掌握

按收件人、主题、标签或状态搜索。打开任意一封邮件,即可查看它的时间线——已接收、已发送、已送达、已打开、已点击、已退信——以及远端服务器的原始响应。
  • 按状态、域名、标签、API 密钥或 SMTP 凭据筛选
  • 渲染预览与原始邮件头
  • 根据套餐保留 3 至 365 天

Webhook

实时响应送达、退信和点击事件

为你关心的事件订阅一个 HTTPS 端点。每个请求都带有 HulakiMail-Signature 签名头,并按退避策略重试,直到你的服务器返回 200。
  • 事件:email.sent, delivered, delayed, bounced, complained, opened, clicked
  • 带时间戳的 HMAC-SHA256 签名,防止重放攻击
  • 在控制台查看每次推送尝试及响应
email.bounced
{
  "id": "evt_01JD3QB2M8T6W1Z4R9K7P3N5XC",
  "type": "email.bounced",
  "created_at": "2026-11-14T09:30:14Z",
  "data": {
    "email_id": "msg_01JD3Q8Z4X7M2V9K6T1R5B8N0C",
    "recipient": "[email protected]",
    "bounce": { "type": "permanent", "diagnostic": "550 5.1.1 user unknown" },
    "tags": ["digest"]
  }
}

模板

让文案不再写死在代码里

将模板存储在 Hulaki 中,通过 ID 和变量发送。市场团队改个错别字无需重新部署;开发者则拥有稳定的调用约定。
  • {{variables}}、{{#if}}、{{#each}} 以及 {{{raw}}} HTML
  • 使用示例数据实时预览
  • 纯文本版本可自动生成,也可手动编写
order-confirmation.html
<h1>Thanks for your order, {{customer.first_name}}!</h1>

{{#each items}}
  <p>{{quantity}} × {{name}} — {{price}}</p>
{{/each}}

{{#if tracking_url}}
  <a href="{{tracking_url}}">Track your parcel</a>
{{/if}}

你的域名

从第一天起就完成认证

添加你的域名,把 DNS 记录复制到服务商处,我们会自动完成验证。你的邮件会经过 DKIM 签名并与 DMARC 对齐,退信则返回到你自己的子域名。
  • SPF、DKIM、DMARC 与自定义 Return-Path
  • 品牌化的点击追踪子域名
  • 提供 Cloudflare、GoDaddy、Namecheap 等服务商的配置指南

更多功能

生产级邮件管道所需的一切

幂等请求

同一个 Idempotency-Key 发送两次,你拿到的是原始响应,而不是一封重复的邮件。

批量发送

一次 API 调用即可排队发送最多 100 封个性化邮件。

定时发送

设置 scheduled_at 即可稍后发送——发出前还能取消。

附件

通过 content_id 发送 PDF 发票、日历邀请和内嵌图片。

标签与元数据

为邮件打标签方便筛选,每个 Webhook 都会带回你的元数据。

打开与点击追踪

可按邮件单独开启,使用你自己的品牌追踪域名。

抑制列表

已退信、已投诉和已退订的地址会被自动跳过。

限定权限的 API 密钥

生产环境用仅发送密钥,仪表盘用只读密钥,管理脚本用完全访问密钥。

可预期的错误

每个错误都包含类型、易读的说明、机器可读的错误码以及出错的参数。

五分钟内发出你的第一封邮件

创建免费工作区,验证域名,几分钟内就能发出第一封邮件。无需信用卡。