MQTT
伺服器連線位址：iot.cht.com.tw，連接埠1883 與 8883 (TLS 加密連線)
裝置狀態監控
伺服器連線位址：iot.cht.com.tw，連接埠1883 與 8883 (TLS 加密連線)
由裝置主動上傳HeartBeat訊息讓系統依據頻率資訊判斷設備狀態
協定名稱
發送 HeartBeat
Topic
/v1/device/${device_id}/heartbeat
協定描述
發送 HeartBeat
模式
Publish
帳號與密碼
username: PROJECT_KEY or DEVICE_KEY
password: PROJECT_KEY or DEVICE_KEY
password: PROJECT_KEY or DEVICE_KEY
Message 說明
{
"pulse": "1000"
}
備註
1.pulse 裝置發送訊息間隔時間
2.project key 為專案的專屬金鑰，可以從專案管理 > 權限資料查詢得知
3.device key 為裝置專屬的金鑰，可以從裝置管理查詢得知
4.MQTT QoS 傳輸品質目前支援 QoS 0 最多傳送一次（at most once）模式。
5.MQTT 在網路階層架構中屬於應用層，它產生訊息並交給下一層（TCP）處理， MQTT 本身並不清楚最底層的網路是否壅塞甚至斷線，因此 MQTT 不保證能百分之百交付訊息。
2.project key 為專案的專屬金鑰，可以從專案管理 > 權限資料查詢得知
3.device key 為裝置專屬的金鑰，可以從裝置管理查詢得知
4.MQTT QoS 傳輸品質目前支援 QoS 0 最多傳送一次（at most once）模式。
5.MQTT 在網路階層架構中屬於應用層，它產生訊息並交給下一層（TCP）處理， MQTT 本身並不清楚最底層的網路是否壅塞甚至斷線，因此 MQTT 不保證能百分之百交付訊息。
協定名稱
訂閱 HeartBeat 通知
Topic
/v1/device/${device_id}/heartbeat
協定描述
訂閱 HeartBeat 通知
模式
Subscribe
帳號與密碼
username: PROJECT_KEY or DEVICE_KEY
password: PROJECT_KEY or DEVICE_KEY
password: PROJECT_KEY or DEVICE_KEY
Response 說明
{
"pulse": "1000",
"from": "223.140.31.51",
"last": "2016-03-30T08:28:47.532Z",
"time": "2016-03-30T09:28:47.532Z",
"type": "Lost",
"deviceId": "853435970"
}
備註
1.pulse 裝置發送訊息間隔時間
2.from 裝置最後一次發送訊息IP
3.last 裝置最後一次發送訊息時間
4.time 目前時間
5.type 裝置狀態 [Live: 裝置第一次連上IoT智慧聯網大平台並開始傳送HeartBeat時。Lost: 沒有在時間內收到通知。ReLive: 裝置中斷HeartBeat後，重新連回IoT智慧聯網大平台時。LastInfo: 裝置最後一次HeartBeat的資訊]
6.project key 為專案的專屬金鑰，可以從專案管理 > 權限資料查詢得知
7.device key 為裝置專屬的金鑰，可以從裝置管理查詢得知
8.MQTT QoS 傳輸品質目前支援 QoS 0 最多傳送一次（at most once）模式。
9.MQTT 訂閱通知訊息的反應時間會依據平台目前訊息量多寡而影響快慢，平均 3秒內可接收到通知訊息。
10.MQTT 在網路階層架構中屬於應用層，它產生訊息並交給下一層（TCP）處理， MQTT 本身並不清楚最底層的網路是否壅塞甚至斷線，因此 MQTT 不保證能百分之百交付訊息。
2.from 裝置最後一次發送訊息IP
3.last 裝置最後一次發送訊息時間
4.time 目前時間
5.type 裝置狀態 [Live: 裝置第一次連上IoT智慧聯網大平台並開始傳送HeartBeat時。Lost: 沒有在時間內收到通知。ReLive: 裝置中斷HeartBeat後，重新連回IoT智慧聯網大平台時。LastInfo: 裝置最後一次HeartBeat的資訊]
6.project key 為專案的專屬金鑰，可以從專案管理 > 權限資料查詢得知
7.device key 為裝置專屬的金鑰，可以從裝置管理查詢得知
8.MQTT QoS 傳輸品質目前支援 QoS 0 最多傳送一次（at most once）模式。
9.MQTT 訂閱通知訊息的反應時間會依據平台目前訊息量多寡而影響快慢，平均 3秒內可接收到通知訊息。
10.MQTT 在網路階層架構中屬於應用層，它產生訊息並交給下一層（TCP）處理， MQTT 本身並不清楚最底層的網路是否壅塞甚至斷線，因此 MQTT 不保證能百分之百交付訊息。
設備主動狀態監控
伺服器連線位址：iot.cht.com.tw，連接埠1883 與 8883 (TLS 加密連線)
由系統主動透過設備上傳感測數據頻率判斷設備狀態
協定名稱
訂閱設備主動監控狀態
Topic
/v1/device/${device_id}/active
協定描述
訂閱設備主動監控狀態
模式
Subscribe
帳號與密碼
username: PROJECT_KEY or DEVICE_KEY
password: PROJECT_KEY or DEVICE_KEY
password: PROJECT_KEY or DEVICE_KEY
Response 說明
start 狀態
{
"deviceId": "786727741",
"status": "start",
"createTime": "2019-07-10T02:55:12.512Z"
}
online 狀態
{
"deviceId": "786727741",
"status": "online",
"lastDataTime": "2019-07-10T02:55:17.000Z",
"createTime": "2019-07-10T02:55:18.031Z"
}
abnormal 狀態
{
"deviceId": "786727741",
"status": "abnormal",
"record": 2,
"lastDataTime": "2019-07-10T02:56:45.000Z",
"createTime": "2019-07-10T02:58:09.106Z"
}
offline 狀態
{
"deviceId": "786727741",
"status": "offline",
"lastDataTime": "2019-07-10T03:35:37.000Z",
"createTime": "2019-07-10T03:38:10.069Z"
}
stop 狀態
{
"deviceId": "786727741",
"status": "stop",
"createTime": "2019-07-10T03:40:43.585Z"
}
備註
1.deviceId 為設備編號
2. status 為設備主動監控狀態，狀態分為: start 啟動設備主動監控狀態; online: 設備上線狀態; offline: 設備離線狀態; abnormal: 設備接收數據頻率異常狀態; stop: 設備停止主動監控狀態
3. record 異常頻率資訊(指定週期內接收到的感測數據筆數)
4. lastDataTime 最後一筆收到設備資料時間
5. createTime 設備主動監控狀態判斷時間
6.project key 為專案的專屬金鑰，可以從專案管理 > 權限資料查詢得知
7.device key 為裝置專屬的金鑰，可以從裝置管理查詢得知
8.MQTT QoS 傳輸品質目前支援 QoS 0 最多傳送一次（at most once）模式。
9.MQTT 在網路階層架構中屬於應用層，它產生訊息並交給下一層（TCP）處理， MQTT 本身並不清楚最底層的網路是否壅塞甚至斷線，因此 MQTT 不保證能百分之百交付訊息。
2. status 為設備主動監控狀態，狀態分為: start 啟動設備主動監控狀態; online: 設備上線狀態; offline: 設備離線狀態; abnormal: 設備接收數據頻率異常狀態; stop: 設備停止主動監控狀態
3. record 異常頻率資訊(指定週期內接收到的感測數據筆數)
4. lastDataTime 最後一筆收到設備資料時間
5. createTime 設備主動監控狀態判斷時間
6.project key 為專案的專屬金鑰，可以從專案管理 > 權限資料查詢得知
7.device key 為裝置專屬的金鑰，可以從裝置管理查詢得知
8.MQTT QoS 傳輸品質目前支援 QoS 0 最多傳送一次（at most once）模式。
9.MQTT 在網路階層架構中屬於應用層，它產生訊息並交給下一層（TCP）處理， MQTT 本身並不清楚最底層的網路是否壅塞甚至斷線，因此 MQTT 不保證能百分之百交付訊息。