Документация
Документация API
Всё необходимое для интеграции Mailhook в ваше приложение.
Руководство по быстрому старту
Начните работу с Mailhook менее чем за 5 минут.
1. Получите учётные данные API
Зарегистрируйте бесплатный аккаунт и сгенерируйте учётные данные API.
- Создайте аккаунт на app.mailhook.co
- Перейдите в Настройки → API
- Сгенерируйте новый API-ключ
- Сохраните 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 со всеми доступными эндпоинтами
Настройка Webhook
Настройте webhook для получения писем в реальном времени с подписанными данными.
Собственные домены
Добавьте и верифицируйте собственный домен для брендированных email-адресов.
Интеграция с AI-агентами
Лучшие практики интеграции Mailhook с LLM-агентами и системами автоматизации.
Тестирование в CI/CD
Используйте Mailhook в тестовом окружении для проверки email-процессов.
Лимиты и лучшие практики
Разберитесь в лимитах запросов и оптимизируйте использование API.
Обработка ошибок
Корректная обработка ошибок API с использованием кодов ошибок и логики повторных запросов.