API ONLINE v3.0

One gateway.
Every short drama.

API Native untuk katalog, detail episode, dan playback dari beberapa provider drama resmi. Terukur, terotorisasi, dan siap dipanggil dari AfiskaAI.

Mulai integrasi ↓Lihat Player ↗

REQUEST PREVIEW● LIVE

GET/dramabox/foryou?page=1

{"success": true,"platform": "dramabox","data": [ ... ]}

200 OKJSON · ~120 ms

BASE URLhttps://cdn.defiska.com

AUTHENTICATIONx-api-key: <license-key>

FORMATapplication/json

QUICK START

Mulai dalam satu request.

License key hanya disimpan di server pemanggil.

AutentikasiKirim salah satu header berikut pada setiap request eksternal.

x-api-key: <license-key>

Authorization: Bearer <license-key>

Jangan menaruh license key di frontend publik, browser, atau repository.

Request pertamaContoh endpoint rekomendasi DramaBox.

curl "https://cdn.defiska.com/dramabox/foryou?page=1&pageSize=18" \
  -H "x-api-key: $DRAMAHUB_LICENSE_KEY"

Response berupa JSON dengan envelope success, platform, dan data.

SUPPORTED PROVIDERS

Satu kontrak untuk banyak sumber.

Gunakan nilai platform pada path endpoint.

◈

DramaBoxKatalog dan playback multi-kualitas

dramabox

◈

PineDramaMini drama global dan subtitle

pinedrama

◈

ShortMaxDrama vertikal dan episode pendek

shortmax

◈

ReelShortKatalog short drama eksklusif

reelshort

◈

GoodShortDrama pendek dan sulih suara

goodshort

◈

NetShortKatalog drama vertikal

netshort

◈

FreeReelsKatalog global dan HLS

freereels

◈

FlickReelsShortPlay dan originals

flickreels

API REFERENCE

Endpoint yang tersedia.

Semua request eksternal memakai license key.

System & metadataStatus gateway, provider, dan operasi playback yang terotorisasi.

GET/healthHealth gateway dan status provider

GET/platformsDaftar provider yang terdaftar

GET/{platform}/decrypt?bookId=...&chapterId=...Resolve stream

GET/{platform}/refreshRefresh session provider

Discovery & katalogAmbil daftar drama, kategori, pencarian, dan detail episode.

GET/{platform}/categoriesKategori provider

GET/{platform}/foryouRekomendasi utama

GET/{platform}/trendingDrama populer

GET/{platform}/latestRilis terbaru

GET/{platform}/randomdramaDrama acak

GET/{platform}/dubindoDrama sulih suara Indonesia

GET/{platform}/vipKatalog VIP

GET/{platform}/search?keyword=CEOPencarian drama

GET/{platform}/populersearchKata kunci populer

GET/{platform}/detail?bookId=...Detail drama

GET/{platform}/get-allepisode?bookId=...Daftar episode

GET/{platform}/get-episode?bookId=...Episode terpilih

REQUEST CONTRACT

Parameter umum.

Provider dapat memiliki parameter tambahan.

Query parametersGunakan sesuai endpoint yang dipanggil.

pageinteger1Nomor halaman katalog.

pageSizeinteger18Jumlah item per halaman.

keywordstring—Kata kunci untuk endpoint search.

bookIdstring—ID drama untuk detail dan episode.

chapterIdstring—ID episode untuk resolve stream.

indexinteger0Index episode yang diminta.

qualitystring720pPilihan resolusi bila didukung provider.

langstringidBahasa subtitle/session provider.

Response exampleEnvelope sukses yang umum.

{
  "success": true,
  "code": 200,
  "platform": "dramabox",
  "page": 1,
  "pageSize": 18,
  "hasMore": true,
  "data": [
    { "bookId": "...", "bookName": "...", "cover": "..." }
  ]
}

Field detail dapat berbeda sesuai provider.

ERRORS & LIMITS

Response yang perlu ditangani.

Gunakan retry dengan exponential backoff untuk 429 dan 5xx.

HTTPSTATUSMEANING

200OKRequest berhasil.

400Bad RequestParameter wajib tidak ada atau format tidak valid.

401API Key RequiredHeader license belum dikirim.

403ForbiddenLicense tidak aktif atau scope tidak mengizinkan resource.

404Not FoundProvider, route, atau drama tidak ditemukan.

429Rate LimitedBatas request per menit tercapai.

500/502Upstream ErrorProvider gagal atau tidak tersedia; retry dengan backoff.

RATE LIMIT

Limit request mengikuti konfigurasi license pada gateway. Nilai `rateLimit = 0` berarti unlimited untuk license yang diizinkan; tetap gunakan concurrency yang wajar dan cache di sisi aplikasi.