简要描述:

  • 通过该接口查询设备的物模型属性上报记录

接口版本:

版本号 制定人 制定日期 修订日期
1.0.0 张浩 2023-08-16

请求URL:

iot-platform/device-thing-model-server/v1/property/reported/history/getPage

请求方式:

  • GET

请求头:

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

请求参数:

参数名 是否必须 类型 说明
page Int 当前页数,默认值是1
limit Int 一页条数 数量限制:每页最多可显示50条。默认值是10
productId String 产品ID
deviceId String 设备ID
identifier String 属性标识符
module String 所属模块,默认为default模块
startTime Long 要查询的事件记录的开始时间。格式为毫秒级的13位时间戳
endTime Long 要查询的事件记录的开始时间。格式为毫秒级的13位时间戳

返回示例:

正确时返回:

{
  "code": 0,
  "msg": "ok",
  "err_code": 10000,
  "result": {
    "list": [
      {
        "time": 1692175019846,
        "value":"red"
      }
    ]
  }
}

错误时返回:

{
  "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 Array 返回的结果,当失败时为空

result返回值描述:

字段名称 字段类型 是否必须 描述
1 list Array 查询的事件记录列表

list返回值描述:

字段名称 字段类型 是否必须 描述
1 value Long 属性值
2 time Long 属性的上报时间,毫秒值

备注:

  • 更多返回错误代码请看首页的错误代码描述
 创建时间:2023-08-17 16:49
最后编辑:陈勇琦  更新时间:2024-10-18 10:58