删除家庭下房间内的设备

更新时间:2024-01-11 05:56:14下载pdf

本文介绍删除家庭下房间内的设备的 API。

接口描述

根据家庭 ID、房间 ID 和设备 ID 列表,删除家庭下指定房间内的设备。

接口地址

DELETE: /v1.0/homes/{home_id}/rooms/{room_id}/devices

请求参数

参数名类型参数位置是否必填说明
home_idLonguritrue家庭 ID。
room_idLonguritrue房间 ID。

body 说明

参数名类型参数位置是否必填说明
device_idsList true设备 ID 列表。

device_ids 说明

参数名类型参数位置是否必填说明
device_idsString false待删除的设备 ID。支持删除多个设备,用半角逗号(,)隔开。

返回参数

参数名类型说明
resultBoolean返回设备删除状态。
  • true:删除成功
  • false:删除失败

请求示例

DELETE: /v1.0/homes/31****/rooms/234****/devices
{
  "device_ids": [
    "did12345***",
    "did12345***"
  ]
}

返回示例

{
    "tid": "ea0605487d3e31ee82c7664ef4d3e193",
    "result": true,
    "t": 1699341969429,
    "success": true
}

错误码

参考 错误码