修改设备状态
此接口用于修改指定设备的状态。
1 接口路径
PATCH /api/v1/device/status/{deviceId}
2 请求参数
路径参数:
名称 | 类型 | 是否必需 | 描述 |
---|---|---|---|
deviceId | BigInteger | 是 | ID |
body参数,json格式:
名称 | 类型 | 是否必需 | 描述 |
---|---|---|---|
status | String | 是 | 设备状态,可选: FORBIDDEN:禁用 ENABLE:启用 UN_ACTIVE:未激活 ONLINE:在线 OFFLINE:离线 |
3 返回参数
统一返回参数说明参考:公共参数,正常的返回业务参数(data
)为null
。
4 返回状态码
公共状态码说明参考:公共参数,以下是业务关联的状态码说明:
code | 描述 |
---|---|
120106 | 设备不存在或没有权限 |
5 示例
请求示例
/api/v1/device/status/300452843041591296
返回示例
{
"code": "000000",
"data": null,
"message": "success"
}