API Documentation

Integrasikan layanan Temporary Mail ke dalam aplikasi Anda dengan cepat. Gunakan endpoint di bawah ini untuk mengelola mailbox virtual.

Base URL Production

https://services.my-playground.space
Get

Generate Address

Membuat alamat email sementara baru dengan domain unik @my-playground.space.

/api/v1/temp-mail/generate 
{
  "address": "a1b2c3d4@my-playground.space"
}
Get

Get Inbox

Mengambil daftar ringkasan email yang masuk ke mailbox tertentu.

/api/v1/temp-mail/inbox/{address} 
[
  {
    "id": "1",
    "from": "sender@example.com",
    "subject": "Hello World",
    "date": "2026-01-11T05:41:37Z",
    "seen": false
  }
]
Get

Read Message

Mengambil konten lengkap pesan termasuk format Text dan HTML berdasarkan ID pesan.

/api/v1/temp-mail/message/{address}/{id} 
{
  "id": "1",
  "from": "sender@example.com",
  "subject": "Hello World",
  "body": {
    "text": "Konten teks biasa...",
    "html": "<div>Konten HTML...</div>"
  },
  "attachments": [
    {
      "filename": "image.png",
      "content-type": "image/png",
      "download-link": "https://services.my-playground.space/serve/..../image.png",
      "view-link": "https://services.my-playground.space/serve/..../image.png",
      "md5": "cd3a764f7c846c0..."
    }
  ]
}
Delete

Delete Message

Menghapus email tertentu dari server secara permanen.

/api/v1/temp-mail/message/{address}/{id} 
{
  "message": "Email berhasil dihapus"
}

File Handling

Setiap file lampiran menyertakan download-link. Melalui link ini, Anda dapat mengakses file mentah secara langsung. Jika file adalah gambar, gunakan view-link untuk keperluan render thumbnail atau gallery.

  • Download link → Tautan unduhan tersedia untuk mendapatkan file mentah secara langsung.
  • View link (gambar) → Jika file berupa gambar, tersedia tautan view untuk menampilkan thumbnail atau galeri pratinjau.
  • Keamanan akses → Semua file dilayani melalui koneksi HTTPS sehingga tetap aman saat diakses.
  • Header Content-Type → File dikirim dengan Content-Type sesuai format aslinya, memastikan aplikasi dapat mengenali file dengan benar.

Quick Start

Terminal — cURL 
# Generate email address
curl https://services.my-playground.space/api/v1/temp-mail/generate