功能说明

平台提供设备影子功能，用于缓存设备状态。设备在线时，可以到平台获取设备状态，也可以把设备状态上报到平台；设备离线后，再次上线可以主动拉取上报到平台的设备状态。同时云端也可以更新设备影子，当设备上线后主动拉取平台端的设备预期状态。

操作API

接口地址

/iot/v1/application/device/shadow

请求参数

param参数

参数名 必填 示例值 说明
apikey 是 2313123
product_uuid 是 krPVmHSxi35cjzp1
device_uuid 是 O59wNZiK

Body 参数 (application/json)

数据结构符合ujson1.0.1

参数名 说明
method 固定值：shadow.ack.json.rpc
cmd {operation}
groupid 创建物模型的功能组id
para 数据点

cmd定义：
{operation}中的operation由平台定义

  • get：表示获取设备影子
  • set：表示创建设备影子
  • update：表示更新设备影子
  • delete：表示删除设备影子

body示例

  1. {
  2.     "method": "shadow.noack.json.rpc",
  3.     "datapoint": {
  4.         "cmd": "{operation}",
  5.         "groupid": "12",
  6.         "para": {
  7.             "key1": 9,
  8.             "key2": 70,
  9.             "keyn": 80
  10.         }
  11.     }
  12. }

响应参数

  1. {
  2.     "code": 200,
  3.     "msg": "OK",
  4.     "type": 34,
  5.     "data": {
  6.         "msgid": "2a16LUTGsErS",
  7.         "topic": "sub-raw-private"
  8.     },
  9.     "ts": 1606101246445
  10. }