# Webhook、API 与 MCP

Webhook、API、MCP 全部属于 Console，Node 不实现这些能力。

## Webhook

邮件保存成功后创建 delivery。Payload：

```json
{
  "event": "email.received",
  "id": "msg_xxx",
  "mailbox": "hello@example.com",
  "from": "user@example.org",
  "to": ["hello@example.com"],
  "subject": "Hello",
  "text": "Hello World",
  "received_at": "2026-09-30T10:00:00Z"
}
```

Webhook 必须签名，建议提供 X-WmailHub-Event、X-WmailHub-Delivery、X-WmailHub-Timestamp、X-WmailHub-Signature。

2xx 为成功；5xx 和 timeout 重试；4xx 按策略处理。使用指数退避和最大尝试次数。

## API

```text
/api/v1/nodes
/api/v1/domains
/api/v1/mailboxes
/api/v1/emails
/api/v1/webhooks
/api/v1/mcp
```

API 属于 Console。

## MCP

MCP 允许 Agent 查询邮箱、获取邮件、查询邮件状态、管理邮箱和 Webhook。Node 不暴露 MCP。

MCP/API 获取邮件时必须检查用户权限、邮件是否过期、mailbox scope 和 API credential scope。

Webhook endpoint 必须防 SSRF，至少阻止 localhost、private IPv4/IPv6、link-local、metadata endpoint 和 DNS rebinding。