hulakimail.com/app/acme/emails
邮件
最近 7 天 · acme.com
已发送
48,210
已送达
99.2%
已打开
41.8%
已退信
0.4%
收件人主题状态来源时间
REST API 与 SDK
一个请求即可发送。出错时,原因一清二楚。
带上 Bearer 密钥,向 /api/v1/emails POST 一段 JSON。你会立即拿到一个 ID,所有错误都采用相同的结构——类型、消息、错误码以及出错的参数。
- 官方 SDK:Node.js(@hulakimail/node)和 PHP(hulakimail/hulakimail-php)
- Idempotency-Key 请求头确保重试绝不重复发送
- 批量端点,每个请求最多 100 封邮件
- 按套餐设定速率限制,并返回标准的 Retry-After 响应头
POST /emails
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>"
}'import { HulakiMail } from '@hulakimail/node';
const hulakimail = new HulakiMail(process.env.HULAKIMAIL_API_KEY);
const { id } = await hulakimail.emails.send({
from: 'Acme <[email protected]>',
to: ['[email protected]'],
subject: 'Welcome to Acme',
html: '<p>Thanks for signing up, Ada!</p>',
});<?php
use HulakiMail\HulakiMail;
$hulakimail = new HulakiMail(getenv('HULAKIMAIL_API_KEY'));
$email = $hulakimail->emails->send([
'from' => 'Acme <[email protected]>',
'to' => ['[email protected]'],
'subject' => 'Welcome to Acme',
'html' => '<p>Thanks for signing up, Ada!</p>',
]);import os
import requests
response = requests.post(
"https://hulakimail.com/api/v1/emails",
headers={"Authorization": f"Bearer {os.environ['HULAKIMAIL_API_KEY']}"},
json={
"from": "Acme <[email protected]>",
"to": ["[email protected]"],
"subject": "Welcome to Acme",
"html": "<p>Thanks for signing up, Ada!</p>",
},
)
print(response.json()["data"]["id"])// .env
// MAIL_MAILER=hulakimail
// HULAKIMAIL_API_KEY=hm_live_...
use App\Mail\WelcomeMail;
use Illuminate\Support\Facades\Mail;
Mail::to('[email protected]')->send(new WelcomeMail($user));# Any framework, CMS or device that speaks SMTP
SMTP_HOST=smtp.hulakimail.com
SMTP_PORT=587 # STARTTLS · or 465 (TLS) · 2525 (fallback)
SMTP_USERNAME=hm_smtp_7f3a9c
SMTP_PASSWORD=your-smtp-password
SMTP_FROM="Acme <[email protected]>"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 天
你的收据 #4821
msg_01JD3Q8Z4X7M2V9K6T1R5B8N0C
- email.queued09:30:12.041
已通过 API 接收 · Idempotency-Key order_4821
- email.sent09:30:12.388
已交付投递网络 · TLS 1.3
- email.delivered09:30:13.902
250 2.0.0 OK — gmail-smtp-in.l.google.com
- email.opened09:34:51
Apple Mail · 已启用隐私保护
- email.clicked09:35:07
acme.com/orders/4821
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 等服务商的配置指南
hulakimail.com/app/acme/domains/acme.com
acme.com
请在你的 DNS 服务商处添加以下记录,我们会自动检测。
类型名称值状态
TXT@v=spf1 include:spf.hulakimail.com ~allSPF
CNAMEhm1._domainkeyhm1.dkim.hulakimail.comDKIM
CNAMEhm2._domainkeyhm2.dkim.hulakimail.comDKIM
MXbounce10 feedback.hulakimail.comReturn-Path
TXT_dmarcv=DMARC1; p=quarantine; rua=mailto:…DMARC
CNAMElinkstrack.hulakimail.com检测中
更多功能
生产级邮件管道所需的一切
幂等请求
同一个 Idempotency-Key 发送两次,你拿到的是原始响应,而不是一封重复的邮件。
批量发送
一次 API 调用即可排队发送最多 100 封个性化邮件。
定时发送
设置 scheduled_at 即可稍后发送——发出前还能取消。
附件
通过 content_id 发送 PDF 发票、日历邀请和内嵌图片。
标签与元数据
为邮件打标签方便筛选,每个 Webhook 都会带回你的元数据。
打开与点击追踪
可按邮件单独开启,使用你自己的品牌追踪域名。
抑制列表
已退信、已投诉和已退订的地址会被自动跳过。
限定权限的 API 密钥
生产环境用仅发送密钥,仪表盘用只读密钥,管理脚本用完全访问密钥。
可预期的错误
每个错误都包含类型、易读的说明、机器可读的错误码以及出错的参数。