Pierwsze kroki z API DustMail
API DustMail pozwala programowo tworzyć tymczasowe skrzynki e-mail i odbierać wiadomości. Przydaje się zwłaszcza w testach automatycznych, potokach CI/CD i przy budowie aplikacji dbających o prywatność. Ten przewodnik omawia wszystkie najważniejsze punkty końcowe wraz z przykładami dla cURL, Node.js i Pythona.
Uwierzytelnianie
Każde żądanie API wymaga klucza. Wygenerujesz go w swoim panelui przesyłasz w nagłówku Authorization:
Authorization: Bearer dm_live_your_api_key
Tworzenie skrzynki
Wyślij żądanie POST, aby utworzyć nowy tymczasowy adres e-mail:
POST https://dustmail.net/api/v1/inbox
Przykład cURL
curl -X POST https://dustmail.net/api/v1/inbox \ -H "Authorization: Bearer dm_live_xxx" \ -H "Content-Type: application/json" \ -d '{"duration": 30}'
Sprawdzanie nowych wiadomości (polling)
Po utworzeniu skrzynki odpytuj API w regularnych odstępach, aby odczytać nowe wiadomości:
GET https://dustmail.net/api/v1/inbox/YOUR_INBOX_ID
Limity zapytań
Konta darmowe mają limit 100 wywołań API dziennie. Użytkownicy Premium korzystają z nielimitowanej liczby wywołań. Szczegóły znajdziesz na stronie cennika.
Zastosowania
- Testy E2E - Weryfikacja procesów rejestracji e-mailowej w testach automatycznych
- Potoki CI/CD - Automatyczne sprawdzanie przy każdym wdrożeniu, czy wysyłka poczty działa
- Aplikacje prywatnościowe - Wbudowanie jednorazowych adresów wprost w Twój produkt