🔧 Temp Mail API - Full Docs

GET/domains

List semua domain aktif. Dipakai untuk dropdown di dashboard.

curl -X GET "{HOST}/domains"

Response: hydra:member array {domain, id, isActive}

POST/accounts

Buat akun / email baru. Harus unik, kalau sudah ada return 409.

curl -X POST "{HOST}/accounts" \
  -H "Content-Type: application/json" \
  -d '{"address":"test123@badut.biz.id","password":"Password123!"}'

POST/token

curl -X POST "{HOST}/token" \
  -H "Content-Type: application/json" \
  -d '{"address":"test123@badut.biz.id","password":"Password123!"}'

GET/messages

List 20 email masuk terbaru. Butuh header Authorization.

curl -X GET "{HOST}/messages" \
  -H "Authorization: Bearer TOKEN_KAMU"

Field penting: otpCode (auto deteksi), intro, seen

GET/messages/:id

Baca 1 email lengkap + HTML + OTP + verificationLinks. Auto mark seen=1.

curl -X GET "{HOST}/messages/abc123def456" \
  -H "Authorization: Bearer TOKEN_KAMU"

DELETE/messages/:id

Hapus email (soft delete, is_deleted=1).

curl -X DELETE "{HOST}/messages/abc123def456" \
  -H "Authorization: Bearer TOKEN_KAMU"

GET/me

Cek info akun sendiri, quota & expiry.

curl -X GET "{HOST}/me" \
  -H "Authorization: Bearer TOKEN_KAMU"

POST/receive

Endpoint untuk forward email masuk dari Email Routing / webhook. Format: {"to","from","subject","text","html"}

curl -X POST "{HOST}/receive" \
  -H "Content-Type: application/json" \
  -d '{"to":"test@badut.biz.id","from":"noreply@google.com","subject":"OTP","text":"Your code is 123456"}'

GET/events

Server-Sent Events (SSE) untuk notifikasi realtime. Dipakai dashboard untuk auto-refresh.

GET /events?token=xxx (EventStream)