Email sementara langsung dari aplikasimu.

Autentikasi

Semua request dari luar website wajib membawa API key. Request tanpa API key ditolak dengan 401. Minta API key ke admin website ini (Admin Panel → Settings → API Keys). Tombol Coba di halaman ini tetap jalan tanpa key karena dipanggil dari website sendiri.

Kirim API key dengan salah satu cara:

# Header (disarankan)
Authorization: Bearer API_KEY_KAMU
X-API-Key: API_KEY_KAMU

# Atau query string
https://www.vouie.my.id/api.php?to=contoh@vouie.my.id&key=API_KEY_KAMU

Buat email, tunggu email masuk, lalu ambil kode OTP-nya.

# 1. Buat email acak
curl "https://www.vouie.my.id/api.php?action=generate_email"   -H "Authorization: Bearer API_KEY_KAMU"

# 2. Baca inbox
curl "https://www.vouie.my.id/api.php?to=contoh@vouie.my.id" \
  -H "Authorization: Bearer API_KEY_KAMU"

const API = "https://www.vouie.my.id/api.php";
const headers = { Authorization: "Bearer API_KEY_KAMU" };

// 1. Buat email acak
const { email } = await fetch(`${API}?action=generate_email`, { headers }).then(r => r.json());

// 2. Tunggu email masuk (cek tiap 5 detik, maks 2 menit)
for (let i = 0; i < 24; i++) {
  const inbox = await fetch(`${API}?to=${encodeURIComponent(email)}`, { headers }).then(r => r.json());
  if (inbox.length) {
    const otp = (inbox[0].subject + inbox[0].body).match(/\b\d{4,8}\b/)?.[0];
    console.log(email, otp);
    break;
  }
  await new Promise(r => setTimeout(r, 5000));
}

import re, time, requests

API = "https://www.vouie.my.id/api.php"
HEADERS = {"Authorization": "Bearer API_KEY_KAMU"}

# 1. Buat email acak
email = requests.get(API, params={"action": "generate_email"}, headers=HEADERS).json()["email"]

# 2. Tunggu email masuk (cek tiap 5 detik, maks 2 menit)
for _ in range(24):
    inbox = requests.get(API, params={"to": email}, headers=HEADERS).json()
    if inbox:
        otp = re.search(r"\b\d{4,8}\b", inbox[0]["subject"] + inbox[0]["body"])
        print(email, otp.group() if otp else None)
        break
    time.sleep(5)

<?php
$api = "https://www.vouie.my.id/api.php";
$ctx = stream_context_create(['http' => ['header' => "Authorization: Bearer API_KEY_KAMU"]]);

// 1. Buat email acak
$email = json_decode(file_get_contents("$api?action=generate_email", false, $ctx), true)['email'];

// 2. Tunggu email masuk (cek tiap 5 detik, maks 2 menit)
for ($i = 0; $i < 24; $i++) {
    $inbox = json_decode(file_get_contents("$api?to=" . urlencode($email), false, $ctx), true);
    if (!empty($inbox)) {
        preg_match('/\b\d{4,8}\b/', $inbox[0]['subject'] . $inbox[0]['body'], $m);
        echo $email . ' ' . ($m[0] ?? '-');
        break;
    }
    sleep(5);
}

Ambil semua domain email yang tersedia.

Contoh Respons

{
  "success": true,
  "domains": ["vouie.my.id"]
}

Buat alamat email acak dari domain yang tersedia. Alamat langsung bisa menerima email, tidak perlu didaftarkan.

Contoh Respons

{
  "success": true,
  "email": "k3x9pq2a@vouie.my.id",
  "username": "k3x9pq2a",
  "domain": "vouie.my.id"
}

Buat alamat email dengan nama pilihan sendiri. Kalau domain dikosongkan, dipilih acak dari domain yang tersedia.

Contoh Respons

{
  "success": true,
  "email": "tokoku@vouie.my.id",
  "username": "tokoku",
  "domain": "vouie.my.id"
}

Ambil semua email masuk untuk sebuah alamat. Hasilnya array, kosong kalau belum ada email.

Contoh Respons

[
  {
    "id": "a1b2c3",
    "from": "Canva <no-reply@canva.com>",
    "fromName": "Canva",
    "subject": "Kode verifikasi Anda: 482913",
    "date": "2026-10-14T09:12:00+07:00",
    "snippet": "Gunakan kode 482913 untuk ...",
    "body": "Teks email ...",
    "html": "<html>...</html>"
  }
]

Endpoint ringan untuk polling. Cek apakah ada email baru sejak waktu tertentu (Unix timestamp). Panggil tiap beberapa detik, lalu ambil inbox kalau new = true.

Contoh Respons

{
  "new": true,
  "arrived": 1791945600,
  "from": "Canva",
  "subject": "Kode verifikasi Anda",
  "emails": [ ... ]
}

Hapus satu email dari inbox. Kirim sebagai form-data.

Contoh Respons

{
  "success": true
}

Simpan teks dan dapatkan link pendek. Maksimal 500KB, 10 paste per menit per IP.

Contoh Respons

{
  "success": true,
  "id": "ab12cd34",
  "url": "/ab12cd34"
}

Ambil isi paste berdasarkan ID 8 karakter.

Contoh Respons

{
  "success": true,
  "paste": { "id": "ab12cd34", "title": "...", "content": "..." }
}

Error

Kalau gagal, respons berisi field error. Selalu cek field ini dulu.

{ "error": "API key diperlukan. Lihat dokumentasi di /docs." }   // HTTP 401, API key kosong/salah
{ "error": "Website ini dikunci oleh admin.", "locked": true }   // butuh API key
{ "error": "Terlalu banyak permintaan. Coba lagi nanti." }   // HTTP 429, rate limit