⚡ TempMail API

← Landing · Admin
Dua jalur akses:
• Publik (/pub/*) — tanpa API key, untuk landing page. Siapa pun yang tahu alamat email bisa membacanya.
• Ber-key (/api/*) — butuh x-api-key dari admin. Domain bisa dibatasi per key.

Base URL

https://tempmail.syns4033.workers.dev

Format Respons

// sukses
{ "success": true, "data": { ... }, "ts": "2026-11-16T21:00:00.000Z" }

// error
{ "success": false, "error": "pesan", "ts": "..." }
KodeArti
200Sukses
400Parameter tidak valid
401API key / admin token salah
403Domain tidak diizinkan untuk akun ini
404Tidak ditemukan
429Rate limit (endpoint publik)
503Tidak ada domain aktif

Publik — tanpa API key

GET/pub/domains

Daftar domain yang bisa dipakai.

curl https://tempmail.syns4033.workers.dev/pub/domains
POST/pub/createmax 5 alamat/request

Buat alamat baru. Body opsional: domain, username, count.

curl -X POST https://tempmail.syns4033.workers.dev/pub/create \
  -H 'content-type: application/json' \
  -d '{"username":"budi","count":1}'

# balasan (count=1)
{"success":true,"data":{"email":"budi@syns4033mail.dev","domain":"syns4033mail.dev",
 "username":"budi","expires_in_hours":6}}

# count > 1 → data.emails = [ ... ]
GET/pub/inbox/:address

Daftar email di inbox (maks 50 terbaru).

curl "https://tempmail.syns4033.workers.dev/pub/inbox/budi%40syns4033mail.dev"
GET/pub/email/:id

Isi lengkap satu email (text + html).

GET/pub/otp/:address

OTP terbaru dari inbox.

curl "https://tempmail.syns4033.workers.dev/pub/otp/budi%40syns4033mail.dev"
# {"success":true,"data":{"found":true,"otp":"847291",...}}
DELETE/pub/inbox/:address

Hapus semua email di satu alamat.

Ber-API-key — x-api-key: tmp_...

Dapatkan key dari admin. Key bisa dibatasi ke domain tertentu.

GET/api/domains

Domain yang boleh dipakai key ini.

POST/api/createbulk: count / usernames[]

Buat 1 atau banyak alamat sekaligus (maks 50).

# satu alamat
curl -X POST https://tempmail.syns4033.workers.dev/api/create \
  -H 'x-api-key: tmp_xxx' -H 'content-type: application/json' -d '{}'

# bulk by count
curl -X POST .../api/create -H 'x-api-key: tmp_xxx' \
  -H 'content-type: application/json' -d '{"count":10,"domain":"syns4033mail.dev"}'

# bulk by usernames
curl -X POST .../api/create -H 'x-api-key: tmp_xxx' \
  -H 'content-type: application/json' -d '{"usernames":["a1","a2","a3"]}'

# balasan bulk
{"success":true,"data":{"emails":[{"email":"a1@...","domain":"...","username":"a1"}],
 "count":3,"invalid":[],"expires_in_hours":6}}
GET/api/mailbox/:address

Daftar email. Alias: /api/inbox/:address.

GET/api/email/:id

Isi lengkap email.

GET/api/otp/:address

OTP terbaru.

DELETE/api/mailbox/:address

Bersihkan inbox.

Webhook

POST/api/webhooks
curl -X POST .../api/webhooks -H 'x-api-key: tmp_xxx' \
  -H 'content-type: application/json' \
  -d '{"url":"https://server-kamu.com/hook"}'
# balasan berisi "secret":"whsec_..." — simpan untuk verifikasi HMAC

Setiap event dikirim dengan header X-Webhook-Signature: sha256=<hmac>.

GET/api/webhooks
DELETE/api/webhooks/:id
PATCH/api/webhooks/:id
POST/api/webhooks/:id/test

Admin — Authorization: Bearer <ADMIN_TOKEN>

GET/api/admin/stats
GET/api/admin/domains
POST/api/admin/domainsbulk
curl -X POST .../api/admin/domains -H "Authorization: Bearer $ADMIN" \
  -H 'content-type: application/json' \
  -d '{"domains":["mail.a.com","mail.b.com","mail.c.com"]}'
# {"added":[...],"skipped":[...],"invalid":[...],"added_count":3}
PATCH/api/admin/domains/:host
DELETE/api/admin/domains/:host
GET/api/admin/keys
POST/api/admin/keys
curl -X POST .../api/admin/keys -H "Authorization: Bearer $ADMIN" \
  -H 'content-type: application/json' \
  -d '{"label":"user-budi","domains":["mail.a.com"]}'
# {"api_key":"tmp_xxxx","id":1,"warning":"Simpan sekarang"}
PATCH/api/admin/keys/:id
DELETE/api/admin/keys/:id

Health

curl https://tempmail.syns4033.workers.dev/health