发送设备命令

给设备发送命令指令的API

注：请先查看：API接口调用说明


获取属性

  • Request Url
{api_url}/deviceCmd/sendGetProperties

  • Request Method

    POST

  • Request Body

字段 值描述 值类型 必填
pdid 产品id String 是
deviceSn 设备sn String 是
iid 消息唯一id（uuid） String 否
propts 需要获取的属性列表 [{}] 是
sid 服务定义id long 是
pid 属性定义id long 是

示例：

{
    "pdid": "",
    "deviceSn": "xxx",
    "iid": "d5f20906760a42a4a9e411439f97e15a",
    "propts": [
        {
            "pid": 0,
            "sid": 1
        },
        {
            "pid": 0,
            "sid": 2
        }
    ]
}


  • Response Body
字段 值描述
iid 消息唯一id（uuid）

示例：

{
    "status": 0,
    "description": "成功",
    "payload": {
        "iid": "d5f20906760a42a4a9e411439f97e15a"
    }
}


设置属性

  • Request Url
{api_url}/deviceCmd/sendSetProperties

  • Request Method

    POST

  • Request Body

字段 值描述 值类型 必填
pdid 产品id String 是
deviceSn 设备sn String 是
iid 消息唯一id（uuid） String 否
propts 需要设置的属性列表 [{}] 是
sid 服务定义id long 是
pid 属性定义id long 是
value 属性值 根据具体值类型 是

示例：

{
    "pdid": "",
    "deviceSn": "xxx",
    "iid": "d5f20906760a42a4a9e411439f97e15a",
    "propts": [
        {
            "pid": 0,
            "value": 123,
            "sid": 1
        },
        {
            "pid": 0,
            "value": "abc",
            "sid": 2
        }
    ]
}


  • Response Body
字段 值描述
iid 消息唯一id（uuid）

示例：

{
    "status": 0,
    "description": "成功",
    "payload": {
        "iid": "d5f20906760a42a4a9e411439f97e15a"
    }
}


发送方法

  • Request Url
{api_url}/deviceCmd/sendAction

  • Request Method

    POST

  • Request Body

字段 值描述 值类型 必填
pdid 产品id String 是
deviceSn 设备sn String 是
iid 消息唯一id（uuid） String 否
method 方法名称 String 是
inParams 方法的输入参数 [{}] 是
name 参数名称 String 是
value 属性值 根据具体值类型 是

示例：

{
    "pdid": "",
    "deviceSn": "123456789012",
    "iid": "d5f20906760a42a4a9e411439f97e15a",
    "method": "test action",
    "inParams": [
        {
            "name": "test1",
            "value": 123.456
        },
        {
            "name": "test2",
            "value": "efg"
        }
    ]
}


  • Response Body
字段 值描述
iid 消息唯一id（uuid）

示例：

{
    "status": 0,
    "description": "成功",
    "payload": {
        "iid": "d5f20906760a42a4a9e411439f97e15a"
    }
}


发送固件升级

  • Request Url
{api_url}/deviceCmd/upgrade

  • Request Method

    POST

  • Request Body

字段 值描述 值类型 必填
pdid 产品id String 是
deviceSn 设备sn String 是
iid 消息唯一id（uuid） String 否
model 固件类型 String 是
version 版本号 String 是
size 固件大小 long 是
url 固件链接地址 String 是
startDate 允许升级的开始时间 String 是
endDate 允许升级的结束时间 String 是

示例：

{
    "pdid": "",
    "deviceSn": "123456789012",
    "iid": "d5f20906760a42a4a9e411439f97e151",
    "size": 123456789,
    "model": "test1",
    "version": "1.1.2",
    "url": "https://www.baidu.com",
    "startDate": "01:01",
    "endDate": "06:01"
}


  • Response Body
字段 值描述
iid 消息唯一id（uuid）

示例：

{
    "status": 0,
    "description": "成功",
    "payload": {
        "iid": "d5f20906760a42a4a9e411439f97e151"
    }
}


results matching ""

    No results matching ""