希沃物联平台文档

批量执行设备服务 - 根据tag

此接口用于根据tag批量执行设备下发服务，异步。

1 接口路径

POST /api/v1/device/invoke/thing/service/batch/tag

2 请求参数

body参数，json格式：

名称 类型 是否必需 描述
productKey String 是 产品唯一标识
tags Object 是 设备标签tag，json对象
serviceKey String 是 设备模型中定义的服务标识
params Object 否 服务标识符的入参信息，设备模型中定义，json对象
liveTime Integer 否 消息缓存时长（单位秒），0为不缓存，最大值8640000（100天），默认值604800（7天）
version String 否 协议版本，保留字段

3 返回参数

统一返回参数说明参考：公共参数，正常的返回业务参数（data）为null。

4 返回状态码

公共状态码说明参考：公共参数，以下是业务关联的状态码说明：

code 描述
120112 功能标识符未定义
120106 未找到满足tag的设备

5 示例

请求示例

{
  "serviceKey": "service_down_async",
  "params": {
  	"color":123
  },
  "tags": {
  	"room": "001"
  },
  "version": "1.0.0",
  "liveTime": 60,
  "productKey": "4774a9d1204"
}

返回示例

{
    "code": "000000",
    "data": null,
    "message": "success"
}