# 设备告警数据 * **说明** > 分页获取设备在一段时间内的告警记录。该消息可能是由用户发起也可以由设备主动查询。校验条件包括： > * 如指定设备id，需验证设备id是否存在 > * 校验uid，验证uid是否有权限查看设备数据 > * 校验起始时间 > * 校验每页大小范围 * **URL**：/v1/user/data/alarm${did}?startTime=XX&endTime=XX&pageNo=XX&pageSize=XX * **请求方式**：GET * **Header参数**： | **Header\_Key** | **Header\_Value** | | :---: | :---: | | **ts** | 精确到ms的时间戳 | | **openid** | openid，每个个人用户的唯一标识 | | **applicationid** | 应用ID，每个开发者的唯一标识 | | **sign** | 加密签名，算法为SHA1\(HTTPMethod+RequestURI+params+ts+openkey+applicationkey\) | * **请求内容**： ``` { "did": "deviceId", "startTime": "yyyy-MM-ddTHH:mm:ss", "endTime": "yyyy-MM-ddTHH:mm:ss", "pageNo": 0, "pageSize": 30 } ``` | **参数名称** | **中文名称** | **类型** | **限制** | **必须** | **说明** | | :--- | :---: | :---: | :---: | :---: | :--- | | **did** | 设备id | 字符串 | 6~32 | 否 | 设备唯一标识 | | **startTime** | 开始时间 | 字符串 | 时间格式yyyy-MM-ddTHH:mm:ss | 是 | 开始时间 | | **endTime** | 结束时间 | 字符串 | 时间格式yyyy-MM-ddTHH:mm:ss | 是 | 结束时间 | | **pageNo** | 起始页 | 整数 | 11 | 否 | 起始条数，默认0 | | **pageSize** | 每页大小 | 整数 | 11 | 否 | 每页大小，默认30，最大可设置为1000 | * **返回内容** **成功时：** > 返回内容 ``` { "code":0, "total":15, "data":[ { "time":"2016-09-29T00:00:00", "content":"告警内容" }, …… ] } ``` > 返回参数说明只包含请求说明中不同的参数，或者与请求参数含义不同的 | **参数名称** | **中文名称** | **类型** | **说明** | | :--- | :--- | :--- | :--- | | **time** | 故障发生时间| 字符串 | 故障发生时间，格式 yyyy-MM-ddTHH:mm:ss | | **content** | 告警内容 | 字符串 | 告警详细内容 | **失败时：** ``` { "code": ERRORCODE //ERRORCODE可以去错误码目录中查找 } ```