API belgeleri

Anahtarı yanınızda taşımadığınız zaman, ziyaretçiler anonim olarak çağrılır. Geçici e-posta adreslerinin oluşturulması ve okunması tamamen ücretsizdir. Eğer API özellikleri içeren bir paket satın aldıysanız, üye merkezinden “Geliştirici API Anahtarları” bölümünden kendi anahtarınızı kolayca oluşturabilirsiniz. Bu anahtar kullanıldığında, ilgili paketin sunduğu saklama limitleri ve süreleri de kullanılabilir.

Taşıma yöntemi (İki seçenekten birini seçin)

İstek örneği

curl "https://www.mail0.vip/mail/gen?key=YOUR_API_KEY"

Rastgele bir geçici e-posta adresi oluşturulur. Adres oluşturulduktan sonra, önceden etkinleştirme yapmadan da mesajları alabilirsiniz.

Parametreleri iste

İstek örneği

curl "https://www.mail0.vip/mail/gen?domain=ideciphera.com&ttl=60"

Yanıt Örnekleri

{
  "code": 1,
  "address": "k3j8fh2ma@ideciphera.com"
}

Özel bir önek içeren adresi etkinleştirin (önek@domain adı). Domain adının mesaj alabilme özelliğine sahip olduğunu kontrol edin.

Parametreleri iste

İstek örneği

curl -X POST "https://www.mail0.vip/mail/activate" \
  -d "address=mybox@ideciphera.com&ttl=60"

Yanıt Örnekleri

{
  "code": 1,
  "address": "mybox@ideciphera.com"
}

Belirtilen adresin gelen kutusunu çekin (en son 50 e-posta, alınan zamana göre sıralı olarak). 1–3 saniyede bir tarama yapılması önerilir.

Parametreleri iste

İstek örneği

curl "https://www.mail0.vip/mail/inbox?address=mybox@ideciphera.com"

Yanıt Örnekleri

{
  "code": 1,
  "exists": 1,
  "address": "mybox@ideciphera.com",
  "list": [
    {
      "id": 1024,
      "from_addr": "noreply@example.com",
      "from_name": "Example",
      "subject": "Your verification code is 826413",
      "size": 2048,
      "is_read": 0,
      "attachments": 0,
      "received_at": "2026-10-14 18:20:31"
    }
  ]
}

E-postanın detaylarını görüntüleyin (gönderen, konu, metin, ekler listesi). E-posta görüntülandiktan sonra okunmuş olarak işaretlenir.

Parametreleri iste

İstek örneği

curl "https://www.mail0.vip/mail/view?address=mybox@ideciphera.com&id=1024"

Yanıt Örnekleri

{
  "code": 1,
  "data": {
    "id": 1024,
    "from_addr": "noreply@example.com",
    "from_name": "Example",
    "subject": "Your verification code is 826413",
    "body_text": "Dear user, your verification code is 826413, valid for 5 minutes.",
    "received_at_fmt": "2026-10-14 18:20:31",
    "attachments": [
      { "id": 88, "filename": "invoice.pdf", "size": 102400 }
    ]
  }
}

E-postanın eklerini indirin (dosya akışı olarak, JSON formatında değil).

Parametreleri iste

İstek örneği

curl -O "https://www.mail0.vip/mail/attach?id=88"

Bir adresi, hesabınızda uzun süreli olarak saklayabilirsiniz (hesabınıza giriş yapmanız veya API anahtarını kullanmanız gerekiyor). Saklanan adet sayısı, “Saklayabileceğiniz e-posta” limitine bağlıdır.

Parametreleri iste

İstek örneği

curl -X POST "https://www.mail0.vip/mail/save" \
  -d "address=mybox@ideciphera.com&key=YOUR_API_KEY"

Hesabınızda kaydedilmiş e-posta adreslerini listeyin (login yapılması veya API anahtarının kullanılması gerekiyor).

İstek örneği

curl "https://www.mail0.vip/mail/my?key=YOUR_API_KEY"

Aşağıdaki kod, doğrudan tarayıcı konsolunda veya Node.js ortamında çalıştırılabilir: Adres oluşturma, gelen kutuların sorgulanması, ilk e-posta alındığında doğrulama kodu yazdırılması.

// 1. Geçici bir adres oluşturun
const BASE = 'https://www.mail0.vip';
const gen = await (await fetch(BASE + '/mail/gen')).json();
const address = gen.address;
console.log('Geçici e-posta adresim:', address);

// 2. Paging kutusunu sorgulama (Her 2 saniyede bir, ilk mesaj alındığında durma)
const seen = new Set();
while (true) {
  const d = await (await fetch(BASE + '/mail/inbox?address=' + encodeURIComponent(address))).json();
  for (const m of d.list || []) {
    if (seen.has(m.id)) continue;
    seen.add(m.id);
    const code = (m.subject || '').match(/\d{4,8}/);
    console.log('Yeni e-posta:', m.subject, code ? 'CAPTCHA ' + code[0] : '');
  }
  await new Promise(r => setTimeout(r, 2000));
}