REST API Reference

Dokumentasi Integrasi & Developer API

Gunakan API TempMail-Gua untuk mengotomasi pendaftaran akun, pembuatan bot Telegram/Discord, pengujian sistem QA, atau aplikasi multi-tenant Anda.

Buat API Key Instan

Gratis & Langsung Aktif

Endpoint publik kami dapat langsung digunakan tanpa autentikasi. Namun jika Anda membutuhkan kuota rate-limit lebih tinggi (120 req/menit), buat API key di bawah ini:

Daftar Endpoint REST API

POST/api/mailboxes

Buat / Generate Alamat Email Baru

Request Body (JSON - Opsional):

{
  "username": "tester123",       // Opsional (kosongkan untuk username acak)
  "domain": "tempmailgua.my.id",  // Opsional (kosongkan untuk domain default)
  "expiresInHours": 24            // Default 24 jam
}

Contoh Response (200 OK):

{
  "success": true,
  "message": "Mailbox berhasil dibuat!",
  "data": {
    "address": "tester123@tempmailgua.my.id",
    "token": "49f0a82b8c9d1234...",
    "expiresAt": "2026-10-25T08:00:00.000Z",
    "createdAt": "2026-10-24T08:00:00.000Z"
  }
}

GET/api/mailboxes/{address}/messages

Ambil Daftar Email Masuk di Mailbox

Contoh Response (200 OK):

{
  "success": true,
  "data": {
    "address": "tester123@tempmailgua.my.id",
    "count": 1,
    "messages": [
      {
        "id": "cmv1234abc...",
        "fromAddress": "no-reply@discord.com",
        "fromName": "Discord",
        "toAddress": "tester123@tempmailgua.my.id",
        "subject": "Your Discord verification code is: 492019",
        "bodyText": "Your verification code is: 492019...",
        "isRead": false,
        "receivedAt": "2026-10-24T08:05:12.000Z"
      }
    ]
  }
}

GET/api/messages/{id}

Detail Lengkap Email (HTML Body & Teks)

Contoh Response (200 OK):

{
  "success": true,
  "data": {
    "id": "cmv1234abc...",
    "fromAddress": "no-reply@discord.com",
    "fromName": "Discord",
    "toAddress": "tester123@tempmailgua.my.id",
    "subject": "Your Discord verification code is: 492019",
    "bodyText": "Your verification code is: 492019...",
    "bodyHtml": "<div><h1>Your verification code</h1><p>492019</p></div>",
    "receivedAt": "2026-10-24T08:05:12.000Z"
  }
}

GET/api/domains

Daftar Seluruh Domain yang Tersedia

Contoh Kode Integrasi

Siap Copy-Paste ke Proyek Anda

JavaScript / Fetch (Node.js & Browser)

// 1. Buat temporary mailbox
const res = await fetch("http://localhost:3000/api/mailboxes", { method: "POST" });
const { data } = await res.json();
console.log("Email saya:", data.address);

// 2. Tunggu dan ambil pesan masuk
const inboxRes = await fetch(`http://localhost:3000/api/mailboxes/${data.address}/messages`);
const { data: inbox } = await inboxRes.json();
console.log("Pesan diterima:", inbox.messages);

Python (Requests)

import requests
import time

# 1. Buat mailbox
res = requests.post("http://localhost:3000/api/mailboxes").json()
email_address = res["data"]["address"]
print("Email:", email_address)

# 2. Polling inbox
time.sleep(5)
messages = requests.get(f"http://localhost:3000/api/mailboxes/{email_address}/messages").json()
print("Messages:", messages["data"]["messages"])

Interactive API Playground

Uji langsung API tanpa membuka Postman atau terminal: