🔒 修改個人登入密碼
🔑 管理員重設帳號密碼
噪音監測資料上傳API 登入
請輸入您的帳號與密碼以進入系統。
每筆連線皆記錄精確時間、來源 IP、User-Agent、設備所屬組織、Token 前綴、Payload SHA-256 及區塊鏈式防竄改雜湊鏈 (prev_hash → record_hash)。
同一來源 IP 於 5 分鐘內連續登入錯誤達 5 次，系統立即將該使用者帳號停用 (is_active = False) 並記錄 CRITICAL 數位跡證。
一旦偵測到上傳內容夾帶 SQL Injection、XSS、目錄穿越 (../) 或偽造圖片/執行檔 (MZ/ELF)，系統立即永久停用該 API Token。
資安等級「中級」連線與事件數位跡證 (Digital Forensics Audit Logs) SHA-256 雜湊鏈保護中
每筆紀錄皆包含精確時間、來源 IP、User-Agent、使用者與設備所屬組織、Token 前綴、Payload SHA-256 及前序防竄改雜湊鏈 (`prev_hash` → `record_hash`)。
| ID / 時間戳記 | 等級 / 結果 | 事件代碼 / 動作 | 來源 IP / 路徑 | 帳號 / 設備所屬組織 / Token | 詳細跡證說明 | 數位跡證雜湊 (SHA-256) |
|---|
新增使用者與設備所屬組織
建立設備上傳帳號時，必須明確填寫「設備所屬組織」與「允許點位編號」以釐清噪音監測資料來源。
使用者與所屬組織清單
若帳號於同 IP 5 分鐘內連續登入失敗 5 次將自動停用，管理員可於此處檢視原因並解鎖。
| ID / 帳號 | 姓名 / 角色 | 設備所屬組織 (統編) | 授權點位 | 帳號狀態 / 鎖定原因 | 操作 |
|---|
簽發設備 API Token (可設定有效時間)
每個 Token 皆綁定所屬組織、授權點位與自訂有效期限。
API Token 狀態清單
可檢視已簽發之 Token 到期時間、最後連線紀錄與啟用狀態。
| 前綴 / 名稱 | 設備所屬組織 / 點位 | 有效期限 | 最後使用 / IP | 狀態 / 停用原因 | 操作 |
|---|
1. 噪音 JSON + Base64 照片轉 JPEG 上傳 (`POST /api/v1/noise/upload`)
2. 噪音舉發影片上傳 (GCS V4 Signed URL / Multipart 串流)
1. 體積膨脹 33%：50MB 的 MP4 影片轉成 Base64 會變成約 67MB 的純文字字串。
2. 記憶體與解析瓶頸：API 伺服器解析數十 MB 的單一 JSON 字串極易觸發 OOM 或連線逾時。
3. 最佳架構實踐：提供 方案 A (GCS V4 Signed URL 預簽章直傳) 與 方案 B (Multipart 二進位串流上傳)。
已上傳至 Google Cloud Storage 之噪音監測紀錄與 JPEG 影像
此處資料可供後續「噪音展示與查詢網站」透過 API 直接調用與快速顯示 JPEG 照片。
| ID / 點位 / 地點 | 車牌辨識 | 量測時間 | 噪音值 (量測/修正/標準/超標) | 設備所屬組織 | GCS 轉換後之 JPEG 照片與影片路徑 |
|---|
📖 噪音監測資料上傳API 串接說明與規格文件
本系統除提供下方中文串接指南外，亦提供線上互動式 API 說明頁與 OpenAPI 規格下載。
1. 設備上傳認證標頭 (Authentication Header)
設備端呼叫上傳 API 時，請於 HTTP Header 帶入系統簽發之 API Token（兩種寫法皆支援）：
Authorization: Bearer ntk_xxxxxxxx_xxxxxxxxxxxxxxxxxxxx # 或 X-API-Token: ntk_xxxxxxxx_xxxxxxxxxxxxxxxxxxxx
2. 核心 API 端點一覽表
| Method & Path | 功能說明 |
|---|---|
| POST /api/v1/noise/upload | 上傳噪音 JSON 與 Base64 照片（自動轉 JPEG 存入 GCS） |
| POST /api/v1/noise/video/signed-url | 【推薦】取得 GCS V4 Signed URL 供設備直接 PUT 上傳 MP4 影片 |
| POST /api/v1/noise/video/upload | Multipart 二進位串流上傳 MP4 舉發影片 |
| GET /api/v1/noise/records | 供後續「噪音展示網站」查詢案件、GCS JPEG 與影片路徑 |