智慧路燈 CMS API 怎麼驗收?從 GIS、工單到調光權限
對我們所撰寫的主題感興趣嗎? 立即加入偏好來源,獲取最即時一手資訊!
首圖為光林智能 Smart Node 原廠照片。下圖為 CMS API 驗收示例。
同一盞路燈在 GIS 顯示為 A-018,在平台匯出檔裡只剩設備序號,維運系統卻依地址建工單。試裝時工程師可以人工對照,擴到全區後,漏單與重複派工就難以追查。CMS API 的驗收從資產身分開始,接著驗證事件如何變成工單、命令如何到現場,以及承辦人員異動後如何撤回存取權。
台灣的 LEOLink 官方方案以 RenAI 作中央管理平台。本文採用這類架構說明驗收情境。各專案要以簽約範圍、版本化 API 文件、可供測試的設備和權限模型確認交付細節。
先建立盤點資料與時間基準
約定桿號、燈具編號、控制節點及維運區的主鍵。舊系統若有一桿多燈、燈桿移設、拆除或重裝,必須能追到生效日期、設備替換及座標版本。用樣本同時測中文路名、欠缺 GPS 的設備及重複桿號。時間欄位要說明設備回報時間、平台接收時間、匯入工單時間與時區的記法。
平台要能交付版本化文件,說明欄位型別、分頁、速率限制、重試規則、錯誤內容與停用舊版的通知方式。將機關的資安要求與契約交付條件列入測試計畫。可用 OpenAPI 規格描述介面,並用測試證據確認實際端點行為。OpenAPI Specification
四個驗收測試與通過證據
| 測試 | 操作情境 | 驗收證據 |
|---|---|---|
| 桿號與範圍 | 用區域 A 的唯讀帳號查區域 A 和區域 B 的資產 | 可存取範圍符合合約,未授權資料無法取得 |
| 告警與工單 | 同一資料重送,另模擬離線補送、錯序、重複 ACK | 工單不重複建立,能追到原事件 ID 與時間 |
| 調光狀態 | 在測試節點發命令,分別查受理、回覆、逾時與實際狀態 | 保存關聯 ID 和設備端狀態;測試復歸 |
| 撤權與移交 | 停用帳號憑證,匯出資產、角色、事件、操作歷程 | 舊權限停止生效,欄位與筆數可對帳 |
圖表與示範測試應使用測試環境、測試桿號或事先核定的窗口。測試帳號的憑證、面向外部的網路位址及未公開資產位置由驗收文件控管。驗收文件可留帳號類型、資產樣本、請求識別碼、結果、版本和日期,供交接後重做。物件層級授權要測「這個帳號能否存取這一支燈桿」,OWASP 有獨立說明。OWASP 物件層級授權風險

重點 先以測試帳號確認管轄範圍,再逐一保留事件、命令、回報與資料匯出的證據。
查看大圖
一個可以重做的工單算例
假設測試節點為 A-018。08:00 送出事件 E-100,08:02 重送同一個 ID,08:04 再送始於 07:58 的舊狀態。驗收先定義事件唯一鍵、時間來源,以及重送和延遲補送的規則。若事件識別 ID 由兩套系統各自產生,必須記錄對照機制。測試要能從工單回到 E-100,看到最初回報與後續重送,並證明延遲資料如何保留及呈現。工單關閉後的再發事件,也應有明確的重開或另開原則。
控制測試可清楚切分「已收到請求」、「設備已回覆」、「有觀測資料確認狀態」。例如節點暫時離線,介面應能依協議顯示待送達、逾時或失敗。測試需涵蓋命令失效時間、回復排程及取消,避免離線期間排隊的舊命令在復線後意外執行。對應的實地驗收與台帳交付可由智慧路燈驗收移交篇延伸。
交付前建議由下一班維運人員依文件重新匯入一份樣本,確認資料欄位、代碼字典、時區和下載權限都可使用。若現場有 GIS、既有派工或能源系統,備妥資產資料格式、維運分區與希望測試的命令情境,洽詢可交付的介接範圍。RenAI 官方技術頁 · 聯絡光林智能
對我們所撰寫的主題感興趣嗎? 立即加入偏好來源,獲取最即時一手資訊!



