---
title: "获取事件历史记录"
method: POST
path: "/api/v1/things/device/msg/event-log/index"
tags: ["things/device/msg", "thingsDeviceMsg"]
---

# 获取事件历史记录

`POST /api/v1/things/device/msg/event-log/index`

## Request body

- DeviceMsgEventLogIndexReq
  - `dataID` string — 获取的具体标识符的数据 如果不指定则获取所有属性数据,一个属性一条,如果没有获取到的不会返回值
  - `deviceNames` string[] — 设备名(不填获取产品下所有设备)
  - `page` PageInfo
    - `orders` OrderBy[] — 排序
      - `field` string — 排序的字段名
      - `sort` integer — 排序方式：1 从小到大, 2 从大到小
    - `page` integer — 页码
    - `size` integer — 每页大小
  - `productID` string — 产品id 获取产品id下的所有设备信息
  - `timeEnd` string — 时间的结束(毫秒时间戳)
  - `timeStart` string — 获取时间的开始(毫秒时间戳)
  - `types` string[] — 类型 事件类型: 信息:info 告警alert 故障:fault

## Response `200`

A successful response.

- object
  - `code` integer
  - `data` DeviceMsgEventLogIndexResp
    - `list` DeviceMsgEventLogInfo[], required — 数据
      - `dataID` string, required — 获取的具体属性值
      - `params` string — 获取到的值
      - `timestamp` string, required — 发生时间戳(毫秒时间戳)
      - `type` string — 类型 事件类型: 信息:info 告警alert 故障:fault
    - `page` integer — 页码
    - `pageSize` integer — 每页大小
    - `total` integer
  - `msg` string

---

[API](https://skmtc.net/unitedrhino/apis/things-api.md) · [All operations](https://skmtc.net/unitedrhino/apis/things-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unitedrhino/things-api/versions/f3bdeb916389/schema)