API / SDK / developer guide
Device protocols
| 目標讀者 TA | 連線工程師 |
|---|---|
| 官方文件能力 | 選用 MQTT/WSS 發布訂閱或 HTTPS 發布。 |
| 輸入 → 輸出 | 主題內容與連線設定 → 訊息傳輸。 |
| 執行環境 | 帳號端點；依協定選擇 TLS 與認證。 |
| 本站選型評估 | HTTPS 不提供 MQTT 訂閱。 |
| 本站建議驗證 | 驗證重連與文件列出的連接埠／認證組合。 |
工業 IoT／SCADA · API / SDK
AWS IoT Core API
AWS
在 AWS IoT 服務中管理連網裝置資源。
AWS IOT CORE / DEVELOPER FIELD GUIDE
選對接口，定義可驗證的結果。
公司／專案背景、十個技術入口，以及每份引用的實作分析。
2026-10-08 · 串接尚未實測
公司／專案背景全貌
依官方公司或專案自述撰寫的原創概要；完整原文請見來源。
| 服務 | AWS IoT Core 透過雲端訊息及規則式資料整合連接裝置群。 |
|---|---|
| 實作邊界 | 裝置連線、雲端狀態及下游業務完成是不同的證據層。 |
| 適用角色 | 進行 AI 供應商初選的採購、合作夥伴與產品負責人。 |
|---|---|
| 本站評估 | 用定位與公司背景判斷初步適配度；另行取得專案部署、支援與商務條件。 |
已核對官方來源。未呼叫供應商 API 或執行推論；結果為內部契約示意。
十項技術入口比較
依實作決策選出的十個技術文件入口，非十套獨立 SDK 或官方排名。
| 接口 | 用途與 TA |
|---|---|
| 01 · Device protocolsAPI / SDK / developer guide | 選用 MQTT/WSS 發布訂閱或 HTTPS 發布。連線工程師 |
| 02 · Device SDK selectionAPI / SDK / developer guide | 選擇維護中的語言／裝置用戶端。韌體開發者 |
| 03 · Device Shadow topicsAPI / SDK / developer guide | 透過保留主題取得、更新與刪除雲端狀態。裝置狀態整合者 |
| 04 · Rules engineAPI / SDK / developer guide | 過濾 MQTT 串流並啟動設定的服務動作。資料整合工程師 |
| 05 · IoT policy actionsAPI / SDK / developer guide | 分別授權連線、發布、訂閱及接收。資安工程師 |
| 06 · Fleet provisioningAPI / SDK / developer guide | 依範本佈建裝置專屬憑證。裝置群佈建團隊 |
| 07 · IoT JobsAPI / SDK / developer guide | 協調遠端裝置作業。裝置群維運 |
| 08 · Thing registryAPI / SDK / developer guide | 組織裝置資源識別與屬性。資產整合團隊 |
| 09 · CloudWatch loggingAPI / SDK / developer guide | 檢視訊息代理與規則處理事件。維運工程師 |
| 10 · HTTP Publish APIAPI / SDK / developer guide | 透過資料平面將內容發布至主題。後端開發者 |
逐份文件分析
能力摘要依據官方文件；限制與建議測試為本站工程評估。
API / SDK / developer guide
Device SDK selection
| 目標讀者 TA | 韌體開發者 |
|---|---|
| 官方文件能力 | 選擇維護中的語言／裝置用戶端。 |
| 輸入 → 輸出 | 連線設定 → MQTT 訊息與回呼。 |
| 執行環境 | 選用符合平台的 SDK 並固定版本。 |
| 本站選型評估 | 舊 SDK 世代僅維護更新；新專案應避開。 |
| 本站建議驗證 | 移植前核對目標 OS、TLS 與 MQTT 支援。 |
API / SDK / developer guide
Device Shadow topics
| 目標讀者 TA | 裝置狀態整合者 |
|---|---|
| 官方文件能力 | 透過保留主題取得、更新與刪除雲端狀態。 |
| 輸入 → 輸出 | Shadow 請求 → 接受／拒絕回應或差異。 |
| 執行環境 | 具名／預設 Shadow 主題與主題授權。 |
| 本站選型評估 | 雲端期望狀態並非實體執行證據。 |
| 本站建議驗證 | 關聯接受／拒絕訊息及裝置回報狀態。 |
API / SDK / developer guide
Rules engine
| 目標讀者 TA | 資料整合工程師 |
|---|---|
| 官方文件能力 | 過濾 MQTT 串流並啟動設定的服務動作。 |
| 輸入 → 輸出 | 主題訊息與規則 → 下游動作。 |
| 執行環境 | AWS 資源權限與目的端設定。 |
| 本站選型評估 | 動作需要權限，且可能產生目的服務費用。 |
| 本站建議驗證 | 區分條件未符合及授權／動作失敗。 |
API / SDK / developer guide
IoT policy actions
| 目標讀者 TA | 資安工程師 |
|---|---|
| 官方文件能力 | 分別授權連線、發布、訂閱及接收。 |
| 輸入 → 輸出 | 身分、動作與資源 → 允許／拒絕。 |
| 執行環境 | 依適當資源類型限制 IoT 政策。 |
| 本站選型評估 | 只有 Subscribe 權限並不代表可 Receive。 |
| 本站建議驗證 | 測試授權主題與禁止存取的跨裝置主題。 |
API / SDK / developer guide
Fleet provisioning
| 目標讀者 TA | 裝置群佈建團隊 |
|---|---|
| 官方文件能力 | 依範本佈建裝置專屬憑證。 |
| 輸入 → 輸出 | 宣告憑證或可信使用者流程 → 憑證與登錄裝置。 |
| 執行環境 | 佈建範本、角色與受保護的初始憑證。 |
| 本站選型評估 | 所有權權杖會到期；初始宣告憑證不是日常裝置憑證。 |
| 本站建議驗證 | 驗證以永久憑證重新連線，且不記錄私鑰。 |
API / SDK / developer guide
IoT Jobs
| 目標讀者 TA | 裝置群維運 |
|---|---|
| 官方文件能力 | 協調遠端裝置作業。 |
| 輸入 → 輸出 | 作業文件與目標 → 各裝置執行進度。 |
| 執行環境 | Jobs 服務與裝置端作業處理器。 |
| 本站選型評估 | 建立作業不代表裝置執行完成。 |
| 本站建議驗證 | 要求目標裝置的終態執行證據。 |
API / SDK / developer guide
Thing registry
| 目標讀者 TA | 資產整合團隊 |
|---|---|
| 官方文件能力 | 組織裝置資源識別與屬性。 |
| 輸入 → 輸出 | 裝置中繼資料 → 登錄紀錄。 |
| 執行環境 | 區域 AWS IoT 控制平面權限。 |
| 本站選型評估 | 登錄存在不代表裝置已連線。 |
| 本站建議驗證 | 確認業務資產識別對應到正確裝置。 |
API / SDK / developer guide
CloudWatch logging
| 目標讀者 TA | 維運工程師 |
|---|---|
| 官方文件能力 | 檢視訊息代理與規則處理事件。 |
| 輸入 → 輸出 | 啟用記錄與執行作業 → 記錄事件。 |
| 執行環境 | 設定記錄功能與 CloudWatch 權限。 |
| 本站選型評估 | 缺少記錄群組可能因未啟用或無事件，並非群組正常證據。 |
| 本站建議驗證 | 關聯主題／用戶端事件與目的端觀察。 |
API / SDK / developer guide
HTTP Publish API
| 目標讀者 TA | 後端開發者 |
|---|---|
| 官方文件能力 | 透過資料平面將內容發布至主題。 |
| 輸入 → 輸出 | 主題、內容與 QoS → HTTP 狀態；成功本文為空。 |
| 執行環境 | 正確資料端點與授權簽章／憑證。 |
| 本站選型評估 | HTTP 200 不代表下游處理或實體動作完成。 |
| 本站建議驗證 | 接受空白成功本文；另行驗證消費端接收。 |
Official documentation
| TA | 工程師與技術產品負責人 |
|---|---|
| 本站驗證建議 | 實作前固定版本並依目標環境核對支援條件。 |
04 / INPUT · EXPECTED OUTPUT · ACCEPTANCE
實作前先看懂預期結果
遙測傳送契約示意；未使用 AWS 帳號、憑證、MQTT 連線或 API 呼叫。
示意契約 · 未呼叫 API 或執行模型 · 不是供應商實測輸出
遙測已接收
| 輸入 | 授權主題上的合成事件。 |
|---|---|
| 預期結果 | 發布獲接受，消費端記錄相同事件 ID。 |
| 驗收條件 | 獨立驗證內容映射與去重，不只看發布狀態。 |
Publish 空回應
| 輸入 | 成功 HTTP Publish 沒有本文。 |
|---|---|
| 預期結果 | accepted=true；觀察到消費端前 consumer_verified 為 false。 |
| 驗收條件 | 不可把空本文當成資料遺失失敗，也不可杜撰送達證據。 |
更新期望狀態後裝置離線
| 輸入 | Shadow 更新獲接受但無新回報狀態。 |
|---|---|
| 預期結果 | 雲端更新獲接受；實體套用待確認。 |
| 驗收條件 | 不可依 Shadow 接受結果標記致動動作完成。 |
未授權主題
| 輸入 | 憑證無目標主題 Publish 權限。 |
|---|---|
| 預期結果 | 作業遭拒；無成功證據。 |
| 驗收條件 | 顯示授權錯誤，不無限重試或揭露金鑰。 |
將預期結果對應至你的應用
將實際執行環境回應對應至此建議應用契約。所有數值皆為示意，不含憑證或真實執行。
預期輸出 JSON — 示意，非實測 · AWSIoTCore-expected-results.json
{
"schema_version": "1.0.0",
"example": true,
"provider": "AWS IoT Core",
"status": "ok",
"input_id": "sample-001",
"data": {
"topic": "factory/demo/temperature",
"publish_accepted": true,
"consumer_verified": true,
"device_execution_verified": false,
"event_id": "demo-event-001"
},
"error": null,
"verification": "illustrative-only;not-provider-response"
}| 狀態語意 | 有效空結果與錯誤不同；等待中的工作不可提前顯示成功。 |
|---|---|
| 證據 | 記錄服務與 SDK 版本、請求識別、設定及回應映射。此處未執行或量測效能。 |
| 建議驗收 | 以授權代表樣本測試前，先約定數值誤差與負載目標。 |
開發評估
連網設備登錄工具
開發構想規格・串接尚未實測
接口能力依據官方文件或程式庫；以下產品方向、輸入、交付與驗收條件則是我們的開發評估。
需整合驗證
估算可交付產品前，需共同驗證執行環境、資料結構或硬體。
- 原型輸入規劃
- 測試設備或模擬器、訊號對照表與明確單位。
- 原型交付規劃
- 附時間、資料新鮮度、單位與連線狀態的設備數值。
- 驗收條件
- 對照來源驗證比例與時間；設備斷線時不得顯示正常。
- 依賴條件
- 閘道或服務帳號、設備資料結構與測試環境。
開發順序
- 確認 AWS IoT Core API 的存取、授權與支援版本。
- 準備上述樣本，針對「連網設備登錄工具」先實作一個有官方文件的操作。
- 整理輸出時保留來源、時間與錯誤狀態，並保留供應商回應供審核。
- 通過驗收條件後，再估算擴展投入與客戶交付。
如何驗證需求
記錄產品瀏覽、官方文件點擊、規格下載與技術 Hub 點擊。這些是事件次數，不等於獨立人數或已完成串接。
本次可行性評估依實作條件判斷；尚未給定流量排名或交期承諾。