Sites

Pengenalan

Sites adalah unit pengelompokan logis yang merepresentasikan lokasi atau area fisik di dunia nyata — mulai dari gedung, lantai, hingga ruangan tertentu. Dengan Sites, operator dapat mengorganisasi stream kamera berdasarkan lokasi sehingga pemantauan menjadi lebih terstruktur dan mudah dinavigasi.

Setiap Site dapat memiliki parent site, membentuk hierarki yang mencerminkan struktur fisik lokasi Anda. Sistem mendukung hingga tiga level kedalaman: top-level (misalnya gedung), child (misalnya lantai), dan grandchild (misalnya ruangan). Stream kemudian ditetapkan ke site spesifik — terutama ke node daun (leaf) pada hierarki — agar dapat ditampilkan dan difilter secara terkelompok.

Bagi integrator, semua operasi Sites tersedia melalui REST API. Endpoint Sites mendukung Federation Mode untuk deployment multi-instance, pembaruan batch, penetapan stream, serta pengurutan stream per site. Site diidentifikasi secara unik oleh id (integer) yang bersifat permanen setelah site dibuat.

Cara Menggunakan

Melihat Daftar Site

Menambah Site Baru

Mengedit Site

Menambah Child Site

Untuk membuat sub-site langsung di bawah site tertentu, klik tombol Tambah Child pada baris site yang diinginkan di tree view. Form yang muncul akan otomatis menetapkan site tersebut sebagai parent — Anda hanya perlu mengisi nama child site yang baru.

Menghapus Site

Hierarki Site

Sites mendukung struktur pohon (tree) yang merepresentasikan lokasi fisik secara bertingkat. Berikut contoh struktur hierarki tipikal untuk sebuah kompleks perkantoran:

Pada struktur di atas:

• Gedung Utama dan Gedung Annex adalah top-level site (tanpa parent).
• Lantai 1, Lantai 2, Lantai 3 adalah child site di bawah Gedung Utama.
• Lobby Depan, Ruang Rapat A, dst. adalah grandchild site (level terdalam).
• Stream kamera biasanya ditetapkan ke grandchild site — lokasi paling spesifik.

Pada tampilan Stream berdasarkan Site (/streams/site), stream dari child site secara otomatis rolled up ke tampilan parent site — sehingga operator yang memantau "Lantai 1" dapat melihat seluruh stream dari semua ruangan di lantai tersebut.

Fitur Utama

API Reference

Semua endpoint memerlukan header Authorization: Bearer <token>. Lihat Otentikasi untuk cara mendapatkan token.

GET /api/sites

Mengambil seluruh site yang dapat diakses oleh pengguna yang sedang login.

curl -X GET "${RAISA_API_URL}/api/sites" \
  -H "Authorization: Bearer <token>"

Contoh respons:

{
  "ok": true,
  "message": "success",
  "sites": [
    {
      "id": 1,
      "name": "Gedung Utama",
      "parent_id": null,
      "order": 0,
      "created_at": "2025-01-15T08:00:00Z",
      "created_by": 10,
      "updated_at": "2025-01-15T08:00:00Z",
      "instance": "local"
    },
    {
      "id": 2,
      "name": "Lantai 1",
      "parent_id": 1,
      "order": 0,
      "created_at": "2025-01-15T08:05:00Z",
      "created_by": 10,
      "updated_at": "2025-01-15T08:05:00Z",
      "instance": "local"
    },
    {
      "id": 3,
      "name": "Lobby Depan",
      "parent_id": 2,
      "order": 0,
      "created_at": "2025-01-15T08:10:00Z",
      "created_by": 10,
      "updated_at": "2025-01-15T08:10:00Z",
      "instance": "local"
    }
  ]
}

Respons berisi seluruh site dalam satu array datar. Rekonstruksi pohon hierarki dilakukan di sisi klien menggunakan field parent_id.

POST /api/sites — Tambah Site

Membuat site baru.

curl -X POST "${RAISA_API_URL}/api/sites" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Lantai 1",
    "parent_id": 1
  }'

Contoh respons:

{
  "ok": true,
  "message": "success",
  "site": {
    "id": 2,
    "name": "Lantai 1",
    "parent_id": 1,
    "order": 0,
    "created_at": "2025-01-15T08:05:00Z",
    "created_by": 10,
    "updated_at": "2025-01-15T08:05:00Z"
  }
}

PUT /api/sites/:id — Perbarui Site

Memperbarui nama dan/atau parent site yang sudah ada.

curl -X PUT "${RAISA_API_URL}/api/sites/2" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Lantai 1 (Revisi)",
    "parent_id": 1
  }'

DELETE /api/sites/:id

Menghapus site secara permanen. Child site langsung dari site yang dihapus akan dipindahkan ke level root. Penetapan stream ke site ini akan dihapus.

curl -X DELETE "${RAISA_API_URL}/api/sites/3" \
  -H "Authorization: Bearer <token>"

Respons sukses:

{
  "ok": true,
  "message": "Site berhasil dihapus"
}

PATCH /api/sites/batch — Pembaruan Batch

Memperbarui beberapa site sekaligus dalam satu request — berguna untuk reorganisasi hierarki skala besar atau pembaruan urutan massal.

Setiap item dalam array sites:

curl -X PATCH "${RAISA_API_URL}/api/sites/batch" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "sites": [
      { "id": 2, "order": 0 },
      { "id": 4, "order": 1 },
      { "id": 5, "parent_id": 2, "order": 0 }
    ]
  }'

POST /api/sites/:id/assign-stream

Menetapkan satu stream ke site tertentu.

curl -X POST "${RAISA_API_URL}/api/sites/3/assign-stream" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "stream_id": "abc123"
  }'

PUT /api/sites/:id/streams/order — Atur Urutan Stream

Mengatur ulang urutan stream di dalam site tertentu.

curl -X PUT "${RAISA_API_URL}/api/sites/3/streams/order" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "stream_ids": ["abc123", "def456", "ghi789"]
  }'

Membuat Hierarki via Stream API

Selain endpoint Sites, Anda juga dapat membuat hierarki site secara otomatis saat mendaftarkan stream baru menggunakan sintaks path pada field sites di Stream API:

{
  "stream_name": "Kamera Lobby",
  "stream_address": "rtsp://192.168.1.100/stream1",
  "sites": [
    "Gedung A/Lantai 1/Lobby Utama",
    "Gedung A/Lantai 1/Area Resepsi"
  ]
}

Sistem akan membuat site Gedung A → Lantai 1 → Lobby Utama (dan Area Resepsi) secara otomatis jika belum ada, kemudian menetapkan stream ke node daun (leaf). Site yang sudah ada akan digunakan ulang tanpa duplikasi.

Tips & Troubleshooting

Selanjutnya