Watch API v1

# 將 Watch 事件接入你的系統

v0.39 提供唯讀事件 API，可查詢紀錄、訂閱新事件及下載可用截圖。攝影機、任務與通知在 Watch 內設定。

## 選擇你要做的事

[

### 先確認能連線

從內建事件檢視器開始，不必安裝 SDK。需要程式整合時，再試一個唯讀請求。

](https://watch.tensordynamics.org/developers/quickstart?lang=zh)[

### 讓其他系統收到通知

在 Watch 的事件轉送設定加入接收端，並確認測試通知確實送達。

](https://watch.tensordynamics.org/developers/webhooks?lang=zh)

## 事件讀取與事件轉送

```
Your system → GET /v1/events → sentinel.event.v1
Watch desktop → your webhook receiver → sentinel.alert.v1
```

API 查詢由你的系統發起，需要 events:read 金鑰。桌面事件轉送由 Watch 主動發送，接收端使用獨立的共用密鑰驗證簽章。兩者的 JSON 格式不同，不能直接共用同一套欄位驗證。

公開 API 是唯讀介面。它不提供遠端修改設定、任務、排程或資料庫的操作，也不控制設備。這些使用者操作請留在 Watch 介面。

## 開發參考

*   [建立與保管事件讀取金鑰](https://watch.tensordynamics.org/developers/authentication?lang=zh)
*   [事件欄位、搜尋、串流與截圖](https://watch.tensordynamics.org/developers/events?lang=zh)
*   [完整唯讀 API 與 OpenAPI](https://watch.tensordynamics.org/developers/api-reference?lang=zh)
*   [Python、JavaScript 與 PowerShell 範例](https://watch.tensordynamics.org/developers/examples?lang=zh)
*   [錯誤、分頁與重試](https://watch.tensordynamics.org/developers/api-behavior?lang=zh)

[需要協助連線或排錯？使用安裝助手。](https://watch.tensordynamics.org/docs/setup-assistant?lang=zh)

---
Source: https://watch.tensordynamics.org/developers?lang=zh
More Watch guides: https://watch.tensordynamics.org/llms.txt