▶

ShortDrama ID • Developer API

Dokumentasi REST API & Panduan Integrasi

🎬 Web Player ⚙️ Dashboard Admin

📌 Ringkasan API

ShortDrama ID API adalah REST API seragam untuk mengakses katalog, pencarian, dan seluruh tautan video *short drama* vertikal berkualitas HD dari platform utama (seperti DramaBox dan ShortMax) dalam format Bahasa Indonesia (Sub Indo & Dubbing Indo).

Format Respon JSON (UTF-8)
Format Video MP4 & HLS (.m3u8)
Resolusi Video 720p / 1080p / 480p
Bahasa Indonesia (id / in)

🔑 Autentikasi (Header)

Sertakan API Key yang sudah dibuat oleh admin pada header permintaan HTTP X-API-Key atau parameter URL ?apiKey=KODE_KEY. 

curl -H "X-API-Key: SD-YOUR-API-KEY" "http://localhost:3000/api/list?platform=dramabox"

💰 Integrasi Monetisasi (Linkcash / Pay-Per-View)

Anda dapat memonetisasi web atau API ini menggunakan sistem Linkcash dengan 2 skema:

  1. Kunci Episode Lanjutan (Episode 10+): Pengunjung gratis menonton episode 1–9. Untuk episode 10 ke atas, pasang tombol "Buka Kunci Episode Lewat Linkcash" yang mengarahkan pengunjung ke shortlink monetisasi Anda.
  2. Jual Kunci Langganan API: Jual token API Key berkuota (misal Rp20.000 / 1.000 request) yang dibayar melalui sistem pembayaran Linkcash Anda.

📡 Spesifikasi Endpoint

GET /api/list
Ambil Katalog Drama Populer
Parameter Query:
  • platform (opsional): dramabox (default) atau shortmax.
  • tab (opsional): Untuk dramabox (trending, dubbed, latest, foryou). Untuk shortmax (popular, hot, new).
  • page (opsional): Nomor halaman (default: 1).
// Contoh Respon:
{
  "success": true,
  "cached": true,
  "platform": "dramabox",
  "items": [
    {
      "id": "42000024252",
      "title": "Sistem Super dan Tiga Primadona (Sulih Suara)",
      "cover": "https://hwztchapter.dramaboxdb.com/...jpg",
      "episodesCount": 54,
      "synopsis": "Mike hanya mahasiswa miskin...",
      "tags": ["Harem", "Sistem", "Romansa Kampus"],
      "platform": "dramabox"
    }
  ]
}
GET /api/drama
Detail & Daftar Seluruh Episode + Link Video
Parameter Query:
  • id (wajib): ID drama (contoh: 42000024252 atau 762940).
  • platform (wajib): dramabox atau shortmax.
// Contoh Respon:
{
  "success": true,
  "drama": {
    "id": "42000024252",
    "totalEpisodes": 54,
    "platform": "dramabox",
    "episodes": [
      {
        "number": 1,
        "title": "EP 1",
        "videoUrl": "https://hwztakavideoto.dramaboxdb.com/.../701457372.720p.narrowv3.mp4",
        "isHls": false,
        "qualities": {
          "720p": "https://hwztakavideoto.dramaboxdb.com/.../701457372.720p.narrowv3.mp4",
          "540p": "https://hwztakavideoto.dramaboxdb.com/.../701457372.540p.narrowv3.mp4"
        }
      }
    ]
  }
}
GET /api/proxy/m3u8?url=...
Stream Proxy HLS (Bypass CORS)

Digunakan untuk memutar video HLS ShortMax di browser web tanpa terblokir proteksi CORS Akamai.