Api Reference

All endpoints are on the running camera app (http://<host>:8000), not the portal. Everything is GET with query params, except the video stream.

Stream & Status

Endpoint	Description
`GET /api/stream`	MJPEG video stream (`multipart/x-mixed-replace`)
`GET /api/status`	`{status, is_running, mode, config, error}` - `status` is `connected` / `stopped` / `error`
`GET /api/stats`	`{fps, detections_count, entry_count, exit_count, current_occupancy, people_in_area, daily_date}`

Endpoint	Params	Description
`GET /api/start_camera`	-	Start the pipeline
`GET /api/stop_camera`	-	Stop the pipeline (watchdog won't auto-restart while intentionally stopped)
`GET /api/set_mode`	`mode` = `preview` \| `yolov6` \| `tracking` \| `yunet` \| `edges`	Switch detection mode (restarts the pipeline, ~1.2s)

Endpoint	Params	Description
`GET /api/set_config`	`key`, `value`	Detection settings: `confidence`, `filter_mode` (`exclude`/`include`), `filter_classes` (comma-separated), `boundary_line_type` (`vertical`/`horizontal`), `boundary_line_pos` (0-1), `boundary_direction` (`normal`/anything else = reversed)
`GET /api/set_camera`	`key`, `value`	Camera hardware settings: `brightness`, `contrast`, `saturation`, `auto_exposure`, `exposure_time`, `iso`, `auto_focus`, `focus_lens`
`GET /api/reset_counters`	-	Zeroes today's in/out counts (persisted to `data/daily_counts.json`)

Endpoint	Params	Description
`GET /api/add_zone`	`name`	Add a detection zone (default box, drag/resize in the UI after)
`GET /api/delete_zone`	`id`	Remove a zone
`GET /api/toggle_zone`	`id`, `active`	Enable/disable a zone without deleting it
`GET /api/update_zone`	`id`, `name?`, `active?`, `xmin?`, `ymin?`, `xmax?`, `ymax?`	Update zone geometry/name (all coords normalized 0-1)

Endpoint	Params	Description
`GET /api/add_alert`	`item`, `sound`, `custom_path?`, `cooldown?`, `trigger_mode?` (`once`/`interval`)	Add an alert rule for a detected class
`GET /api/delete_alert`	`id`	Remove an alert rule
`GET /api/toggle_alert`	`id`, `active`	Enable/disable a rule

Endpoint	Description
`GET /`	Homepage, lists all files by category
`GET /files/{category}/{filename}`	Download a file (`category` = `packages` \| `service-files` \| `docs`)
`GET /view/{category}/{filename}`	Render a markdown doc inline
`POST /upload/{category}`	Upload a file - multipart `file` field, `X-Upload-Token` header must match `PORTAL_UPLOAD_TOKEN`
`GET /healthz`	Health check

Fixed a real problem: the source tarball's filename included a date stamp, and the setup guide's copy-paste command had a <date> placeholder in it. A literal placeholder in a shell command is a landmine - it parsed as a redirect operator and broke the command. Filename is now stable (tgcs-fr-pred-source.tar.gz, no date), so the command is copy-paste safe.

Simplified the whole distribution model: the portal now only builds and hosts the small source tarball automatically (via Dockerfile.portal, every deploy) - dropped the earlier plan to also bake a pre-built .deb into the portal, since that just reintroduces the cross-machine build problem this whole thing exists to avoid. Dependencies (OpenCV, camera SDK) are meant to be pip-installed on the target machine itself, from public PyPI, via build_deb_native.sh.
Removed build_deb.sh (the Docker cross-build script) - no longer needed or recommended.

New Source Code section - pull the app source via curl from the portal instead of needing a GitHub account/credentials
Ubuntu Setup Guide now leads with the no-git path

Fixed a real bug: .deb packages built cross-machine (via build_deb.sh/Docker) had a bundled venv whose bin/python symlink pointed at a path that doesn't exist on the target, causing systemctl status=203/EXEC and an endless auto-restart loop. Both build scripts now use python3 -m venv --copies; docs updated to recommend building natively on the target machine.

Full visual redesign: Inter typeface, icon-based file cards instead of bare tables, stats highlight strip, redesigned "Latest Package" hero callout, dark navy header bar
Consolidated all pages onto a single shared layout/header/footer for consistency
Renamed the downloadable service-file reference copy off the old hardware-specific name

Removed hardware-specific branding from all rendered pages and docs - platform is now presented generically as "ELERAIQ Vision"
New Detection Classes page (/classes) listing all 80 recognized object classes, linked from the homepage

Homepage: "Latest Package" download callout, quick-links to docs, packages sorted newest-first
New docs: Overview, API Reference, Docker Deployment Guide
Floating version badge (bottom-right) showing this changelog