Come iniziare con le API di DustMail

Le API di DustMail ti permettono di creare caselle temporanee e ricevere email in modo programmatico. Sono particolarmente utili per i test automatici, le pipeline CI/CD e lo sviluppo di applicazioni attente alla privacy. Questa guida illustra tutti gli endpoint principali con esempi pratici per cURL, Node.js e Python.

Autenticazione

Ogni richiesta API richiede una chiave. Puoi generarla nella tua dashboarde inviarla nell'intestazione Authorization:

Authorization: Bearer dm_live_your_api_key

Creare una casella

Invia una richiesta POST per generare un nuovo indirizzo email temporaneo:

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

Esempio cURL

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

Controllare la posta in arrivo (polling)

Dopo aver creato la casella, interroga periodicamente l'API per leggere i nuovi messaggi:

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

Limiti di frequenza

Gli account gratuiti hanno un limite di 100 chiamate API al giorno. Gli utenti Premium dispongono di chiamate illimitate. I dettagli sono nella pagina dei prezzi.

Casi d'uso

• Test end-to-end - Verifica i flussi di registrazione via email nei test automatici
• Pipeline CI/CD - Controlla a ogni deploy che l'invio delle email funzioni davvero
• App orientate alla privacy - Integra le email usa e getta direttamente nel tuo prodotto