获取所有连接设备

描述:

获取所有连接设备
在 Total Control 6.9.0 及以后版本添加可选参数 "type=number" 只有在专业版的多控中心适用。

对应JS API:
Device.searchObject(sigmaConst.DevAll)
请求方式:

GET
http://IP:8090/TotalControl/v1/devices?q=all&type=number

http://IP:8090/TotalControl/v1/devices?q=all

参数:
参数名 类型 必选 描述
token string Y Total Control TOKEN
q string Y 固定值:all
type string N 固定值:number
type=number 是可选参数:
添加这个参数,返回设备序号。例如:1,2,3
省略这个参数,返回设备字符串。例如:"device@1116106541"
请求示例:

//示例一
http://127.0.0.1:8090/TotalControl/v1/devices?q=all&token=270eq7lXQK8bXYsJ

//示例二
http://127.0.0.1:8090/TotalControl/v1/devices?q=all&type=number&token=270eq7lXQK8bXYsJ
返回示例:

注意:
Total Control 的 REST API 的返回值通常由关键字 “status” 和 “value” 组成,
status: 接口执行成功与否 ,value: 执行接口的返回值,
但是,该 API 的返回值没有关键字 “status” ,返回值如下:


//示例一返回值:
{
"ids":[
"device@795844152",
"device@795812215"
]
}

//示例二返回值:
{
 "ids":[
 1,
 2,
 3
 ]
}

返回字段说明:

示例一返回字段说明:

字段 类型 描述
ids string TC id


示例二返回字段说明:

字段 类型 描述
ids int 设备序号,注意只有在专业版的多控中心,才返回设备序号,不在多控中心,返回的 id 值始终为 0.