Dokumentasi API

Jika tidak membawa Key, Anda dapat memanggil sistem secara anonim, dan proses pembuatan/penggunaan email sementara tersebut sepenuhnya gratis. Jika Anda telah membeli paket yang termasuk fitur API, Anda dapat membuat Key sendiri di pusat keanggotaan → Developer API Key. Dengan menggunakan Key ini untuk memanggil sistem, Anda akan mendapatkan batas penyimpanan dan masa berlaku yang sesuai dengan paket yang Anda beli.

Cara membawa (pilih salah satu)

Contoh permintaan/permohonan

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

Sekarang, sebuah alamat email sementara akan dihasilkan secara acak. Setelah alamat tersebut terbentuk, Anda dapat menerima pesan dengan mudah, tanpa perlu mengaktifkannya terlebih dahulu.

Parametern yang diminta

Contoh permintaan/permohonan

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

Contoh Respons

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

Aturlah alamat dengan prefix khusus tersebut (bentuk: prefix@nama-domain). Selanjutnya, verifikasi apakah nama domain tersebut memungkinkan untuk menerima pesan.

Parametern yang diminta

Contoh permintaan/permohonan

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

Contoh Respons

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

Mengambil email dari alamat yang ditentukan (50 email terbaru, disusun berdasarkan waktu penerimaan, dari yang paling baru ke yang paling lama). Disarankan untuk melakukan pemeriksaan setiap 1 hingga 3 detik.

Parametern yang diminta

Contoh permintaan/permohonan

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

Contoh Respons

{
  "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"
    }
  ]
}

Lihat detail email tersebut (penerima, topik, isi email, daftar lampiran). Setelah dilihat, email tersebut akan dianggap telah dibaca.

Parametern yang diminta

Contoh permintaan/permohonan

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

Contoh Respons

{
  "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 }
    ]
  }
}

Unduh lampiran email tersebut (dalam bentuk file langsung, bukan dalam format JSON).

Parametern yang diminta

Contoh permintaan/permohonan

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

Simpan alamat tersebut ke dalam akun Anda untuk disimpan dalam jangka panjang (perlu log in atau membawa API Key). Jumlah alamat yang dapat disimpan dibatasi oleh batas yang tercantum pada paket “Email yang dapat disimpan”.

Parametern yang diminta

Contoh permintaan/permohonan

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

Silakan daftarkan alamat email yang telah disimpan di akun Anda (perlu log in atau membawa API Key).

Contoh permintaan/permohonan

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

Skrip berikut dapat dijalankan langsung di konsol browser atau dalam lingkungan Node: menghasilkan alamat web, melakukan pemrosesan data dari kotak masuk, dan mencetak kode verifikasi setelah menerima email pertama.

// 1. Membuat alamat sementara
const BASE = 'https://www.mail0.vip';
const gen = await (await fetch(BASE + '/mail/gen')).json();
const address = gen.address;
console.log('Email sementarku:', address);

// 2. Memeriksa kotak masuk setiap 2 detik, berhenti setelah menerima email pertama
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('Email baru:', m.subject, code ? 'Kode Verifikasi' + code[0] : '');
  }
  await new Promise(r => setTimeout(r, 2000));
}