Príručka pre začiatok s DustMail API

API služby DustMail vám umožňuje programovo vytvárať dočasné e-mailové schránky a prijímať e-maily. To je užitočné najmä pre automatizované testy, CI/CD pipeline a vývoj aplikácií na ochranu súkromia. Tento návod popisuje všetky dôležité API endpointy s praktickými príkladmi pre cURL, Node.js a Python.

Autentifikácia

Každá API požiadavka vyžaduje API kľúč. Môžete si ho vytvoriť vo svojom Ovládacom panelia odoslať ho v hlavičke Authorization:

Authorization: Bearer dm_live_your_api_key

Vytvorenie e-mailovej schránky

Odošlite POST požiadavku na vytvorenie novej dočasnej e-mailovej adresy:

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

Príklad cURL

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

Kontrola nových e-mailov (Polling)

Po vytvorení schránky pravidelne volajte API na kontrolu nových prijatých správ:

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

Limity API volaní (Rate Limits)

Bezplatné účty majú obmedzenie na **100 API volaní denne**. Používatelia s Premium účtom získavajú **neobmedzené API volania**. Tarify sú k dispozícii na stránke cenníka.

Prípady použitia

• E2E Testovanie - Overenie e-mailových registračných tokov v automatizovaných testoch
• CI/CD Pipelines - Automatické overovanie funkčnosti odosielania e-mailov pri nasadení
• Aplikácie na ochranu súkromia - Integrácia jednorazových e-mailov priamo do vášho produktu