API / SDK / developer guide
REST resource access
| 目標讀者 TA | 整合開發者 |
|---|---|
| 官方文件能力 | 讀取與更新專案範圍工業資源。 |
| 輸入 → 輸出 | 專案／資源請求 → 資料／狀態／游標。 |
| 執行環境 | 正確叢集、專案與認證身分。 |
| 本站選型評估 | 物件 ID 並非跨專案全域唯一。 |
| 本站建議驗證 | 每個資源參照皆保留專案識別。 |
工業 IoT／SCADA · API / SDK
Cognite Data Fusion APIs
Cognite
以建立關聯的工業資料與資產開發應用。
COGNITE DATA FUSION / DEVELOPER FIELD GUIDE
選對接口，定義可驗證的結果。
公司／專案背景、十個技術入口，以及每份引用的實作分析。
2026-10-08 · 串接尚未實測
公司／專案背景全貌
依官方公司或專案自述撰寫的原創概要；完整原文請見來源。
| 公司 | Cognite 開發工業資料與 AI 軟體，協助團隊探索、連接與使用營運資訊。 |
|---|---|
| 平台 | CDF 整合專案範圍 API、情境化資料模型與工業分析整合。 |
| 適用角色 | 進行 AI 供應商初選的採購、合作夥伴與產品負責人。 |
|---|---|
| 本站評估 | 用定位與公司背景判斷初步適配度；另行取得專案部署、支援與商務條件。 |
已核對官方來源。未呼叫供應商 API 或執行推論；結果為內部契約示意。
十項技術入口比較
依實作決策選出的十個技術文件入口，非十套獨立 SDK 或官方排名。
| 接口 | 用途與 TA |
|---|---|
| 01 · REST resource accessAPI / SDK / developer guide | 讀取與更新專案範圍工業資源。整合開發者 |
| 02 · Python SDKAPI / SDK / developer guide | 使用型別化用戶端操作 CDF 資源。Python 資料工程師 |
| 03 · JavaScript/TypeScript SDKAPI / SDK / developer guide | 以型別化 JavaScript 用戶端整合 CDF。網頁／後端開發者 |
| 04 · Identity and accessAPI / SDK / developer guide | 將 IdP 身分對應至 CDF 群組能力。身分管理者 |
| 05 · Cursor paginationAPI / SDK / developer guide | 擷取完整分頁資源集合。大量擷取開發者 |
| 06 · Time-series aggregationAPI / SDK / developer guide | 以明確粒度計算彙總／插值。製程分析工程師 |
| 07 · Unit-aware dataAPI / SDK / developer guide | 標準化單位並要求支援的轉換。量測整合者 |
| 08 · Entity matchingAPI / SDK / developer guide | 建議來源與目標實體間的連結。情境關聯團隊 |
| 09 · Data Modeling ServiceAPI / SDK / developer guide | 以空間、容器、檢視與實例建模設備關係。工業資料架構師 |
| 10 · API calendar versionsAPI / SDK / developer guide | 透過 Cdf-Version 固定穩定 API 行為。平台維護者 |
逐份文件分析
能力摘要依據官方文件；限制與建議測試為本站工程評估。
API / SDK / developer guide
Python SDK
| 目標讀者 TA | Python 資料工程師 |
|---|---|
| 官方文件能力 | 使用型別化用戶端操作 CDF 資源。 |
| 輸入 → 輸出 | SDK 呼叫 → 資源物件與錯誤。 |
| 執行環境 | 固定 cognite-sdk 版本與相容 Python 執行環境。 |
| 本站選型評估 | SDK 便利功能不取代專案能力授權。 |
| 本站建議驗證 | 驗證分頁、例外映射與用戶端設定。 |
API / SDK / developer guide
JavaScript/TypeScript SDK
| 目標讀者 TA | 網頁／後端開發者 |
|---|---|
| 官方文件能力 | 以型別化 JavaScript 用戶端整合 CDF。 |
| 輸入 → 輸出 | OAuth 用戶端呼叫 → 資源清單。 |
| 執行環境 | 固定 @cognite/sdk 並採適當瀏覽器／服務認證流程。 |
| 本站選型評估 | 後端用戶端密鑰不可放入瀏覽器套件。 |
| 本站建議驗證 | 採用舊教學方法前核對安裝版本遷移指南。 |
API / SDK / developer guide
Identity and access
| 目標讀者 TA | 身分管理者 |
|---|---|
| 官方文件能力 | 將 IdP 身分對應至 CDF 群組能力。 |
| 輸入 → 輸出 | OAuth/OIDC 身分 → 範圍化資源存取。 |
| 執行環境 | 設定 IdP、核准應用與專案群組成員資格。 |
| 本站選型評估 | 登入成功不代表可存取所有資源。 |
| 本站建議驗證 | 驗證預定讀寫範圍與鄰接資源拒絕。 |
API / SDK / developer guide
Cursor pagination
| 目標讀者 TA | 大量擷取開發者 |
|---|---|
| 官方文件能力 | 擷取完整分頁資源集合。 |
| 輸入 → 輸出 | 固定篩選與游標 → 下一頁／nextCursor。 |
| 執行環境 | 資源專屬限制與授權專案。 |
| 本站選型評估 | 短頁仍可能有 nextCursor；不可依頁面長度停止。 |
| 本站建議驗證 | 保持請求參數不變，直到游標耗盡。 |
API / SDK / developer guide
Time-series aggregation
| 目標讀者 TA | 製程分析工程師 |
|---|---|
| 官方文件能力 | 以明確粒度計算彙總／插值。 |
| 輸入 → 輸出 | 序列、區間與彙總 → 時段結果。 |
| 執行環境 | 時序讀取權限與階梯／連續解讀設定。 |
| 本站選型評估 | average 是時間加權而非算術平均；插值並非原始讀值。 |
| 本站建議驗證 | 測試稀疏區間並標示插值／彙總值。 |
API / SDK / developer guide
Unit-aware data
| 目標讀者 TA | 量測整合者 |
|---|---|
| 官方文件能力 | 標準化單位並要求支援的轉換。 |
| 輸入 → 輸出 | 來源與目標單位 → 轉換值／單位資料。 |
| 執行環境 | 已知單位識別與相容量測物理量。 |
| 本站選型評估 | 單純自由文字標籤不是已驗證物理轉換。 |
| 本站建議驗證 | 以已知參考值核對維度、比例與偏移。 |
API / SDK / developer guide
Entity matching
| 目標讀者 TA | 情境關聯團隊 |
|---|---|
| 官方文件能力 | 建議來源與目標實體間的連結。 |
| 輸入 → 輸出 | 實體屬性與模型 → 候選排名／分數。 |
| 執行環境 | 設定比對模型與相關資料權限。 |
| 本站選型評估 | 分數不是通用校準機率或已驗證識別。 |
| 本站建議驗證 | 審查模糊候選，並以標記樣本驗證連結。 |
API / SDK / developer guide
Data Modeling Service
| 目標讀者 TA | 工業資料架構師 |
|---|---|
| 官方文件能力 | 以空間、容器、檢視與實例建模設備關係。 |
| 輸入 → 輸出 | 結構與實例定義 → 可查詢工業圖譜。 |
| 執行環境 | 專案資料模型權限與明確模型／檢視版本。 |
| 本站選型評估 | 舊資產中心假設可能不符合所選資料模型。 |
| 本站建議驗證 | 驗證屬性型別、關係與所選檢視版本。 |
API / SDK / developer guide
API calendar versions
| 目標讀者 TA | 平台維護者 |
|---|---|
| 官方文件能力 | 透過 Cdf-Version 固定穩定 API 行為。 |
| 輸入 → 輸出 | v1 路徑與日期版本標頭 → 版本化端點行為。 |
| 執行環境 | 支援的穩定日期版本與相容 SDK。 |
| 本站選型評估 | Playground 已棄用；不建議正式環境使用 beta。 |
| 本站建議驗證 | 除版本標頭外，也審查棄用公告。 |
Official documentation
| TA | 工程師與技術產品負責人 |
|---|---|
| 本站驗證建議 | 實作前固定版本並依目標環境核對支援條件。 |
Deprecated and retired features
| TA | 既有 CDF 整合維護者 |
|---|---|
| 本站驗證建議 | 勿建立新的 Vision API 或 totalVariation 相依；重用前審查已退役 CDF CLI 與 Cognite Functions 執行環境要求。 |
04 / INPUT · EXPECTED OUTPUT · ACCEPTANCE
實作前先看懂預期結果
僅為工業資產／時序擷取契約示意。未執行 CDF 專案、模型或 API。
示意契約 · 未呼叫 API 或執行模型 · 不是供應商實測輸出
完整情境資料擷取
| 輸入 | 授權資產查詢與關聯時序。 |
|---|---|
| 預期結果 | 具來源識別與單位的專案範圍紀錄。 |
| 驗收條件 | 驗證關係正確性、游標耗盡與來源追溯。 |
稀疏區間
| 輸入 | 有效彙總查詢無符合資料點，且未補值。 |
|---|---|
| 預期結果 | 無彙總時段；不杜撰零值讀值。 |
| 驗收條件 | 明確呈現缺少資料，並區分插值。 |
有游標的短頁
| 輸入 | 頁面筆數少於要求，但包含 nextCursor。 |
|---|---|
| 預期結果 | 後續頁面完成前 retrieval_complete=false。 |
| 驗收條件 | 不可依頁面長度截斷資料集。 |
能力授權不足
| 輸入 | 有效身分缺少要求專案資源的權限。 |
|---|---|
| 預期結果 | 含資源範圍的存取錯誤；不可替換為空成功。 |
| 驗收條件 | 透過擁有者取得適當能力；不可自動擴大範圍。 |
將預期結果對應至你的應用
將實際執行環境回應對應至此建議應用契約。所有數值皆為示意，不含憑證或真實執行。
預期輸出 JSON — 示意，非實測 · CogniteDataFusion-expected-results.json
{
"schema_version": "1.0.0",
"example": true,
"provider": "Cognite Data Fusion",
"status": "ok",
"input_id": "sample-001",
"data": {
"project": "demo-project",
"external_id": "demo-pump-1",
"retrieval_complete": true,
"records": [
{
"temperature_c": 23.5,
"value_kind": "raw-example"
}
],
"next_cursor": null
},
"error": null,
"verification": "illustrative-only;not-provider-response"
}| 狀態語意 | 有效空結果與錯誤不同；等待中的工作不可提前顯示成功。 |
|---|---|
| 證據 | 記錄服務與 SDK 版本、請求識別、設定及回應映射。此處未執行或量測效能。 |
| 建議驗收 | 以授權代表樣本測試前，先約定數值誤差與負載目標。 |
開發評估
工業資產證據瀏覽器
開發構想規格・串接尚未實測
接口能力依據官方文件或程式庫；以下產品方向、輸入、交付與驗收條件則是我們的開發評估。
需整合驗證
估算可交付產品前，需共同驗證執行環境、資料結構或硬體。
- 原型輸入規劃
- 測試設備或模擬器、訊號對照表與明確單位。
- 原型交付規劃
- 附時間、資料新鮮度、單位與連線狀態的設備數值。
- 驗收條件
- 對照來源驗證比例與時間；設備斷線時不得顯示正常。
- 依賴條件
- 閘道或服務帳號、設備資料結構與測試環境。
開發順序
- 確認 Cognite Data Fusion APIs 的存取、授權與支援版本。
- 準備上述樣本，針對「工業資產證據瀏覽器」先實作一個有官方文件的操作。
- 整理輸出時保留來源、時間與錯誤狀態，並保留供應商回應供審核。
- 通過驗收條件後，再估算擴展投入與客戶交付。
如何驗證需求
記錄產品瀏覽、官方文件點擊、規格下載與技術 Hub 點擊。這些是事件次數，不等於獨立人數或已完成串接。
本次可行性評估依實作條件判斷；尚未給定流量排名或交期承諾。