简要描述：

  • 通过HTTP接口，进行控制属性的值，让设备接收到该指令后修改本地状态并上报
  • 该接口在会在下发成功之后立刻返回，调用者后续监听设备上报的状态

接口版本：

版本号 制定人 制定日期 修订日期
1.0 张浩 2025-01-10

请求URL:

iot-platform/device-thing-model-server/v1/property/async/control

请求方式：

  • POST

请求头：

参数名 是否必须 类型 说明
Content-Type 是 string 请求类型： application/json
Authorization 是 string 鉴权信息

请求示例:

{
    "productId":"AAcmXyLkS1",
    "deviceId":"339a0519f96b432092d6c3451b2dd53e",
    "property":{
        "default":{
            "color":{
                 "value":"red",
                  "time": 1692175019846
            }
        },
        "test":{
            "power":{
                "value":1,
                  "time": 1692175019846
            }
        }
    }
}

请求参数:

参数名 是否必须 类型 说明
productId 是 string 产品ID,最长10位
deviceId 是 string 设备ID，最长32位
messageId String 否 消息ID，最长为64位字符，标识该消息的唯一ID，如不传则由服务端随机生成
property 是 Object 属性对象
property.{module} 是 Object 属性所属模块
property.{module}.{filed} 是 String 属性标识符
propert.{module}.{filed}.value Object 是 表示需要控制属性的变更值
propert.{module}.{filed}.time Long 否 表示属性更新的时间，unix时间戳毫秒值。如果不传，则使用物模型服务接收到消息的时间戳。

返回示例:

正确时返回:

{
  "code": 0,
  "msg": "ok",
  "err_code": 10000,
  "result":  {
  }
}

错误时返回:

{
  "code": -1,
  "msg": "${errorMessage}",
  "err_code": ${errorCode},
  "result": null
}

返回参数说明:

字段名称 字段类型 是否必须 描述
1 code int 是 状态码，为0时表示接口调用成功，不为0时表示接口调用失败
2 err_code int 是 错误码，当code为0时，返回10000，否则返回对应错误码
3 msg String 是 错误的具体消息
4 result Object 否

备注:

  • 更多返回错误代码请看首页的错误代码描述
 创建时间：2025-01-10 14:39
最后编辑：admin  更新时间：2025-04-29 15:30