# 周期数据统计 * **说明** > 获取设备周期性统计数据。校验条件包括： > * 验证用户是否有权限查看该设备日志 > * 验证设备id是否存在 > * 开始时间、结束时间格式 * **URL**：/v1/user/data/statistic/${did}?aid=XX&type=XX&&period=XX&date=XX * **请求方式**：GET * **Header参数**： | **Header\_Key** | **Header\_Value** | | :---: | :---: | | **ts** | 精确到ms的时间戳 | | **openid** | openid，每个个人用户的唯一标识 | | **applicationid** | 应用ID，每个开发者的唯一标识 | | **sign** | 加密签名，算法为SHA1\(HTTPMethod+RequestURI+params+ts+openkey+applicationkey\) | * **请求内容**： ``` { "did": "deviceId", "aid": "设备属性ID", "type": "统计算法，目前支持传入sum", "period": "统计周期可以传入的值:day,week,month,year", "date": "统计日期" } ``` | **参数名称** | **中文名称** | **类型** | **限制** | **必须** | **说明** | | :--- | :---: | :---: | :---: | :---: | :--- | | **did** | 设备id | 字符串 | 6~32 | 是 | 设备唯一标识 | | **aid** | 数据属性id | 字符串 | 11 | 是 | 平台中设置的设备属性id | | **type** | 统计算法 | 字符串 | 30 | 是 | 统计算法，目前支持传入sum、average、max、min | | **period** | 统计周期 | 字符串 | 30 | 是 | 统计周期可以传入的值:day,week,month,year | | **date** | 统计日期 | 字符串 | 30 | 否 | 统计日期，day传入yyyy-MM-dd，week传入yyyy-WW，month传入yyyy-MM，year传入yyyy | * **返回内容** **成功时：** > 返回内容 ``` { "code": 0, "data":[ { "2016-09-29T00:00:00":11 }, …… ], "max":15, "min":0, "total":15 } ``` > 返回参数说明只包含请求说明中不同的参数，或者与请求参数含义不同的 | **参数名称** | **中文名称** | **类型** | **说明** | | :--- | :--- | :--- | :--- | | **data** | 数据 | JSON数组 | 返回的详细数据 | | **max** | 最大值 | 数字 | data中的最大值 | | **min** | 最小值 | 数字 | data中的最小值 | | **total** | 总值 | 数字 | data中数据总值 | **失败时：** ``` { "code": ERRORCODE //ERRORCODE可以去错误码目录中查找 } ```