Mail · 客户使用文档

用户需要准备

只需 Webhook 接收 URL，无需自己的域名或 MX 记录；可使用 PicoSvc Hooks。

工作台操作步骤

1. 01创建 Hooks 接收端或使用现有 Webhook。
2. 02创建 Mail 路由并复制地址。
3. 03发送测试邮件并检查事件与投递状态。

调用与集成示例

先创建 Hooks 收件箱，再创建 Mail 路由，向生成的邮箱发测试邮件，并在 Hooks 查看 JSON。

# 1. Create a Hooks inbox and copy its receiving URL.
# 2. Create a Mail route, using the Hooks URL as webhookUrl.
# 3. Copy the issued address: [email protected]
# 4. Send a test email from your mail client.
# 5. Check Mail delivery history AND the Hooks event body.

示例包含占位值；请替换 $BASE_URL、$SESSION_TOKEN 和生成的 URL。不要将令牌或 API 密钥发布到网站或仓库。

Mail 不要求用户配置邮件 DNS。向 PicoSvc 生成的地址发邮件即可；运营方尚未完成入站配置及端到端测试前，请勿视为可投入生产。

管理 API 入口

POST /api/picosvc/mail/routes

路由名称及接收通知的 Webhook URL。

[email protected] 收件地址、投递记录和发送至 Webhook 的 JSON。

不支持的功能

不是邮箱或发信 API；运营方完成接收配置与端到端测试前，不能保证真实收信。

功能比较与资料来源

收件地址与邮件处理：每条路由生成独立地址并转发至 Webhook，保留历史。

Resend Receiving：文档介绍在提供或自定义域名收信及内容、附件 API。