API / SDK / developer guide
Things model
| 目標讀者 TA | 分身模型設計者 |
|---|---|
| 官方文件能力 | 將裝置表示為數位分身實體。 |
| 輸入 → 輸出 | Thing 識別及屬性 → 分身文件。 |
| 執行環境 | 固定已發行 Ditto 部署及設定連線層 |
| 本站選型評估 | 已儲存分身狀態可能不同於實體裝置。 |
| 本站建議驗證 | 保留裝置身分、更新時間及狀態來源。 |
工業 IoT／SCADA · API
Eclipse Ditto HTTP API
Eclipse Foundation
透過數位孿生 HTTP 接口建模並存取連網物件。
所連結未版本化 Ditto 頁面標明為開發版本文件。實作前固定已發行版本，不假設所有文件功能已存在於安裝版本。
ECLIPSE DITTO / DEVELOPER FIELD GUIDE
選對接口，定義可驗證的結果。
公司／專案背景、十個技術入口，以及每份引用的實作分析。
2026-10-08 · 串接尚未實測
公司／專案背景全貌
依官方公司或專案自述撰寫的原創概要；完整原文請見來源。
| 專案 | Eclipse Ditto 是開源、領域無關的物聯網裝置數位分身框架。 |
|---|---|
| 中介角色 | 抽象化裝置狀態，提供同步及非同步介面與資源層存取控制。 |
| 連線邊界 | 裝置連線層及協定連線將實體裝置及外部系統連至 Ditto。 |
| 適用角色 | 進行 AI 供應商初選的採購、合作夥伴與產品負責人。 |
|---|---|
| 本站評估 | 用定位與公司背景判斷初步適配度；另行取得專案部署、支援與商務條件。 |
已核對官方來源；未執行真實 API、推論或效能測試。預期結果為建議內部契約。
十項技術入口比較
依開發任務選出的十個有文件技術入口；不是十套獨立 SDK 或官方排名。
| 接口 | 用途與 TA |
|---|---|
| 01 · Things modelAPI / SDK / developer guide | 將裝置表示為數位分身實體。分身模型設計者 |
| 02 · Features modelAPI / SDK / developer guide | 將裝置屬性組織為 feature。裝置能力建模者 |
| 03 · PolicyAPI / SDK / developer guide | 授權分身資源存取。存取控制團隊 |
| 04 · HTTP searchAPI / SDK / developer guide | 使用篩選搜尋授權分身。裝置群應用工程師 |
| 05 · HTTP messagesAPI / SDK / developer guide | 透過 Ditto 發送應用訊息。裝置互動團隊 |
| 06 · WebSocket bindingAPI / SDK / developer guide | 透過持續 socket 交換協定訊息。即時介面團隊 |
| 07 · Payload mappingAPI / SDK / developer guide | 將外部內容轉為 Ditto 訊息或反向轉換。協定整合工程師 |
| 08 · Twin and live channelsAPI / SDK / developer guide | 選擇持久分身存取或即時裝置互動。架構團隊 |
| 09 · Conditional requestsAPI / SDK / developer guide | 僅在宣告條件符合時更新。並行更新工程師 |
| 10 · Acknowledgements and QoSAPI / SDK / developer guide | 定義訊息處理必要確認。傳遞可靠性工程師 |
逐份文件分析
能力摘要依據官方文件；限制與建議測試為本站工程評估。
API / SDK / developer guide
Features model
| 目標讀者 TA | 裝置能力建模者 |
|---|---|
| 官方文件能力 | 將裝置屬性組織為 feature。 |
| 輸入 → 輸出 | Feature ID 及屬性 → 結構化功能狀態。 |
| 執行環境 | 固定已發行 Ditto 部署及設定連線層 |
| 本站選型評估 | 預期及回報屬性不可互換。 |
| 本站建議驗證 | 驗證屬性名稱、單位及預期／回報路徑。 |
API / SDK / developer guide
Policy
| 目標讀者 TA | 存取控制團隊 |
|---|---|
| 官方文件能力 | 授權分身資源存取。 |
| 輸入 → 輸出 | 主體、資源及權限 → 執行政策。 |
| 執行環境 | 固定已發行 Ditto 部署及設定連線層 |
| 本站選型評估 | 認證本身不授予資源權限。 |
| 本站建議驗證 | 測試允許欄位及拒絕跨裝置存取。 |
API / SDK / developer guide
HTTP search
| 目標讀者 TA | 裝置群應用工程師 |
|---|---|
| 官方文件能力 | 使用篩選搜尋授權分身。 |
| 輸入 → 輸出 | 查詢及欄位 → 符合分身紀錄。 |
| 執行環境 | 固定已發行 Ditto 部署及設定連線層 |
| 本站選型評估 | 搜尋結果受存取控制及分頁限制。 |
| 本站建議驗證 | 檢查空結果及完整分頁，不擴大存取。 |
API / SDK / developer guide
HTTP messages
| 目標讀者 TA | 裝置互動團隊 |
|---|---|
| 官方文件能力 | 透過 Ditto 發送應用訊息。 |
| 輸入 → 輸出 | 訊息主旨及內容 → 可用時接收端回應。 |
| 執行環境 | 固定已發行 Ditto 部署及設定連線層 |
| 本站選型評估 | 訊息傳輸不保證實體任務完成。 |
| 本站建議驗證 | 關聯裝置回覆並明確處理逾時。 |
API / SDK / developer guide
WebSocket binding
| 目標讀者 TA | 即時介面團隊 |
|---|---|
| 官方文件能力 | 透過持續 socket 交換協定訊息。 |
| 輸入 → 輸出 | 訂閱或命令協定流量 → 串流回應／事件。 |
| 執行環境 | 固定已發行 Ditto 部署及設定連線層 |
| 本站選型評估 | 重新連線可能中斷事件觀察。 |
| 本站建議驗證 | 重連後核對狀態，不假設未漏變更。 |
API / SDK / developer guide
Payload mapping
| 目標讀者 TA | 協定整合工程師 |
|---|---|
| 官方文件能力 | 將外部內容轉為 Ditto 訊息或反向轉換。 |
| 輸入 → 輸出 | 裝置特定內容 → 正規化協定資料。 |
| 執行環境 | 固定已發行 Ditto 部署及設定連線層 |
| 本站選型評估 | 映射錯誤可能改變單位或目標識別。 |
| 本站建議驗證 | 代表內容往返驗證並拒絕錯誤結構。 |
API / SDK / developer guide
Twin and live channels
| 目標讀者 TA | 架構團隊 |
|---|---|
| 官方文件能力 | 選擇持久分身存取或即時裝置互動。 |
| 輸入 → 輸出 | 通道特定請求 → 儲存狀態或即時回應。 |
| 執行環境 | 固定已發行 Ditto 部署及設定連線層 |
| 本站選型評估 | 成功讀取分身不表示裝置在線。 |
| 本站建議驗證 | 向下游呈現通道及資料新鮮度。 |
API / SDK / developer guide
Conditional requests
| 目標讀者 TA | 並行更新工程師 |
|---|---|
| 官方文件能力 | 僅在宣告條件符合時更新。 |
| 輸入 → 輸出 | 條件及變更 → 接受更新或前置條件失敗。 |
| 執行環境 | 固定已發行 Ditto 部署及設定連線層 |
| 本站選型評估 | 忽略失敗條件可能覆蓋並行變更。 |
| 本站建議驗證 | 測試過期狀態衝突，核對現況後才重試。 |
API / SDK / developer guide
Acknowledgements and QoS
| 目標讀者 TA | 傳遞可靠性工程師 |
|---|---|
| 官方文件能力 | 定義訊息處理必要確認。 |
| 輸入 → 輸出 | 要求確認標籤 → 確認結果。 |
| 執行環境 | 固定已發行 Ditto 部署及設定連線層 |
| 本站選型評估 | 每個確認涵蓋特定處理邊界。 |
| 本站建議驗證 | 驗證預期參與端，區分缺少確認與成功。 |
HTTP API concepts
| TA | API 整合者 |
|---|---|
| 本站驗證建議 | 選擇已發行版本文件並確認條件存取及回應行為。 |
04 / INPUT · EXPECTED OUTPUT · ACCEPTANCE
實作前先看懂預期結果
數位分身讀取契約示意，不是 Ditto 協定原生 JSON。未寫入分身、傳送裝置訊息或呼叫 API。
示意契約 · 未呼叫 API 或執行模型 · 不是供應商實測輸出
取得儲存分身
| 輸入 | 授權讀取已知分身。 |
|---|---|
| 預期結果 | ok，channel=twin 及儲存屬性。 |
| 驗收條件 | 保留新鮮度，不宣稱即時装置連線。 |
搜尋無符合
| 輸入 | 有效授權搜尋無符合分身。 |
|---|---|
| 預期結果 | ok 且 things: []。 |
| 驗收條件 | 區分搜尋空結果、拒絕及直接資源不存在錯誤。 |
即時裝置不可用
| 輸入 | 即時通道請求在策略時限內無裝置回應。 |
|---|---|
| 預期結果 | timeout／error；儲存分身仍可能可讀。 |
| 驗收條件 | 不可將儲存資料冒充即時資料。 |
條件更新衝突
| 輸入 | 更新條件不符合現有分身狀態。 |
|---|---|
| 預期結果 | error／conflict；不回報已套用變更。 |
| 驗收條件 | 重試前讀取現況並核對。 |
將預期結果對應至你的應用
整合後將實際 SDK 或服務回應對應至此建議內部契約。下列識別碼與數值均為示意；不含憑證或真實請求。
預期輸出 JSON — 示意，非實測 · EclipseDitto-expected-results.json
{
"schema_version": "1.0.0",
"example": true,
"provider": "Eclipse Ditto",
"status": "ok",
"input_id": "sample-001",
"data": {
"thing_id": "example:device",
"channel": "twin",
"reported": {
"temperature_c": 24
},
"desired": {},
"observed_at": null,
"device_online_confirmed": false
},
"error": null,
"verification": "illustrative-only;not-provider-response"
}| 結果解讀 | 傳輸或執行成功不代表模型準確。有效空結果須與操作失敗分開。 |
|---|---|
| 可重現性 | 記錄模型、環境、設定與輸入識別；代表性測試前約定品質及延遲條件。不宣稱已實測效能。 |
| 操作範圍 | 數位分身讀取契約示意，不是 Ditto 協定原生 JSON。未寫入分身、傳送裝置訊息或呼叫 API。 |
開發評估
設備狀態孿生原型
開發構想規格・串接尚未實測
接口能力依據官方文件或程式庫；以下產品方向、輸入、交付與驗收條件則是我們的開發評估。
可先做小原型
確認存取後，用少量真實樣本測試一個有文件的操作。此為開發判斷，不是交期估算。
- 原型輸入規劃
- 測試設備或模擬器、訊號對照表與明確單位。
- 原型交付規劃
- 附時間、資料新鮮度、單位與連線狀態的設備數值。
- 驗收條件
- 對照來源驗證比例與時間；設備斷線時不得顯示正常。
- 依賴條件
- 閘道或服務帳號、設備資料結構與測試環境。
串接前置條件
所連結未版本化 Ditto 頁面標明為開發版本文件。實作前固定已發行版本，不假設所有文件功能已存在於安裝版本。
開發順序
- 確認 Eclipse Ditto HTTP API 的存取、授權與支援版本。
- 準備上述樣本，針對「設備狀態孿生原型」先實作一個有官方文件的操作。
- 整理輸出時保留來源、時間與錯誤狀態，並保留供應商回應供審核。
- 通過驗收條件後，再估算擴展投入與客戶交付。
如何驗證需求
記錄產品瀏覽、官方文件點擊、規格下載與技術 Hub 點擊。這些是事件次數，不等於獨立人數或已完成串接。
本次可行性評估依實作條件判斷；尚未給定流量排名或交期承諾。