/pub/*) — tanpa API key, untuk landing page. Siapa pun yang tahu alamat email bisa membacanya./api/*) — butuh x-api-key dari admin. Domain bisa dibatasi per key.
https://tempmail.syns4033.workers.dev
// sukses
{ "success": true, "data": { ... }, "ts": "2026-11-16T21:00:00.000Z" }
// error
{ "success": false, "error": "pesan", "ts": "..." }
| Kode | Arti |
|---|---|
| 200 | Sukses |
| 400 | Parameter tidak valid |
| 401 | API key / admin token salah |
| 403 | Domain tidak diizinkan untuk akun ini |
| 404 | Tidak ditemukan |
| 429 | Rate limit (endpoint publik) |
| 503 | Tidak ada domain aktif |
Daftar domain yang bisa dipakai.
curl https://tempmail.syns4033.workers.dev/pub/domains
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 = [ ... ]
Daftar email di inbox (maks 50 terbaru).
curl "https://tempmail.syns4033.workers.dev/pub/inbox/budi%40syns4033mail.dev"
Isi lengkap satu email (text + html).
OTP terbaru dari inbox.
curl "https://tempmail.syns4033.workers.dev/pub/otp/budi%40syns4033mail.dev"
# {"success":true,"data":{"found":true,"otp":"847291",...}}
Hapus semua email di satu alamat.
x-api-key: tmp_...Dapatkan key dari admin. Key bisa dibatasi ke domain tertentu.
Domain yang boleh dipakai key ini.
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}}
Daftar email. Alias: /api/inbox/:address.
Isi lengkap email.
OTP terbaru.
Bersihkan inbox.
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>.
Authorization: Bearer <ADMIN_TOKEN>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}
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"}
curl https://tempmail.syns4033.workers.dev/health