API Documentation

Base URL

https://aksesemail.my.id/api

Semua endpoint menggunakan base URL ini. Prefix /api sudah termasuk.

Authentication

Endpoint terproteksi membutuhkan API Key via header X-API-Key. API Key didapat dari dashboard setelah mendaftar.

Endpoint publik (prefix /inbox) tidak membutuhkan API Key.

# Contoh request dengan API Key
curl -H "X-API-Key: ak_xxxxxxxxxxxxxxxxxx" \
     https://aksesemail.my.id/api/emails/user@aksesemail.my.id

⚠️ Jangan bagikan API Key kamu! Bersifat rahasia dan memberi akses penuh ke semua inbox kamu.

Email yang Dilindungi Password

Jika sebuah alamat diproteksi dengan password, endpoint /emails/* untuk alamat itu wajib menyertakan header X-Email-Password (di samping X-API-Key). Tanpa password yang benar, response 401 dengan requiresPassword: true.

curl -H "X-API-Key: ak_xxxxxxxxxxxxxxxxxx" \
     -H "X-Email-Password: passwordrahasia" \
     https://aksesemail.my.id/api/emails/user@aksesemail.my.id

Ringkasan Endpoint

Method	Endpoint	Auth	Deskripsi
GET	/emails/:address	API Key	Ambil semua email (isi lengkap)
GET	/emails/:address/:id	API Key	Ambil satu email by ID
DEL	/emails/:address/:id	API Key	Hapus satu email
GET	/inbox/:address	Publik	Daftar email (preview)
GET	/inbox/:address/:id	Publik	Isi lengkap satu email
DEL	/inbox/:address	Publik	Hapus semua email di inbox

GET/emails/:address

Ambil semua email ke alamat tertentu. Response menyertakan isi lengkap (plain text & HTML).

Gunakan untuk otomasi seperti mengambil kode OTP, link verifikasi, dll.

Contoh Request

curl -H "X-API-Key: ak_xxxxxxxxxxxxxxxxxx" \
     https://aksesemail.my.id/api/emails/user@aksesemail.my.id

Contoh Response (200 OK)

{
  "success": true,
  "emails": [
    {
      "id": "clxyz123abc",
      "from": "OpenAI <noreply@tm.openai.com>",
      "to": "user@aksesemail.my.id",
      "subject": "Your temporary ChatGPT verification code",
      "body": "Enter this code to continue:\n\n361259\n...",
      "text": "Enter this code to continue:\n\n361259\n...",
      "html": "<html>...</html>",
      "received_at": "2026-05-03T01:55:02.000Z"
    }
  ]
}

Deskripsi Field

Field	Tipe	Keterangan
id	string	ID unik email (untuk detail/hapus)
from	string	Pengirim, format `Nama <email>`
to	string	Penerima (sama dengan :address)
subject	string	Judul email
body	string	Isi plain text — OTP, link, teks utama
text	string	Alias dari `body`
html	string	Isi email format HTML lengkap
received_at	string	Waktu diterima (ISO 8601 UTC)

GET/emails/:address/:id

Ambil satu email spesifik berdasarkan ID dari endpoint list di atas.

Contoh Request

curl -H "X-API-Key: ak_xxxxxxxxxxxxxxxxxx" \
     https://aksesemail.my.id/api/emails/user@aksesemail.my.id/clxyz123abc

Response 200 / 404

{ "success": true, "email": { ... } }
{ "success": false, "error": "Email not found." }

DELETE/emails/:address/:id

Hapus satu email berdasarkan ID. Aksi ini tidak bisa dibatalkan.

curl -X DELETE \
     -H "X-API-Key: ak_xxxxxxxxxxxxxxxxxx" \
     https://aksesemail.my.id/api/emails/user@aksesemail.my.id/clxyz123abc

{ "success": true, "message": "Email deleted." }

GET/inbox/:address

Ambil daftar email masuk (preview saja).

⚠️ Tidak menyertakan isi email. Hanya preview 100 karakter. Untuk isi lengkap gunakan /emails/:address.

curl https://aksesemail.my.id/api/inbox/user@aksesemail.my.id

{
  "success": true,
  "emails": [
    {
      "id": "clxyz123abc",
      "from": "OpenAI <noreply@tm.openai.com>",
      "subject": "Your verification code",
      "preview": "Enter this temporary verification code to contin...",
      "received_at": "2026-05-03T01:55:02.000Z"
    }
  ]
}

GET/inbox/:address/:id

Ambil isi lengkap satu email (termasuk body & HTML). Dipakai UI saat membuka email.

curl https://aksesemail.my.id/api/inbox/user@aksesemail.my.id/clxyz123abc

DELETE/inbox/:address

Hapus semua email di inbox untuk alamat tertentu. Dipakai tombol "Hapus" di UI.

{ "success": true, "message": "Deleted 2 email(s).", "count": 2 }

Contoh Kode Lengkap

Mengambil semua email lalu mencetak subject + membaca OTP.

import requests, re

API_KEY = "ak_xxxxxxxxxxxxxxxxxx"
EMAIL   = "user@aksesemail.my.id"
BASE    = "https://aksesemail.my.id"

resp = requests.get(f"{BASE}/api/emails/{EMAIL}", headers={"X-API-Key": API_KEY}, timeout=30)
data = resp.json()
if not data["success"]:
    print("Gagal:", data.get("error")); exit()

for email in data["emails"]:
    print(f"--- {email['subject']} ---")
    match = re.search(r'\b(\d{6})\b', email['body'])
    if match: print("OTP :", match.group(1))

Error Responses

Semua error mengembalikan JSON dengan success: false dan error.

Status	Penyebab	Contoh
200	Sukses	{ "success": true, ... }
400	Format alamat email salah	"Invalid email address format."
401	API Key tidak ada / tidak valid	"Unauthorized."
401	Email dilindungi password, header `X-Email-Password` salah/kosong	{ "requiresPassword": true }
404	Email dengan ID tidak ditemukan	"Email not found."
429	Terlalu banyak request	"Too many requests."
500	Server error internal	"..."

Catatan Penting

•Email otomatis dihapus setelah 7 hari sejak diterima.
•Domain yang tersedia bisa dilihat di halaman utama.
•Field body & text berisi konten sama (plain text). html versi HTML.
•Endpoint /emails/ (API Key) = isi lengkap. /inbox/ (publik) = preview 100 karakter.
•Waktu (received_at) format ISO 8601 UTC.

Base URL

Authentication

Ringkasan Endpoint

Endpoint Terproteksi (Butuh API Key)

Contoh Request

Contoh Response (200 OK)

Deskripsi Field

Contoh Request

Response 200 / 404

Endpoint Publik (Tanpa API Key)

Contoh Kode Lengkap

Error Responses

Catatan Penting