REST API v1 · CORS Enabled · Free

Dokumentasi API Konto.lol

Gunakan REST API publik gratis Konto.lol untuk mengotomatiskan pembuatan email sementara, pengujian aplikasi, serta pembacaan kode OTP dan verifikasi tautan secara realtime.

BASE URL

https://konto.lol

GET /init

Informasi Server & Domain

Mengembalikan daftar domain yang tersedia dan waktu masa simpan email (TTL).

RESPONSE (200 OK):

{
  "status": "success",
  "domains": ["konto.lol"],
  "primaryDomain": "konto.lol",
  "ttlMinutes": 60,
  "storage": "redis",
  "timestamp": "2026-08-31T04:20:00.000Z"
}

GET /address

Buat Email Acak Baru

Menghasilkan alamat email sementara acak baru secara instan yang siap menerima pesan.

Query Parameter	Tipe	Wajib?	Keterangan
`domain`	String	Opsional	Pilih domain tertentu jika server memiliki multi-domain

RESPONSE (200 OK):

{
  "status": "success",
  "address": "zellrayy61939863@konto.lol",
  "email": "zellrayy61939863@konto.lol",
  "domain": "konto.lol"
}

GET /inbox?email={address}

Daftar Email Masuk

Mengambil semua daftar pesan yang telah diterima di kotak masuk alamat tertentu.

Query Parameter	Tipe	Wajib?	Keterangan
`email`	String	Wajib	Alamat email lengkap (contoh: `nova5089@konto.lol`)

RESPONSE (200 OK):

{
  "status": "success",
  "address": "nova5089@konto.lol",
  "count": 1,
  "messages": [
    {
      "id": "f1c8e2a1f4b20726",
      "to": "nova5089@konto.lol",
      "from": "Anita Putri ",
      "senderName": "Anita Putri",
      "senderEmail": "anitaputriatri@gmail.com",
      "subject": "Kode Verifikasi Anda",
      "text": "Gunakan kode 482910 untuk verifikasi akun Anda.\n",
      "snippet": "Gunakan kode 482910 untuk verifikasi akun Anda.",
      "otp": "482910",
      "links": [],
      "date": "2026-08-31T04:15:00.000Z",
      "receivedAt": 1788119476218,
      "attachmentsCount": 0
    }
  ]
}

GET /message?email={address}&id={id}

Detail Lengkap Pesan & HTML

Membaca isi lengkap sebuah pesan (termasuk HTML render, teks polos, ekstraksi otomatis tautan, dan kode OTP).

Query Parameter	Tipe	Wajib?	Keterangan
`email`	String	Wajib	Alamat email penerima
`id`	String	Wajib	ID unik pesan yang didapatkan dari `/inbox`

RESPONSE (200 OK):

{
  "status": "success",
  "message": {
    "id": "f1c8e2a1f4b20726",
    "to": "nova5089@konto.lol",
    "from": "Anita Putri ",
    "senderName": "Anita Putri",
    "senderEmail": "anitaputriatri@gmail.com",
    "subject": "Kode Verifikasi Anda",
    "text": "Kode verifikasi Anda adalah 482910...",
    "html": "Kode verifikasi Anda adalah 482910",
    "otp": "482910",
    "links": [
      {
        "label": "Konfirmasi Akun",
        "url": "https://service.com/verify?token=xyz123"
      }
    ],
    "date": "2026-08-31T04:15:00.000Z",
    "receivedAt": 1788119476218,
    "attachmentsCount": 0
  }
}

DELETE /message?email={address}&id={id}

Hapus Pesan Tertentu

Menghapus pesan tertentu secara permanen dari server penyimpanan.

RESPONSE (200 OK):

{
  "status": "success",
  "message": "Email berhasil dihapus"
}

DELETE /inbox?email={address}

Kosongkan Kotak Masuk

Menghapus seluruh pesan yang ada di kotak masuk alamat tertentu.

RESPONSE (200 OK):

{
  "status": "success",
  "message": "Inbox nova5089@konto.lol berhasil dibersihkan"
}

Contoh Integrasi Lengkap (JavaScript / Node.js)

// 1. Generate alamat email acak baru
const { address } = await fetch('https://konto.lol/address').then(r => r.json());
console.log('Alamat Email Baru:', address);

// 2. Cek pesan masuk secara berkala
async function checkInbox(targetAddress) {
  const { messages } = await fetch(`https://konto.lol/inbox?email=${encodeURIComponent(targetAddress)}`).then(r => r.json());
  
  if (messages && messages.length > 0) {
    const latest = messages[0];
    console.log(`[Pesan Baru] Dari: ${latest.senderName} (${latest.senderEmail})`);
    console.log(`Subjek: ${latest.subject}`);
    
    // Jika ada kode OTP otomatis terdeteksi:
    if (latest.otp) {
      console.log('✨ Kode OTP Terdeteksi:', latest.otp);
    }
  }
}

// Jalankan polling
checkInbox(address);