工務技術通告第 3/2023 號，附件 A 第 5(6) 及 5(12)(a) 條
4S 平台 API 及數據：系統整合、寄存及移交
按發展局工務技術通告第 3/2023 號附件 A 第 5(6) 條，4S 平台須把每項附時間戳記的警報、圖像及讀數加密，並經 API 提供，同時保持 API 文件更新。寄存須符合認可的保安標準。部分合約規格另加 OpenAPI v3 REST API、單一登入及 SFTP 數據中心。SpatialSense 逐項符合。
最後更新
- API
- 附時間戳記的數據可經 API 提供（第 5(6) 條）
- API 標準
- RESTful、OpenAPI v3、JSON
- 單一登入
- OpenID Connect 或 OAuth2，PKCE 及 Client Credentials
- 寄存
- TIA-942 Tier 3 數據中心及 ISO/IEC 27001
- 加密
- 最少 256 位元 SSL
- 合約完結
- 交還數據、銷毀複本、發出證明書
通告對 4S 數據的要求
發展局工務技術通告第 3/2023 號附件 A 第 5(6) 條規定，4S 組成部分傳送的所有聲音、影像、圖像及數據，均須數碼化並標示傳送日期及時間，可經應用程式介面（API）整合，並實時串流至中央管理平台。所有數據均須加密。承建商須在系統升級及維修期間維持 API，並在系統啟用及每次重大升級後保存 API 庫文件副本。
第 5(12)(a) 條訂明平台的寄存及保安要求。伺服器可設於工地辦公室、數據中心或雲端。數據自動歸檔，保存最少 3 個月。用戶經 HTTPS 以瀏覽器使用平台，毋須其他軟件或牌照。
合約同時採用 DWSS 及 4S 時，發展局工務技術通告第 8/2025 號規定 4S 平台須併入 DWSS，成為同一個智慧建造管理中心（第 7 段註腳 1）。DWSS 其後在 24 小時內把數據開放予 iCWP（附件 A 第 1.7.2 條）。
系統整合責任，以及 SpatialSense 如何符合
| 責任 | 出處 | SpatialSense |
|---|---|---|
| 附時間戳記的數據可經 API 提供 | 第 3/2023 號附件 A 5(6) | 符合。每項警報、圖像及讀數均附日期及時間，獲授權系統可經 API 取用。 |
| 保持 API 文件更新 | 附件 A 5(6) | 符合。系統啟用及每次重大升級後保存 API 庫文件。 |
| 附 OpenAPI v3 描述文件的 REST API | 部分合約規格 | 符合。JSON 描述文件、X.Y.Z 版本編號、標準的建立、讀取、更新及刪除操作，並列明每項錯誤。 |
| 雙向數據存取 | 部分合約規格 | 符合。可查詢、匯出及匯入原始及已處理數據。 |
| 單一登入 | 部分合約規格 | 符合。以 OpenID Connect 或 OAuth2 經總承建商的 Azure Active Directory 登入，採用附 PKCE 的 Authorization Code 流程及 Client Credentials 流程；如採用 SAML 或 WS-Fed 亦可配合。 |
| SFTP 數據中心 | 部分合約規格 | 符合。按議定間隔生成 TXT 或 CSV 原始數據檔案，由白名單 IP 位址推送至承建商伺服器，並以檔尾 CRC 核對。 |
| DWSS 中心 | 第 8/2025 號第 7 段註腳 1 | 符合。SpatialSense 同時是 4S 平台及 DWSS。 |
| 發展局 SmartEye | 部分合約規格 | 符合。平台數據經 API 傳送至發展局的 SmartEye 儀表板。 |
寄存及保安
附件 A 第 5(12)(a) 條的平台要求，以及部分合約規格的新增要求。
- 數據中心
- TIA-942 認證 Tier 3 數據中心及 ISO/IEC 27001（第 5(12)(a)(x) 條）
- 雲端保證
- 最新的獨立核數師報告，例如 ISO/IEC 20000 或 ISO/IEC 27017（第 5(12)(a)(x) 條）
- 工地伺服器
- 以防火牆或 VPN 隔離（第 5(12)(a)(ix) 條）
- 加密
- 所有通訊及數據傳送最少採用 256 位元 SSL（第 5(12)(a)(xi) 條）；敏感的 API 屬性以 AES 加密。
- 保安審核
- 按《保安規例》及政府基線 IT 保安政策進行（第 5(12)(a)(xii) 條）
- 可用度
- 工作時間內 99.9%（第 1(3) 條）；合約有要求時另備 99.99% 備援計劃
- 私隱
- 符合《個人資料（私隱）條例》（第 1(2) 條）；合約有要求時進行獨立私隱影響評估
合約完結時
交還
所有項目數據及資料交還項目經理。
移除
每項停用組成部分的數據均完全移除。
銷毀
寄存環境內的複本及備份均安全刪除。
證明
發出數據銷毀證明書。
核實
項目經理可檢查及核實數據已交還及銷毀。
OpenAPI、單一登入及 SFTP 數據中心。
系統整合設定集中在同一畫面：已發布 OpenAPI 文件、啟用單一登入，並已連接 SFTP 數據中心。
4S 平台 API 及數據常見問題
4S 平台需要 API 嗎？
需要。4S 組成部分的所有聲音、影像、圖像及數據均須附時間戳記，並可經 API 整合；承建商須維持 API 並保存 API 庫文件（發展局工務技術通告第 3/2023 號附件 A 第 5(6) 條）。
合約要求採用哪種 API 標準？
通告沒有指明。部分合約規格要求 RESTful API，附有效的 OpenAPI v3 描述文件（JSON），並採用標準的建立、讀取、更新及刪除操作。SpatialSense 提供此 API。
用戶可以用總承建商的帳戶登入嗎？
可以。SpatialSense 支援以 OpenID Connect 或 OAuth2 經總承建商的 Azure Active Directory 單一登入，採用附 PKCE 的 Authorization Code 流程及 Client Credentials 流程。
4S 平台須寄存在哪裡？
可設於工地辦公室並以防火牆或 VPN 保護，或設於數據中心或雲端。寄存伺服器須符合認可標準，例如 TIA-942 認證 Tier 3 數據中心及 ISO/IEC 27001，並提交 ISO/IEC 20000 或 ISO/IEC 27017 等獨立核數師報告（第 5(12)(a)(ix) 及 (x) 條）。
4S 數據如何進入 DWSS？
合約同時採用兩者時，4S 平台須併入 DWSS（工務技術通告第 8/2025 號第 7 段註腳 1）。SpatialSense 本身就是同一個系統，每項 4S 警報都存於 DWSS 記錄內。
合約完結時數據如何處理？
所有數據交還項目經理，複本及備份安全銷毀，並發出數據銷毀證明書。項目經理可加以核實。
相關指南
更多智慧工地安全指南
- 4S 與 DWSS按發展局工務技術通告第 3/2023 及 8/2025 號，4S 中央管理平台如何併入 DWSS 智慧建造管理中心，以及哪些數據會傳入。
- AI 鏡頭發展局工務技術通告第 3/2023 號第 5(12)(g) 條：AI 鏡頭須偵測的不安全情境、80% 測試及 90% 平均準確度、1 秒內警報及錄影記錄。
- 中央管理平台發展局工務技術通告第 3/2023 號對 4S 中央管理平台的要求：30 名用戶、保存 3 個月數據、保安，以及每項裝置傳送的警報資料。
- 4S 組成部分發展局工務技術通告第 3/2023 號附件 A 列出的 12 項 4S 組成部分、各自的核心要求，以及適用於所有裝置的規定。Kodifly 以單一項目完整提供。
- 密閉空間發展局工務技術通告第 3/2023 號第 5(12)(h) 條：就第 59AE 章所指的密閉空間點算工人、檢查個人防護裝備，並監察氧氣、氣體及溫度。
- 合約規格差異香港不同合約規格對 4S 的要求差異：12 或 9 項組成部分、2 或 15 部 AI 鏡頭、70 或 100 分貝警報聲，以及額外的數據責任。Kodifly 兩者皆符合。
- 4S 標籤計劃建造業議會與發展局的安全智慧工地系統標籤計劃：誰可申請、議會評審甚麼、現場巡查、標籤一年有效期、續期及收回標籤。
- 流動機械警報發展局工務技術通告第 3/2023 號第 5(12)(e) 條：挖掘機及起重機設 360 度感應器、2 米危險區、100 分貝警報聲，以及屋宇署對私人工程的強制規定。
- 工作許可證發展局工務技術通告第 3/2023 號第 5(12)(c) 條對數碼工作許可證系統的要求：涵蓋的高風險工序、流動裝置即時狀態及到期警報。
- 機械及工具追蹤發展局工務技術通告第 3/2023 號第 5(12)(b) 條：每件機械、升降工作平台、起重裝置及電動工具附數碼識別碼，可掃描查核並發出逾期警報。
- 智能鎖發展局工務技術通告第 3/2023 號第 5(12)(d) 條：電錶箱、地台開口、升降機槽及密閉空間加裝電子鎖及鑰匙，並設警報聲及警報訊息。
- 塔式起重機警報發展局工務技術通告第 3/2023 號第 5(12)(e) 條：塔式起重機裝卸危險區為吊鈎半徑不少於 7 米、3 米淨距、100 分貝警報聲及警報訊息。
- VR 安全訓練發展局工務技術通告第 3/2023 號第 6 條：為八類高風險工序的工人每半年進行虛擬實境安全訓練，包括內容、設備及訓練記錄。
- 工人智能監察發展局工務技術通告第 3/2023 號第 5(12)(f) 條：為每名工人提供穿戴裝置，具定位、靜止、體溫及心跳警報，並設私隱限制。