智汇云-企业数智化核心引擎

说明

批量控制设备服务

URL

/device/batchInvokeThingService

请求方法

POST

请求参数

字段	类型	必选	说明
list	string	是	需要控制的设备列表，json序列化字符串，list结构见Device表
timeout	string	否	接口超时时限，默认为5s,可以设置1-10s之间的值，例如：timeout=7
公共请求参数		是	详见公共参数部分

Device表

字段	类型	必选	说明
product_key	string	是	产品的唯一标识（云平台生成）
device_name	string	是	设备的唯一标识
identifier	string	是	服务的标识符。设备的服务Identifier，可在IoT开发者平台的产品的物模型中查看
input	string	是	要启用的物模型服务的入参信息，数据格式为JSON String，如， input={“param1”:1}。若此参数为空时，需传入 input={} 。具体解释见下面input表
extra	string	否	其他业务所需参数，数据格式json ,如extra={“qid”:”123456”}。json的key和值都是字符串类型

响应数据

字段	类型	说明
request_id	string	云平台为该请求生成的唯一标识符
errmsg	string	调用失败时，返回的出错信息
errno	number	errno等于0表示成功，其他表示失败
data	data	设置成功时，返回的数据。详情请见下表data

data表：

字段	类型	说明
list	list of device	控制设备响应列表，见下device表

device表：

字段	类型	说明
product_key	string	设备产品key
device_name	string	设备device_name
errno	int	errno为0，则表示调用成功，否则表示调用失败
errmsg	string	当errno非0时，失败的原因
data	device_data	errno为0，调用成功的响应

device_data表:

字段	类型	说明
message_id	string	响应的消息id
result	string	响应的结果， json map string 格式

响应示例

{
    "request_id": "29e2f4b4-0ffd-4eaf-8185-f55b45cc6f87",
    "errno": 0,
    "errmsg": "",
    "data": {
        "list": [{
                "product_key": "产品1",
                "device_name": "设备1",
                "errno": 1, //errno为0，则表示调用成功，否则调用失败
                "errmsg": "设备调用失败"
            },
            {
                "product_key": "产品2",
                "device_name": "设备2",
                "errno": 0,  //errno为0表示调用成功
                "data":{
                        "message_id": "378068540",
                        "result": "{\"prop3\":80}"
                }
            }
        ]
    }
}

AI平台

AI应用

视觉分析

视频

物联网

数据上云

IoT设备

账号体系

智慧城市

电商视频解决方案

教育

全屋智能

医疗

智能制造

游戏

物联网平台