完整的 API 文档与集成指南

快速入门指南

5 分钟内快速上手 Mailhook。

1. 获取 API 凭据

注册免费账户并生成您的 API 凭据。

在 app.mailhook.co 创建账户
导航至设置 → API
生成新的 API 密钥
妥善保存您的 Agent ID 和 API Key

2. 创建您的第一个邮箱

使用 API 创建一个随机邮箱地址。

curl -X POST https://app.mailhook.co/api/v1/email_addresses/random \
  -H "X-Agent-ID: your_agent_id" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"domain_id": "your_domain_id"}'

3. 接收邮件

轮询获取收到的邮件，或设置 webhook 获取实时通知。

curl https://app.mailhook.co/api/v1/email_addresses/{id}/inbound_emails \
  -H "X-Agent-ID: your_agent_id" \
  -H "X-API-Key: your_api_key"

响应示例

{
  "data": [
    {
      "id": "ie_abc123",
      "type": "inbound_email",
      "attributes": {
        "from": "[email protected]",
        "subject": "Hello from Mailhook",
        "text_body": "Your email content here...",
        "received_at": "2025-01-14T12:00:00Z"
      }
    }
  ]
}

后续步骤

设置 webhook 以获取实时邮件通知
添加自定义域名以使用品牌邮箱地址
浏览完整的 API 参考以了解所有可用端点

文档

快速入门指南

1. 获取 API 凭据

2. 创建您的第一个邮箱

3. 接收邮件

响应示例

后续步骤

Webhook 设置

自定义域名

AI 智能体集成

CI/CD 测试

速率限制与最佳实践

错误处理