📡 Dokumentasi API

Integrasikan layanan email sementara ke aplikasi Anda dengan API sederhana kami.

https://heemail.biz.id/api
🌐 List Domains
✉️ Create Email
🔍 Check Username
📥 Cek Inbox
📨 Baca Pesan
GET /api/domains Daftar domain yang tersedia

Parameter

Tidak memerlukan parameter.

Response

FieldTipeKeterangan
domainsarrayDaftar domain aktif
{
  "domains": [
    "heemail.biz.id",
    "koremail.biz.id"
  ]
}

🧪 Coba Langsung


          

        

      

    

  


  
  

    

      POST
      /api/create-email
      Buat alamat email sementara
    

    

      

        
Request Body (JSON)

        

          
FieldWajibKeterangan

          
usernameopsionalUsername email (3-50 karakter). Jika kosong, akan di-generate otomatis.

          
domainopsionalDomain tujuan. Default: domain pertama yang tersedia.

        

        
Response

        

          
{
  "success": true,
  "email": "user@heemail.biz.id",
  "username": "user",
  "domain": "heemail.biz.id"
}

        

      

      

        

          
🧪 Coba Langsung

          
          
          
          

            

            

          

        

      

    

  


  
  

    

      GET
      /api/check-username
      Cek ketersediaan username
    

    

      

        
Query Parameter

        

          
FieldWajibKeterangan

          
usernamewajibUsername yang ingin dicek

          
domainopsionalDomain yang diinginkan

        

        
Response

        

          
{
  "available": true
}
// atau jika tidak tersedia:
{
  "available": false,
  "reason": "invalid" // atau "blacklisted"
}

        

      

      

        

          
🧪 Coba Langsung

          
          
          

            

            

          

        

      

    

  


  
  

    

      GET
      /api/get-inbox
      Ambil daftar email masuk
    

    

      

        
Query Parameter

        

          
FieldWajibKeterangan

          
emailwajibAlamat email lengkap yang ingin dicek inboxnya

        

        
Response

        

          
{
  "success": true,
  "count": 2,
  "messages": [
    {
      "id": 42,
      "sender_email": "noreply@example.com",
      "sender_name": "Example",
      "subject": "Verifikasi Email",
      "is_read": 0,
      "time_ago": "2 menit lalu",
      "received_at": "08 Apr 2026 15:44"
    }
  ]
}

        

      

      

        

          
🧪 Coba Langsung

          
          
          

            

            

          

        

      

    

  


  
  

    

      GET
      /api/get-message
      Baca isi pesan berdasarkan ID
    

    

      

        
Query Parameter

        

          
FieldWajibKeterangan

          
idwajibID pesan (dari response get-inbox)

          
emailwajibEmail pemilik pesan (untuk verifikasi)

        

        
Response

        

          
{
  "success": true,
  "message": {
    "id": 42,
    "recipient_email": "user@heemail.biz.id",
    "sender_email": "noreply@example.com",
    "sender_name": "Example",
    "subject": "Verifikasi Email",
    "body_text": "Kode verifikasi Anda: 123456",
    "body_html": "
Kode: 123456
",
    "received_at": "08 Apr 2026 15:44"
  }
}

        

      

      

        

          
🧪 Coba Langsung

          
          
          
          

            

            

          

        

      

    

  


  
  

    💡 Catatan Penting:
    Semua endpoint mengembalikan Content-Type: application/json.
    Rate limit berlaku untuk pembuatan email (maksimal per IP per jam). Email yang dibuat akan otomatis tersedia untuk cek inbox.