🔌 API MyEmailPro

Integrasikan website/aplikasi anda terus dengan MyEmailPro — tambah subscriber secara automatik tanpa login dashboard!

🔑 Langkah 1: Dapatkan API Key

1. Log masuk → Tetapan → tab API
2. Copy API key anda (format: es_xxxxxxxxxxxx)

📡 Langkah 2: Hantar Request

Semua request ke:

https://mybelajar.my/api/v1/index.php?action=[ACTION]

Dan wajib sertakan header:

X-API-Key: es_key_anda_di_sini

📖 Rujukan Endpoint

1️⃣ Senarai Semua Lists

curl -H "X-API-Key: es_anda" \
     https://mybelajar.my/api/v1/index.php?action=lists

Response:

{
  "data": [
    {"id": 19, "name": "Senarai Utama", "subscriber_count": 30},
    {"id": 22, "name": "Pelanggan Premium", "subscriber_count": 12}
  ]
}

2️⃣ Senarai Subscriber

curl -H "X-API-Key: es_anda" \
     "https://mybelajar.my/api/v1/index.php?action=subscribers&list_id=19"

3️⃣ Tambah Subscriber ⭐ (Paling Popular)

curl -X POST https://mybelajar.my/api/v1/index.php?action=add_subscriber \
  -H "X-API-Key: es_anda" \
  -H "Content-Type: application/json" \
  -d '{"list_id": 19, "email": "pelanggan@contoh.com", "name": "Ali Bin Abu"}'

Response berjaya:

{
  "status": "pending_verification",
  "message": "Emel pengesahan dihantar (double opt-in)."
}

4️⃣ Statistik Akaun

curl -H "X-API-Key: es_anda" \
     https://mybelajar.my/api/v1/index.php?action=stats

💻 Contoh Integrasi: Form di Website Anda

Tampal ni di website anda — visitor daftar → terus masuk senarai MyEmailPro:

<form id="myForm">
  <input type="text" id="nama" placeholder="Nama" required>
  <input type="email" id="emel" placeholder="Emel" required>
  <button type="submit">Langgan!</button>
</form>

<script>
document.getElementById('myForm').addEventListener('submit', async (e) => {
  e.preventDefault();
  
  const res = await fetch('https://mybelajar.my/api/v1/index.php?action=add_subscriber', {
    method: 'POST',
    headers: {
      'X-API-Key': 'es_KEY_ANDA',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      list_id: 19,
      name: document.getElementById('nama').value,
      email: document.getElementById('emel').value
    })
  });
  
  const data = await res.json();
  if (data.status === 'pending_verification') {
    alert('Terima kasih! Semak emel anda untuk pengesahan.');
  } else {
    alert('Ralat: ' + (data.error || 'Sila cuba lagi'));
  }
});
</script>

📊 Kod Status Response

❓ Soalan Lazim API

Boleh guna API tanpa plan Business?

Tidak — sistem akan balas 403 dengan mesej "Akses API memerlukan plan Business".

Kalau API key bocor?

Segera pergi Tetapan → API → Jana Semula API Key. Key lama terus TIDAK SAH serta-merta.

Subscriber yang ditambah melalui API perlu verify?

Ya! Double opt-in dikekalkan — mereka akan menerima emel pengesahan seperti biasa. Ini melindungi reputasi domain anda.

Ada rate limit?

Sistem menyemak kuota plan anda. Untuk penggunaan berat (ribuan request), hubungi kami untuk arrangement khas.