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.devRingkasan endpoint
| Method | Path | Keterangan |
|---|---|---|
| GET | /api/health | Heartbeat Worker. |
| GET | /api/stats | Agregat katalog: jumlah kamera, host, kind, mode. |
| GET | /api/catalog | Daftar kamera dengan filter dan paginasi. |
| GET | /api/catalog/providers | Daftar provider dan kota beserta jumlahnya. |
| GET | /api/resolve/:id | Satu kamera → URL yang bisa diputar. |
| GET | /api/resolve?ids=a,b,c | Batch resolve, maksimal 64 id. |
| GET | /api/whep/:id | Metadata endpoint WebRTC (WHEP). |
| POST | /api/whep/sdp | Relay SDP offer → answer (balasan SDP, bukan JSON). |
| GET | /registry/cameras.json | Aset statis seluruh katalog, bentuk kompak. |
Model playback
Gateway ini hybrid: video hanya melewati server bila operator memang
memblokir akses langsung. Field via menjelaskan caranya.
via | Arti | Yang harus dilakukan klien |
|---|---|---|
upstream | Operator mengizinkan CORS. | Putar url langsung. |
relay | Operator tanpa CORS / butuh Referer. | Putar url (sudah ditandatangani HMAC, berlaku sebagai relay). |
embed | YouTube 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.
| Parameter | Default | Keterangan |
|---|---|---|
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. |
limit | 5000 | Maksimum 20000. |
offset | 0 | Untuk paginasi. |
offline | 0 | 1 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"
}
]
}
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 ringkas | Arti | Field lengkap (resolve) |
|---|---|---|
id | Id kamera, stabil. | id |
n | Nama lokasi. | name |
u / url | URL upstream (belum ditandatangani). | url (sudah playable) |
k | Jenis stream. | kind |
m | Mode relay. | mode |
la / ln | Latitude / longitude. | — |
c / p | Kota / provinsi. | — |
pr | Provider. | — |
sn / su | Nama & URL sumber resmi. | sourceName / sourceUrl |
pl | Alamat/place. | — |
Batas & CORS
- CORS terbuka.
Access-Control-Allow-OriginmemantulkanOriginpemanggil, dan preflightOPTIONSdijawab204. Bisa dipanggil dari domain mana pun. - Tanpa API key. Yang dilindungi HMAC hanya URL relay
/s/…. - Tanpa cache di
/api/*; aset registry memakaimax-age=0, must-revalidatesehingga selalu segar setelah reload. - Error juga JSON:
{"error":"…"}dengan status404atau500.
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:
pelindung.bandung.go.id:8443/api/cek— PELINDUNG Kota Bandungpantausemar.semarangkota.go.id— Diskominfo Kota Semarang- API katalog pemerintah daerah lain yang dipublikasikan terbuka