Документация

Руководство по быстрому старту

Начните работу с Mailhook менее чем за 5 минут.

1. Получите учётные данные API

Зарегистрируйте бесплатный аккаунт и сгенерируйте учётные данные API.

1. Создайте аккаунт на app.mailhook.co
2. Перейдите в Настройки → API
3. Сгенерируйте новый API-ключ
4. Сохраните Agent ID и API Key в надёжном месте

2. Создайте первый почтовый ящик

Используйте API для создания случайного email-адреса.

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. Получайте письма

Опрашивайте входящие письма через polling или настройте 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 для получения уведомлений о письмах в реальном времени
• Добавьте собственный домен для брендированных email-адресов
• Изучите полный справочник API со всеми доступными эндпоинтами