Начало работы с API DustMail

API DustMail позволяет программно создавать временные почтовые ящики и получать входящие письма. Это идеальное решение для интеграции с автотестами, CI/CD пайплайнами и разработки приватных приложений. В данном руководстве описаны ключевые методы API с примерами кода на cURL, Node.js и Python.

Аутентификация

Для всех запросов требуется API-ключ. Вы можете создать его в своем Личном кабинетеи передавать в заголовке Authorization:

Authorization: Bearer dm_live_your_api_key

Создание почтового ящика

Отправьте POST-запрос для создания нового временного почтового адреса:

POST https://dustmail.net/api/v1/inbox

Пример cURL

curl -X POST https://dustmail.net/api/v1/inbox \
  -H "Authorization: Bearer dm_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"duration": 30}'

Проверка входящих писем (Polling)

После создания ящика отправляйте запросы к API для проверки получения новых писем:

GET https://dustmail.net/api/v1/inbox/YOUR_INBOX_ID

Лимиты запросов (Rate Limits)

Для бесплатных аккаунтов лимит составляет **100 API-запросов в день**. Premium-аккаунты получают **безлимитный доступ к API**. Повысить лимиты можно на странице тарифов.

Варианты интеграции

• E2E Тестирование - Автоматическая проверка сценариев подтверждения регистрации по почте
• CI/CD Пайплайны - Проверка доставки писем в процессе автоматического развертывания
• Анонимные сервисы - Внедрение функций временной почты прямо в ваш продукт