# 设备数据查询 * **说明** > 查询指定设备上报的历史数据。校验条件包括： > * 验证设备id是否存在 > * 校验起始时间 > * 校验每页大小范围 * **URL**：/v1/user/data/datapoints/${did}?aid=XX&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\) | * **请求内容**： ``` { "aid": "aid", "startTime": "yyyy-MM-ddTHH:mm:ss", "endTime": "yyyy-MM-ddTHH:mm:ss", "pageNo": 0, "pageSize": 30 } ``` | **参数名称** | **中文名称** | **类型** | **限制** | **必须** | **说明** | | :--- | :---: | :---: | :---: | :---: | :--- | | **did** | 设备id | 字符串 | 6~32 | 否 | 设备唯一标识 | | **aid** | 属性id | 整数 | 11 | 是 | 平台中设置的设备属性id | | **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", "aid":"attributeId", "value":"attributeValue" }, …… ] } ``` **失败时：** ``` { "code": ERRORCODE //ERRORCODE可以去错误码目录中查找 } ```