EventMedia Public & Partner API v1.0.0

Dokumentasi REST API EventMedia

Selamat datang di portal dokumentasi REST API EventMedia. API ini menyediakan akses terprogram ke seluruh katalog event Indonesia, direktori kota, kategori, tagar pencarian, artikel berita, pengajuan event publik, serta integrasi unggah file/poster langsung ke CDN.

Base URL Endpoint

https://eventmedia.my.id

Protokol & Format

HTTPS + JSON (UTF-8)

Autentikasi Publik

Bebas Tanpa Token API

CORS Support

Diizinkan (Cross-Origin)

Panduan Standar Pagination JSON

Semua endpoint koleksi data (seperti /api/events, /api/news, /api/categories, /api/cities, /api/tags) mengimplementasikan format pagination standar untuk memudahkan navigasi halaman pada aplikasi client:

Struktur Objek pagination di Respons JSON Standard Object

{
  "success": true,
  "data": [ /* Array item data */ ],
  "pagination": {
    "page": 1,          // Nomor halaman aktif (integer)
    "limit": 12,        // Jumlah item per halaman (integer)
    "total": 48,        // Total keseluruhan item yang sesuai (integer)
    "total_pages": 4,   // Total kalkulasi halaman (ceil(total / limit))
    "has_next": true,   // true jika ada halaman setelah ini
    "has_prev": false,  // true jika ada halaman sebelum ini
    "next_page": 2,     // Angka halaman berikutnya atau null
    "prev_page": null   // Angka halaman sebelumnya atau null
  }
}

Parameter Query Pagination:

page: integer, default = 1.
limit: integer, batas item (default 12 untuk event, 9 untuk artikel, 20 untuk kota/kategori, maksimum 100).

Format Respons & Kode Status HTTP

Seluruh respons mengembalikan format JSON yang konsisten. Jika terjadi kesalahan, status HTTP non-200 disertai pesan penjelasan di properti error.

Respons Sukses (200 / 201)

{
  "success": true,
  "data": [ ... ],
  "pagination": { ... }
}

Respons Error (400 / 401 / 404 / 500)

{
  "success": false,
  "error": "Pesan deskripsi kesalahan..."
}

Integrasi Upload Poster ke CDN (cfcdn.aksisoft.my.id)

Aplikasi menggunakan arsitektur AJAX upload langsung ke endpoint CDN https://cfcdn.aksisoft.my.id/index.php (atau via proxy lokal /api/upload). API mengembalikan objek dengan properti data.url yang dapat langsung disematkan sebagai poster_url event.

Perhatian Waktu Resolusi CDN: File yang baru diunggah membutuhkan waktu propagasi sekitar 5 hingga 10 detik di CDN sebelum file dapat diakses secara publik. Sistem menunggu 5 detik awal, kemudian memverifikasi ketersediaan file hingga detik ke-10 (via /api/check-file?url=...) sebelum memperbarui pratinjau gambar.

Contoh AJAX JavaScript (XMLHttpRequest) Upload File dengan Live Progress & Resolusi CDN:

const formData = new FormData();
formData.append('file', fileInput.files[0]);

// 1. Upload file dengan tracking progress (0 - 100%)
const uploadedData = await new Promise((resolve, reject) => {
  const xhr = new XMLHttpRequest();
  xhr.open('POST', 'https://cfcdn.aksisoft.my.id/index.php'); // atau proxy /api/upload
  xhr.upload.onprogress = (e) => {
    if (e.lengthComputable) {
      const percent = Math.round((e.loaded / e.total) * 100);
      console.log('Progress: ' + percent + '% (' + e.loaded + '/' + e.total + ' bytes)');
      // Update UI progress bar
    }
  };
  xhr.onload = () => xhr.status >= 200 && xhr.status < 300 
    ? resolve(JSON.parse(xhr.responseText)) 
    : reject(new Error('Upload gagal HTTP ' + xhr.status));
  xhr.onerror = () => reject(new Error('Koneksi terputus'));
  xhr.send(formData);
});

const uploadedImageUrl = uploadedData.data?.url || uploadedData.url;

// 2. Tunggu 5 - 10 detik masa resolusi CDN sebelum menampilkan preview
for (let s = 5; s >= 1; s--) {
  console.log('Menunggu resolusi CDN: ' + s + ' detik tersisa...');
  await new Promise(r => setTimeout(r, 1000));
}

// 3. Cek ketersediaan file di CDN
const checkRes = await fetch('/api/check-file?url=' + encodeURIComponent(uploadedImageUrl));
const checkData = await checkRes.json();
if (checkData.exists) {
  console.log('File siap digunakan:', uploadedImageUrl);
}

Katalog Lengkap Endpoint API

25 endpoints terdaftar

GET /api/events

Events

Daftar Event (dengan Pagination & Filter)

Mengambil daftar event aktif dan terverifikasi dengan dukungan pagination, pencarian teks lengkap, filter kategori, kota, tags, format (offline/online), harga (gratis/berbayar), dan pengurutan.

Parameter Permintaan

Parameter	Lokasi	Tipe	Wajib	Deskripsi
cursor	query	string	Tidak	String Base64 cursor untuk Keyset Pagination O(1) seek (direkomendasikan untuk infinite scroll & zero-offset Cloudflare D1 quota optimization).
page	query	integer	Tidak	Nomor halaman (mulai dari 1, digunakan jika cursor tidak disertakan).
limit	query	integer	Tidak	Jumlah event per halaman (max: 100).
q	query	string	Tidak	Kata kunci pencarian judul, deskripsi, atau organizer.
kategori	query	string	Tidak	Slug kategori event (contoh: "musik", "teknologi").
kota	query	string	Tidak	Slug kota pelaksanaan event (contoh: "jakarta", "surabaya").
tag	query	string	Tidak	Slug tag spesifik (contoh: "workshop", "festival").
format	query	string	Tidak	Format pelaksanaan event.
gratis	query	integer	Tidak	Filter event gratis (1 = gratis, 0 = berbayar).
sort	query	string	Tidak	Urutan hasil.

Contoh cURL

curl -X GET "https://eventmedia.my.id/api/events?page=1&limit=12" \
  -H "Accept: application/json"

Contoh Respons (200 OK)

{
  "success": true,
  "data": [
    {
      "id": "evt-a1b2c3d4",
      "title": "Tech In Motion Summit 2026",
      "slug": "tech-in-motion-summit-2026",
      "short_description": "Konferensi teknologi tahunan terbesar.",
      "poster_url": "https://young-unit-7407.wakeawakewik.workers.dev/example.png",
      "start_date": "2026-11-20",
      "end_date": "2026-11-21",
      "start_time": "09:00",
      "event_type": "offline",
      "venue_name": "Grand City Hall",
      "city_name": "Surabaya",
      "city_slug": "surabaya",
      "category_name": "Teknologi",
      "category_slug": "teknologi",
      "ticket_price_min": 75000,
      "ticket_price_max": 250000,
      "is_free": 0,
      "organizer_name": "DevHub Indonesia"
    }
  ],
  "next_cursor": "eyJpZCI6ImV2dC1hMWIyYzNkNCIsImNyZWF0ZWRfYXQiOiIyMDI2LTExLTIwIn0",
  "has_more": true,
  "pagination": {
    "page": 1,
    "limit": 12,
    "total": 42,
    "total_pages": 4,
    "has_next": true,
    "has_prev": false,
    "next_page": 2,
    "prev_page": null,
    "next_cursor": "eyJpZCI6ImV2dC1hMWIyYzNkNCIsImNyZWF0ZWRfYXQiOiIyMDI2LTExLTIwIn0",
    "has_more": true,
    "mode": "hybrid"
  }
}

Dokumentasi REST API EventMedia

Panduan Standar Pagination JSON

Format Respons & Kode Status HTTP

Integrasi Upload Poster ke CDN (cfcdn.aksisoft.my.id)

Katalog Lengkap Endpoint API

Daftar Event (dengan Pagination & Filter)

Detail Event Spesifik

Kirim Event Publik (Submission Form)

Daftar Kategori Event (dengan Pagination & Search)

Detail Kategori Spesifik

Daftar Kota Pelaksanaan (dengan Pagination & Search)

Detail Kota Spesifik

Daftar Tags / Topik (dengan Pagination & Search)

Daftar Artikel & Berita (dengan Pagination)

Detail Artikel Berita

Daftar Direktori Tempat & Vendor (dengan Filter & Pagination)

Detail Profil Direktori & Vendor

Daftar Kategori Direktori Tempat & Vendor

Pendaftaran Profil Usaha / Vendor Baru (Submission Form)

Upload Gambar / Poster ke Cloudflare CDN

Verifikasi Ketersediaan File di CDN (Pengecekan Resolusi)

Statistik Publik Platform

Pengaturan Publik Situs

Autentikasi Admin (Login)

Daftar Event Admin (Semua Status & Pending Moderasi)

Konfirmasi / Publikasikan Event Submission

Kelola Seluruh Direktori (Admin)

Tambah Direktori Vendor / Tempat Baru (Admin)

Perbarui Data Direktori (Admin)

Hapus Direktori (Admin)