QuerySingleDeviceInfoOutDTO结构体。
4.3.5.3 查询设备历史数据 典型场景典型场景
403 1010009 app throttle exceed. 应用调用接口过于频繁，超过流 控值（默认值是100次/60s）。
处理建议：联系物联网平台维护 人员调大流控阈值或者控制接口 的调用频率。
403 1010005 Invalid access token
or appId. 错误的token信息。
处理建议：请检查接口请求中所 携带的accessToken是否有误。
500 100203 The application is not
existed. 应用不存在。
处理建议：
● 请检查HTTP请求头域中携带 的appId是否有误。
● 请检查请求路径（url）中传 入的appId是否有误。
500 50252 Internal server error. 服务器运行内部错误。
处理建议：物联网平台内部错 误，请联系物联网平台维护人员 处理。
4.3.5.3 查询设备历史数据 典型场景
在日常运行中，物联网平台会收到并保存设备上报业务数据（默认保留时间为7天），
第三方应用若需要查看某个设备上报到平台的历史数据，可调用此接口查询获取。
接口功能
支持第三方应用根据设备ID，查询指定设备上报到物联网平台的历史数据。
接口描述
def queryDeviceDataHistory(self, qddhInDTO, accessToken)
参数说明
参数 必选/可
选
类型 位置 描述
qddhInDT
O 必选 QueryDevic eDataHisto
appId 必选 String query 如果是本应用的设备，此参数值可以填写 None，否则填写授权应用的appId。
deviceI
d 必选 String query 设备ID，用于唯一标识一个设备。
gatewa
yId 必选 String query 网关ID，用于标识一个网关设备。
serviceI
me 可选 String query 查询产生时间在startTime之后的历史数 据。时间格式：yyyyMMdd'T'HHmmss'Z'，
如 “20151212T121212Z”。
endTim
e 可选 String query 查询产生时间在endTime之前的历史数据。
时间格式：yyyyMMdd'T'HHmmss'Z'，如
“20151212T121212Z”。
响应参数
QueryDeviceDataHistoryOutDTO
参数 类型 描述
totalCount Long 查询的记录数量。
pageNo Long 查询的页码。
pageSize Long 查询每页信息的数量。
deviceDataHi
storyDTOs List<DeviceDataH
istoryDTO> 设备历史数据列表，具体参见
DeviceDataHistoryDTO结构体。
DeviceDataHistoryDTO结构体说明：
参数 类型 描述
serviceId String(256) 设备的服务标识。
deviceId String(256) 设备ID，用于唯一标识一个设备。
gatewayId String(256) 网关ID，用于标识一个网关设备。
appId String(256) 第三方应用的身份标识，用于唯一标识一个 应用。
data JsonObject 设备上报的数据。
timestamp String(256) 上报数据的时间戳，时间格式：
yyyyMMdd'T'HHmmss'Z'，如：
“20151212T121212Z”。
错误码
Http状 态码
错误码 错误描述 说明
200 100418 The deviceData is
not existed. 设备信息不存在。
处理建议：
● 请求参数中携带的deviceId错误。
请确认该deviceId是否属于该 appId或者deviceId是否写错。
● Header中携带的appId有误，请确 认该appId下是否有该deviceId。
● 如果URL中携带了可选参数
appId，请检查该appId是否有误。
Http状 态码
错误码 错误描述 说明
400 100216 The application input
is invalid. 应用输入无效。
处理建议：请参考请求参数说明检查 接口请求中的参数是否有误。例如，
pageSize是否超过2000。
400 100419 The deviceId and gatewayId can't be both null.
deviceId和gatewayId不能同时为空。
处理建议：请检查请求参数中 deviceId和gatewayId是否填写。
403 100203 The application is
not existed. 应用不存在。
处理建议：
● 请检查HTTP请求头域中携带的 appId是否有误。
● 请检查请求路径（url）中传入的 appId是否有误。
403 100217 The application hasn't been authorized.
应用未被授权。
处理建议：若非应用授权场景，请确 认请求参数中的appId为空。
403 101000
9 app throttle exceed. 应用调用接口过于频繁，超过流控值
（默认值是100次/60s）。
处理建议：联系物联网平台维护人员 调大流控阈值或者控制接口的调用频 率。
403 101000
5 Invalid access token
or appId. 错误的token信息。
处理建议：请检查接口请求中所携带 的accessToken是否有误。
500 100203 The application is
not existed. 应用不存在。
处理建议：
● 请检查HTTP请求头域中携带的 appId是否有误。
● 请检查请求路径（url）中传入的 appId是否有误。
500 50252 Internal server error. 服务器运行内部错误。
处理建议：物联网平台内部错误，请 联系物联网平台维护人员处理。