隨平台提供 · 整合友善

API 把流量數據
接進你的系統

QTraffic API 以標準 RESTful 介面與 Webhook 對外,讓系統整合商、營運看板與 BI 平台輕鬆取用人流車流的即時統計、歷史趨勢與事件。支援金鑰認證與多租戶多站點,資料自地端流向你的決策流程。

curl
# 取得跨攝影機即時彙整 curl https://qtraffic.bluesign.com.tw/api/stats \ -H "X-API-Key: YOUR_API_KEY" # 回應範例 { "cameras": 6, "people": { "in": 1284, "out": 1197 }, "vehicle": { "in": 3972, "out": 3810 }, "occupancy_now": 47, "by_label": { "car": 2610, "motorcycle": 980 } }
REST
標準 HTTP / JSON
Webhook
事件即時推播
多租戶
多站點資料隔離
金鑰
API Key 認證

API 能力

從即時數字到歷史趨勢與事件推播,一套介面全都涵蓋。

即時統計 API

取得單路或跨攝影機的即時計數、區域占用與方向數據,供看板與監控畫面即時呈現。

  • 單路 / 彙整
  • 即時占用
  • 方向數據
📈

歷史趨勢 API

依時、日、週查詢歷史計數與趨勢,支援時段區間與多據點比較,餵給 BI 分析。

  • 時段查詢
  • 趨勢彙整
  • 多據點
🪝

事件 Webhook

越線、超載、壅塞、告警等事件即時推播到你指定的端點,驅動通知或後續自動化。

  • 即時推播
  • 事件訂閱
  • 自動化觸發
📄

報表匯出

將計數與趨勢匯出為 CSV 等格式,接進既有報表流程或定期產出營運報告。

  • CSV 匯出
  • 定期報表
  • 自訂欄位
🔑

認證與金鑰

以 API Key 進行存取控制,可依整合方分別發放金鑰與權限範圍。

  • API Key
  • 權限範圍
  • 存取控管
🏢

多租戶 / 多站點

支援多租戶與多站點的資料隔離,適合連鎖品牌、物業與系統整合商轉售。

  • 租戶隔離
  • 多站點
  • 轉售友善

端點總覽

代表性端點如下,實際欄位與版本將於整合文件中提供。

endpoints
# 健康檢查 GET /health # 攝影機清單與即時狀態 GET /api/cameras GET /api/cameras/{id} # 單路計數 GET /api/cameras/{id}/counts # 跨攝影機彙整 GET /api/stats # 歷史趨勢(規劃中) GET /api/stats/history?from=&to= # 事件訂閱 Webhook(規劃中) POST /api/webhooks
協定HTTP / JSON(RESTful)
認證X-API-Key Header
即時統計/api/stats/api/cameras/{id}/counts
歷史趨勢時 / 日 / 週區間查詢(規劃中)
事件推播Webhook 訂閱越線 / 告警事件(規劃中)
報表CSV 匯出
多租戶租戶 / 站點層級資料隔離
傳輸HTTPS 加密

版本說明:即時統計相關端點隨平台提供;歷史趨勢與 Webhook 事件訂閱為規劃中項目。欄位與版本以正式整合文件為準,導入時我們會提供對應的 API Key 與串接說明。

核心資料物件

API 圍繞四個核心物件,對應平台的辨識與統計結果。

📹

Camera

攝影機來源、名稱、類型與運行狀態。

🔢

Counts

人 / 車進出、淨值、占用與車型分布。

Event

越線、告警等事件的時間、類型與對象。

🟦

Zone

統計區域與計數線的定義與規則。

整合情境

QTraffic 作為數據來源,接進你既有的系統。

台灣城市道路空拍,汽機車混流車陣情境
📊

營運看板

把即時人車數據嵌入自家儀表板與大螢幕。

🧮

BI 分析

歷史趨勢餵給 BI 工具,做坪效與流量分析。

🚦

交通決策

車流數據接入交控 / 智慧城市決策流程。

🔔

告警串接

事件 Webhook 驅動通訊軟體或工單系統。

同一套平台,涵蓋更多場域

API 是所有模組共用的資料出口,無論串接 Flow、Safety 或 Care,資料結構與認證方式一致。

要把流量數據接進你的系統?

告訴我們你要整合的平台與情境,我們提供 API Key、端點文件與串接協助。

索取整合資訊 → 回平台總覽