API Dokümantasyonu

Tek kullanımlık e-posta adreslerini uygulamalarınıza ve iş akışlarınıza entegre edin

https://dustmail.net/api/v1

🔑 Kimlik Doğrulama

Tüm API istekleri bir API anahtarı gerektirir. Anahtarınızı Authorization başlığıyla veya X-API-Key başlığıyla iletin.

API anahtarlarını Panelinizdenoluşturun. Her anahtar dm_live_ile başlar.

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"

İstek Sınırları

Ücretsiz

100

istek / gün

Premium

∞

sınırsız

POST/api/v1/inbox

Yeni bir geçici e-posta kutusu oluşturun. Oluşturulan e-posta adresi ve sona erme zamanı dahil kutu ayrıntılarını döndürür. Premium anahtarlar ayrıca özel kullanıcı adı isteyebilir, yapılandırılmış ortak alan adlarından seçim yapabilir veya DNS TXT + MX doğrulamasından sonra Premium kullanıcıya ait doğrulanmış özel alan adlarını seçebilir.

İstek Gövdesi

Parametre	Tür	Açıklama
usernameisteğe bağlı	string	E-posta adresi için özel kullanıcı adı. Premium API anahtarı gerektirir.
domainisteğe bağlı	string	İstenen kutu alan adı. Ücretsiz anahtarlar birincil ortak alan adını kullanır; Premium anahtarlar ise yapılandırılmış ortak alan adlarını veya API anahtarı sahibine ait doğrulanmış özel alan adlarını seçebilir.

Örnek

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

Yanıt

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

Hesabınıza bağlı tüm etkin kutuları listeler. E-posta sayılarıyla birlikte en fazla 50 kutu döndürür.

Örnek

bash

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

Yanıt

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

Kutu ayrıntılarını ve alınan tüm e-postaları getirir. Tam içerikle (metin ve HTML) en yeni 100 e-postaya kadar döndürür.

Yol Parametreleri

Parametre	Tür	Açıklama
idzorunlu	uuid	Oluşturma sırasında döndürülen kutu kimliği

Örnek

bash

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

Yanıt

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

Kod Örnekleri

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

Bir kutuyu siler (devre dışı bırakır). Yalnızca hesabınıza ait kutuları silebilirsiniz. Silme işleminden sonra API bu kutuyu artık döndürmez.

Örnek

bash

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

Yanıt

json

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