Dokumentasi API

Integrasikan alamat email sekali pakai ke aplikasi dan alur kerja Anda

https://dustmail.net/api/v1

🔑 Autentikasi

Semua permintaan API memerlukan kunci API. Kirim kunci Anda melalui header Authorization atau header X-API-Key .

Buat kunci API dari DasborAnda. Setiap kunci diawali dengan 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"

Batas Permintaan

Gratis

100

permintaan / hari

Premium

∞

tanpa batas

POST/api/v1/inbox

Buat kotak masuk email sementara baru. Mengembalikan detail kotak masuk, termasuk alamat email yang dibuat dan waktu kedaluwarsa. Kunci Premium juga dapat meminta nama pengguna kustom, memilih dari domain bersama yang dikonfigurasi, atau memilih domain kustom terverifikasi milik pengguna Premium setelah verifikasi DNS TXT + MX.

Isi Permintaan

Parameter	Tipe	Deskripsi
usernameopsional	string	Nama pengguna kustom untuk alamat email. Memerlukan kunci API Premium.
domainopsional	string	Domain kotak masuk yang diminta. Kunci gratis memakai domain bersama utama, sedangkan kunci Premium dapat memilih domain bersama yang dikonfigurasi atau domain kustom terverifikasi milik pemilik kunci API.

Contoh

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"}'

Respons

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

Menampilkan semua kotak masuk aktif yang terhubung dengan akun Anda. Mengembalikan hingga 50 kotak masuk beserta jumlah emailnya.

Contoh

bash

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

Respons

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

Mengambil detail kotak masuk dan semua email yang diterima. Mengembalikan hingga 100 email terbaru dengan konten lengkap (teks dan HTML).

Parameter Jalur

Parameter	Tipe	Deskripsi
idwajib	uuid	ID kotak masuk yang dikembalikan saat pembuatan

Contoh

bash

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

Respons

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 }
  }
}

Contoh Kode

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

Menghapus (menonaktifkan) kotak masuk. Anda hanya dapat menghapus kotak masuk milik akun Anda. Setelah dihapus, API tidak akan mengembalikannya lagi.

Contoh

bash

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

Respons

json

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