GACORMAIL
API Docs
Disposable Email API

Build inbox automation with Gacormail.

API ringan untuk membuat alamat email sementara, polling pesan masuk, membaca OTP/link verifikasi, dan menerima inbound email dari worker atau forwarder.

Overview

Semua endpoint publik berada di domain utama. Jangan gunakan api.gacormail.me kecuali subdomain itu memang sudah diset di DNS dan Vercel. Untuk website saat ini, gunakan https://gacormail.me/api.

Authentication

Endpoint inbox publik tidak perlu token. Endpoint inbound dapat diamankan dengan header x-inbound-secret jika server mengaktifkan secret.

Address Encoding

Path parameter address harus URL-encoded. Contoh user@gacormail.me menjadi user%40gacormail.me.

Quickstart Polling OTP

Flow umum untuk automation: buat inbox, trigger OTP di aplikasi target, polling messages, lalu ambil kode/link dari field text atau html.

Python
import re
import time
import requests
from urllib.parse import quote

BASE_URL = "https://gacormail.me/api"

created = requests.post(f"{BASE_URL}/inbox/create", json={
    "suggestedAddress": "teze5yruxa@gacormail.me",
    "domain": "gacormail.me",
}, timeout=20).json()

address = created["address"]
encoded = quote(address, safe="")

for _ in range(40):
    inbox = requests.get(f"{BASE_URL}/inbox/{encoded}/messages", timeout=20).json()
    for msg in inbox.get("messages", []):
        text = f"{msg.get('subject', '')}\n{msg.get('text', '')}\n{msg.get('html', '')}"
        otp = re.search(r"\b\d{4,8}\b", text)
        if otp:
            print("OTP:", otp.group(0))
            raise SystemExit
    time.sleep(3)

raise TimeoutError("OTP not found")
GET/api/domains

Get active domains

Mengambil daftar domain tempmail yang bisa dipakai untuk membuat inbox.

public
curl
curl https://gacormail.me/api/domains
Response
{
  "domains": ["gacormail.me"],
  "defaultDomain": "gacormail.me"
}
POST/api/inbox/create

Create or activate inbox

Membuat inbox baru atau mengaktifkan inbox sesuai alamat yang diminta.

public
curl
curl -X POST https://gacormail.me/api/inbox/create \
  -H "Content-Type: application/json" \
  -d '{"suggestedAddress":"teze5yruxa@gacormail.me","domain":"gacormail.me"}'
JavaScript
const res = await fetch("/api/inbox/create", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    suggestedAddress: "teze5yruxa@gacormail.me",
    domain: "gacormail.me",
  }),
});

const inbox = await res.json();
Response
{
  "address": "teze5yruxa@gacormail.me",
  "domain": "gacormail.me",
  "domains": ["gacormail.me"],
  "defaultDomain": "gacormail.me"
}
GET/api/inbox/{address}/messages

Get inbox messages

Mengambil daftar pesan inbox terbaru. Response diurutkan dari pesan terbaru.

public

Penting: parameter address harus full email dan URL-encoded. Jangan panggil /inbox/teze5yruxa. Panggil /api/inbox/teze5yruxa%40gacormail.me/messages.

curl
curl "https://gacormail.me/api/inbox/teze5yruxa%40gacormail.me/messages"
JavaScript
const address = "teze5yruxa@gacormail.me";
const encoded = encodeURIComponent(address);
const res = await fetch(`/api/inbox/${encoded}/messages`);
const inbox = await res.json();
Response
{
  "address": "teze5yruxa@gacormail.me",
  "messages": [
    {
      "id": "3e2f...",
      "to": "teze5yruxa@gacormail.me",
      "from": "sender@example.com",
      "subject": "Your verification code",
      "text": "Your code is 123456",
      "html": "<p>Your code is 123456</p>",
      "createdAt": "2026-07-10T11:58:24.000Z"
    }
  ]
}
DELETE/api/inbox/{address}

Delete inbox

Menghapus inbox aktif dari memory server.

public
curl
curl -X DELETE "https://gacormail.me/api/inbox/teze5yruxa%40gacormail.me"
Response
{
  "ok": true,
  "address": "teze5yruxa@gacormail.me"
}
POST/api/inbound/email

Store inbound email

Endpoint untuk worker atau forwarder email agar pesan bisa masuk ke inbox Gacormail.

optional secret
curl
curl -X POST https://gacormail.me/api/inbound/email \
  -H "Content-Type: application/json" \
  -H "x-inbound-secret: YOUR_SECRET" \
  -d '{
    "to": "teze5yruxa@gacormail.me",
    "from": "sender@example.com",
    "subject": "Hello",
    "text": "Message body",
    "html": "<p>Message body</p>"
  }'
Response
{
  "ok": true,
  "stored": 1
}

Errors & Troubleshooting

DNS error api.gacormail.me

Gunakan https://gacormail.me/api. Subdomain api.gacormail.me tidak otomatis aktif tanpa DNS/Vercel domain setup.

400 unsupported domain

Alamat harus memakai domain yang ada di /api/domains dan parameter harus full email address.

Inbox kosong

Pastikan email sudah dikirim ke alamat yang sama persis, lalu polling ulang. Pesan juga punya TTL dan bisa expired.

401 unauthorized

Endpoint inbound membutuhkan header x-inbound-secret jika secret diaktifkan pada server.