跳到内容
API 参考

Skrybo REST API

一个基础 URL、一个 bearer 令牌、七个端点。与 Resend 相同的 POST /v1/emails 结构——迁移时只需更换基础 URL。完整文档位于 /docs.

发送一封邮件

POST /v1/emails

curl
curl -X POST https://api.skrybo.com/v1/emails \
  -H "Authorization: Bearer skrybo_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"from":"you@your-domain.com","to":["a@b.com"],"subject":"Hi","html":"<p>Hi</p>"}'
JavaScript
import { Skrybo } from "skrybo";

const s = new Skrybo(process.env.SKRYBO_API_KEY);

await s.emails.send({
  from: "you@your-domain.com",
  to: ["a@b.com"],
  subject: "Hi",
  html: "<p>Hi</p>",
});
Python
from skrybo import Skrybo

s = Skrybo(api_key=os.environ["SKRYBO_API_KEY"])

s.emails.send(
    from_="you@your-domain.com",
    to=["a@b.com"],
    subject="Hi",
    html="<p>Hi</p>",
)
端点

以下路径下的全部内容： /v1

方法路径用途
POST/v1/emails发送单封事务邮件（结构与 Resend 兼容）。
POST/v1/emails/batch一次请求最多发送 100 封邮件。结构相同。
GET/v1/emails/:id查询投递状态、打开、点击与退信。
GET/v1/audiences列出账户下的受众。
POST/v1/audiences为群发创建新的受众。
POST/v1/audiences/:audienceId/contacts向受众添加联系人。
GET/v1/audiences/:audienceId/contacts列出受众中的联系人。
GET/v1/suppressions列出抑制记录及其原因和 created_at。
POST/v1/suppressions将一个地址加入你的抑制列表。
SMTP 中继

标准 SMTP，标准端口

  • 主机： smtp.skrybo.com
  • 端口： 587（STARTTLS）或 465（隐式 TLS）
  • 用户名： apikey
  • 密码： skrybo_live_… — 你的开发者 API 密钥
Webhook 事件

Standard Webhooks，HMAC-SHA256

事件触发时机
email.sent中继已接收该邮件。
email.delivered收件方 MTA 已确认送达。
email.bounced硬退信（地址已加入抑制列表）。
email.complained收件人将其标记为垃圾邮件。
email.opened追踪像素已加载。
email.clicked已点击一个被改写的链接。

常见问题