查询设备是否在线
通过请求查询指定设备是否在线。Post请求方式,参数以x-www-form-urlencoded方式放在body里。支持子设备。用户传参数subid表明查询子设备在线状态,不传参数subid表明查询主设备在线状态。
例如:
curl"https://api.qinglianyun.com/open/oauth/v1/mac/online"
-d"qlaccesstoken=xxx&mac=xxxxxx&subid=xxxxxx"
返回的 JSON 数据:
{
"code": 0,
"msg":"xxxxxxxxxxx",
"data": "true"
}
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
mac | String | 设备的Mac | 如: 5c:cf:7f:c1:0b:fd | 是 |
qlaccesstoken | String | 青莲云用户账 号的token |
青莲云每一个用户账号都是唯一的 | 是 |
subid | String | 子设备id | 用户传参数subid表明查询子设备 在线状态,不传参数subid表明查 询主设备在线状态 |
否 |
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
code | Int | 返回码 | 查看Api返回码 | 是 |
data | String | 返回值 | 在线返回true,不在线返回false,出错返回空 | 是 |
msg | String | 返回信息 | 如果code为0,则msg为空;如果code不为0, 则msg返回的为相关错误信息 |
是 |