前序系列文章>>>ide
接口列表—智能門鎖url
對各類數據類型以及平臺使用的數據作一個簡單的說明~.net
1、數據類型對象
- 布爾型(Boolean):非真即假的二值型變量。例如,開關功能,取值爲開或關。
- 數值型(Integer):適用於可線性調節類型的數據。例如:溫度調節,溫度範圍 20-40℃。
- 枚舉型(Enum):有限集合值。例如:工做檔位,低檔、中檔或高檔。
- 字符串型(String):字符串類型。
-
對象類型(Json):下發的值是一個對象的 Json 格式,會有對應對象屬性的說明解釋。
2、數據傳輸類型:
blog - 可下發可上報:指令數據能夠下發給設備,設備數據能夠上報給雲端。
- 只上報:數據只支持從設備上報。
- 只下發:數據只支持從雲端下發。
3、取值約束
(一)Integer 類型示例格式:接口
{"min":11,"unit":"s","scale":0,"max":86400,"step":1}文檔
取值約束說明字符串
- min:最小取值。示例值:11。
- max:最大取值。示例值:86400。
- unit:數值的單位。示例值:s 。
- scale:數據將以 10 的指數轉換進行傳輸。示例:0, 表示 10 的 0 次方,即1。
- step:數據增量間距(即步長)。示例值:1。
Scale 參數說明
如下爲當前電壓取值的取值約束示例。scale 的取值是 1。
若是查詢設備狀態獲得的值是 {"cur_voltage":2230},那麼用戶可讀值爲 2230/(10^1 )= 223V (即電壓是:223伏特)。
get
取值約束範圍說明
本文檔中在指定的取值範圍約束爲參考範圍,實際每一個設備有特定的具體取值約束範圍。
(二)String 類型示例格式
{"maxlen":255}
it
取值約束說明
maxlen:值最大長度。示例值:255。
(三)Enum 類型示例格式
{"range":["1","2","3","4","5"]}
取值約束說明
range:枚舉取值限定範圍。示例爲:"1","2","3","4","5"。