CCTVGateway

Dokumentasi API

Gateway publik untuk stream CCTV pemerintah Indonesia. Semua endpoint bersifat baca-saja, tanpa autentikasi, dan mengembalikan JSON.

Base URL:

https://cctv-gateway.bangnaja300.workers.dev

Ringkasan endpoint

MethodPathKeterangan
GET/api/healthHeartbeat Worker.
GET/api/statsAgregat katalog: jumlah kamera, host, kind, mode.
GET/api/catalogDaftar kamera dengan filter dan paginasi.
GET/api/catalog/providersDaftar provider dan kota beserta jumlahnya.
GET/api/resolve/:idSatu kamera → URL yang bisa diputar.
GET/api/resolve?ids=a,b,cBatch resolve, maksimal 64 id.
GET/api/whep/:idMetadata endpoint WebRTC (WHEP).
POST/api/whep/sdpRelay SDP offer → answer (balasan SDP, bukan JSON).
GET/registry/cameras.jsonAset statis seluruh katalog, bentuk kompak.

Model playback

Gateway ini hybrid: video hanya melewati server bila operator memang memblokir akses langsung. Field via menjelaskan caranya.

viaArtiYang harus dilakukan klien
upstreamOperator mengizinkan CORS.Putar url langsung.
relayOperator tanpa CORS / butuh Referer.Putar url (sudah ditandatangani HMAC, berlaku sebagai relay).
embedYouTube atau halaman embed.Tampilkan url di dalam <iframe>.

Endpoint

GET /api/health

curl https://cctv-gateway.bangnaja300.workers.dev/api/health
{
  "ok": true,
  "service": "cctv-gateway",
  "time": "2026-11-18T03:22:22.513Z"
}

GET /api/stats

curl https://cctv-gateway.bangnaja300.workers.dev/api/stats
{
  "cameras": 9495,
  "playable": 9495,
  "hosts": 587,
  "byKind": { "hls": 9063, "whep": 33, "mp4": 10, "youtube": 140, "embed": 249 },
  "byMode": { "dead": 2928, "native": 6279, "embed": 172, "proxy": 116 },
  "generatedAt": "2026-11-11T10:42:08.354Z"
}

generatedAt adalah waktu build katalog, bukan waktu request. Endpoint ini paling murah untuk monitoring.

GET /api/catalog

Semua parameter opsional dan bisa dikombinasikan.

ParameterDefaultKeterangan
q—Cari di nama, tempat, kota, provinsi, provider.
provider—Cocok persis dengan pr.
city—Cocok persis dengan c.
kind—hls, whep, mp4, youtube, embed.
bbox—minLng,minLat,maxLng,maxLat.
limit5000Maksimum 20000.
offset0Untuk paginasi.
offline01 menyertakan kamera yang host-nya mati.
curl "https://cctv-gateway.bangnaja300.workers.dev/api/catalog?q=cianjur&kind=hls&limit=2"
{
  "total": 63,
  "offset": 0,
  "limit": 2,
  "generatedAt": "2026-11-11T10:42:08.354Z",
  "cameras": [
    {
      "id": "original-cianjur-2",
      "n": "Ruas Jl. Abdullah Bin Nuh-2",
      "la": -6.8271,
      "ln": 107.1398,
      "c": "Kabupaten Cianjur",
      "p": "Jawa Barat",
      "pr": "cianjur",
      "k": "hls",
      "m": "native"
    }
  ]
}
Catatan: total menghitung hasil setelah filter. Tanpa offline=1 kamera dead disembunyikan, jadi totalnya lebih kecil daripada /api/stats.

GET /api/catalog/providers

curl https://cctv-gateway.bangnaja300.workers.dev/api/catalog/providers
{
  "providers": [
    { "name": "unknown", "cameras": 5956 },
    { "name": "pelindung-bandung", "cameras": 430 },
    { "name": "pantausemar-semarang", "cameras": 77 }
  ],
  "cities": ["Kota Bandung", "Kota Semarang", "Kabupaten Cianjur"]
}

Daftar cities berguna untuk mengisi dropdown kota di frontend.

GET /api/resolve/:id

curl https://cctv-gateway.bangnaja300.workers.dev/api/resolve/original-cianjur-2
{
  "id": "original-cianjur-2",
  "kind": "hls",
  "mode": "native",
  "name": "Ruas Jl. Abdullah Bin Nuh-2",
  "sourceName": "cianjur",
  "sourceUrl": "https://atcs.cianjurkab.go.id:5443/",
  "url": "https://atcs.cianjurkab.go.id:5443/LieApp/streams/VID2RuasJlAbdullahBinNuh.m3u8",
  "via": "upstream"
}

Kamera proxy mengembalikan URL relay yang sudah ditandatangani:

{
  "id": "original-garut-22",
  "mode": "proxy",
  "url": "https://cctv-gateway.bangnaja300.workers.dev/s/eyJ1IjoiaHR0cHM6...",
  "via": "relay"
}

Id yang tidak dikenal dibalas 404 dengan body JSON {"error":"camera not found"}.

GET /api/resolve?ids=a,b,c

Satu request untuk banyak kamera, maksimal 64 id. Urutan hasil dijamin sama dengan urutan permintaan, dan satu id yang gagal tidak menggagalkan yang lain.

curl "https://cctv-gateway.bangnaja300.workers.dev/api/resolve?ids=original-cianjur-2,does-not-exist"
{
  "count": 2,
  "results": [
    { "id": "original-cianjur-2", "kind": "hls", "mode": "native", "url": "https://...", "via": "upstream" },
    { "id": "does-not-exist", "error": "camera not found" }
  ]
}

GET /api/whep/:id

Metadata untuk kamera WebRTC. Media mengalir peer-to-peer, jadi gateway hanya memberi tahu endpoint mana yang harus dihubungi.

{
  "id": "...",
  "kind": "whep",
  "mode": "native",
  "endpoint": "https://operator.example/whep",
  "via": "direct"
}

POST /api/whep/sdp

Relay pertukaran SDP untuk operator yang tidak mengirim header CORS.

curl -X POST https://cctv-gateway.bangnaja300.workers.dev/api/whep/sdp \
  -H 'Content-Type: application/json' \
  -d '{"id":"<camera-id>","sdp":"v=0\r\no=- ..."}'

Balasannya bukan JSON: SDP answer verbatim dari kamera, siap dimasukkan ke setRemoteDescription().

GET /registry/cameras.json

Seluruh katalog sebagai aset statis (3,7 MB) yang dilayani langsung dari edge, tanpa melewati Worker. Bentuknya kompak:

{
  "g": "2026-11-11T10:42:08.354Z",
  "n": 9495,
  "c": [
    { "id": "original-cianjur-2", "n": "Ruas Jl. Abdullah Bin Nuh-2", "u": "https://...m3u8",
      "k": "hls", "m": "native", "la": -6.8271, "ln": 107.1398, "c": "Kabupaten Cianjur", "p": "Jawa Barat", "pr": "cianjur" }
  ]
}

Kalau butuh field yang sudah panjang, pakai /api/catalog.

Legenda field

Field ringkasArtiField lengkap (resolve)
idId kamera, stabil.id
nNama lokasi.name
u / urlURL upstream (belum ditandatangani).url (sudah playable)
kJenis stream.kind
mMode relay.mode
la / lnLatitude / longitude.—
c / pKota / provinsi.—
prProvider.—
sn / suNama & URL sumber resmi.sourceName / sourceUrl
plAlamat/place.—

Batas & CORS

Update data

Tidak ada endpoint untuk memperbarui katalog. Data adalah aset statis yang ikut ter-upload saat deploy, jadi pembaruan berarti build ulang lalu deploy:

./deploy.sh            # probe penuh 587 host + build + deploy (±6–10 menit)
./deploy.sh --skip-probe   # pakai verdict host lama, probe host baru saja (cepat)
./deploy.sh --no-build     # deploy ulang tanpa rebuild

--skip-probe membaca data/hosts.json dan hanya mem-probe host yang belum punya verdict, sehingga kamera proxy dan dead tetap akurat.

Sumber data

Katalog dibangun dari inventaris milik operator sendiri, bukan dari layanan pihak ketiga. Endpoint yang diekstrak saat build antara lain: