Documentazione API

Integra indirizzi email usa e getta nelle tue app e nei tuoi flussi di lavoro

https://dustmail.net/api/v1

🔑 Autenticazione

Tutte le richieste API richiedono una chiave API. Passa la tua chiave tramite l'header Authorization oppure l'header X-API-Key .

Genera le chiavi API dalla tua Dashboard. Ogni chiave inizia con dm_live_.

bash

# Using Authorization header (recommended)
curl https://dustmail.net/api/v1/inbox \
  -H "Authorization: Bearer dm_live_your_api_key"

# Using X-API-Key header
curl https://dustmail.net/api/v1/inbox \
  -H "X-API-Key: dm_live_your_api_key"

Limiti di richieste

Gratis

100

richieste / giorno

Premium

∞

illimitate

POST/api/v1/inbox

Crea una nuova casella email temporanea. Restituisce i dettagli della casella, compresi l'indirizzo email generato e l'ora di scadenza. Le chiavi Premium possono anche richiedere un nome utente personalizzato, scegliere tra i domini condivisi configurati oppure selezionare domini personalizzati verificati appartenenti all'utente Premium dopo la verifica DNS TXT + MX.

Corpo della richiesta

Parametro	Tipo	Descrizione
usernamefacoltativo	string	Nome utente personalizzato per l'indirizzo email. Richiede una chiave API Premium.
domainfacoltativo	string	Dominio richiesto per la casella. Le chiavi gratuite usano il dominio condiviso principale, mentre le chiavi Premium possono selezionare domini condivisi configurati o domini personalizzati verificati del proprietario della chiave API.

Esempio

bash

curl -X POST https://dustmail.net/api/v1/inbox \
  -H "Authorization: Bearer dm_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"username":"swift.fox4291","domain":"brand.example"}'

Risposta

json

{
  "success": true,
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "email": "[email protected]",
    "domain": "brand.example",
    "created_at": "2026-03-30T12:00:00.000Z",
    "expires_at": "2027-03-30T12:00:00.000Z"
  },
  "meta": {
    "plan": "premium",
    "rate_limit": { "limit": null, "used": 1 },
    "available_domains": ["dustmail.net", "<configured-shared-domain>", "brand.example"]
  }
}

GET/api/v1/inbox

Elenca tutte le caselle attive associate al tuo account. Restituisce fino a 50 caselle con il conteggio delle email.

Esempio

bash

curl https://dustmail.net/api/v1/inbox \
  -H "Authorization: Bearer dm_live_your_api_key"

Risposta

json

{
  "success": true,
  "data": [
    {
      "id": "a1b2c3d4-...",
      "email": "[email protected]",
      "domain": "dustmail.net",
      "created_at": "2026-03-30T12:00:00.000Z",
      "expires_at": "2026-03-30T12:30:00.000Z",
      "email_count": 3
    }
  ],
  "meta": {
    "total": 1,
    "plan": "free",
    "rate_limit": { "limit": 100, "used": 2 }
  }
}

GET/api/v1/inbox/:id

Ottiene i dettagli della casella e tutte le email ricevute. Restituisce fino a 100 email più recenti con il contenuto completo (testo e HTML).

Parametri del percorso

Parametro	Tipo	Descrizione
idobbligatorio	uuid	L'ID della casella restituito alla creazione

Esempio

bash

curl https://dustmail.net/api/v1/inbox/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer dm_live_your_api_key"

Risposta

json

{
  "success": true,
  "data": {
    "inbox": {
      "id": "a1b2c3d4-...",
      "email": "[email protected]",
      "domain": "dustmail.net",
      "created_at": "2026-03-30T12:00:00.000Z",
      "expires_at": "2026-03-30T12:30:00.000Z"
    },
    "emails": [
      {
        "id": "e1f2a3b4-...",
        "from": "[email protected]",
        "subject": "Verify your email address",
        "text": "Click the link below to verify...",
        "html": "<html>...</html>",
        "received_at": "2026-03-30T12:05:30.000Z"
      }
    ]
  },
  "meta": {
    "email_count": 1,
    "rate_limit": { "limit": 100, "used": 3 }
  }
}

Esempi di codice

javascript

// Node.js / JavaScript
const response = await fetch(
  'https://dustmail.net/api/v1/inbox/YOUR_INBOX_ID',
  { headers: { 'Authorization': 'Bearer dm_live_your_api_key' } }
);
const { data } = await response.json();
console.log(data.emails); // Array of received emails

python

# Python
import requests

resp = requests.get(
    "https://dustmail.net/api/v1/inbox/YOUR_INBOX_ID",
    headers={"Authorization": "Bearer dm_live_your_api_key"}
)
emails = resp.json()["data"]["emails"]
print(f"Received {len(emails)} emails")

DELETE/api/v1/inbox/:id

Elimina (disattiva) una casella. Puoi eliminare solo le caselle di proprietà del tuo account. Dopo l'eliminazione la casella non verrà più restituita dall'API.

Esempio

bash

curl -X DELETE https://dustmail.net/api/v1/inbox/a1b2c3d4-... \
  -H "Authorization: Bearer dm_live_your_api_key"

Risposta

json

{
  "success": true,
  "message": "Inbox deleted"
}