redHistory DTO
List<DeviceDes iredHistoryDTO
>
设备历史数据列表，具体参见
DeviceDesiredHistoryDTO结构体。
DeviceDesiredHistoryDTO结构体说明：
参数 类型 描述
serviceId String(256) 设备的服务标识。
deviceId String(256) 设备ID，用于唯一标识一个设备。
gatewayId String(256) 网关ID，用于标识一个网关设备。
appId String(256) 第三方应用的身份标识，用于唯一标识一个应用。
desired JsonObject 设备上报的数据。
timestamp String(256) 上报数据的时间戳，时间格式：
yyyyMMdd'T'HHmmss'Z'，如
“20151212T121212Z”。
错误码
Http状态 码
错误码 错误描述 说明
200 100203 The application is
not existed. 应用不存在。
处理建议：
● 请检查HTTP请求头域中携带的 appId是否有误。
● 请检查请求路径（url）中传入 的appId是否有误。
400 100216 The application
input is invalid. 应用输入无效。
处理建议：请参考请求参数说明 检查接口请求中的参数是否有 误。
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 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是否有误。
Http状态 码
错误码 错误描述 说明
500 50252 Internal server error. 服务器运行内部错误。
处理建议：物联网平台内部错 误，请联系物联网平台维护人员 处理。
4.3.5.5 查询设备服务能力
典型场景
第三方应用若需要了解设备可上报哪些服务属性数据，以及设备支持下发哪些命令，
可调用此接口在物联网平台查询设备的Profile文件中定义的设备服务能力信息。
接口功能
支持第三方应用在物联网平台查询设备的服务属性、设备命令等服务能力信息。
接口描述
def queryDeviceCapabilities(self, qdcInDTO, accessToken)
参数说明
参数 必选/可
选
类型 位置 描述
qdcInDTO 必选 QueryDevic eCapabilitie sInDTO
query 见下表
QueryDeviceCapabilitiesInDTO 的描述。
accessTok
en 必选 String header 填写鉴权接口获取的 accessToken。
QueryDeviceCapabilitiesInDTO
参数 是否必
须
类型 位置 描述
gatewayI
d 可选 String query 网关ID，用于标识一个网关设备。
appId 必选 String query 如果是本应用的设备，此参数值可以 填写None，否则填写授权应用的 appId。
响应参数
QueryDeviceCapabilitiesOutDTO
参数 类型 描述
deviceCapabil
ities List<DeviceCapab
ilityDTO> 查询结果列表，具体参见
DeviceCapabilityDTO结构体。
DeviceCapabilityDTO结构体说明：
参数 类型 描述
deviceId String(256) 设备ID，用于唯一标识一个设备。
serviceCa
pabilities List<ServiceCapa
bilityDTO> 设备的服务能力列表，具体参见
ServiceCapabilityDTO结构体。
ServiceCapabilityDTO结构体说明：
参数 类型 描述
serviceId String(256) 设备的服务标识。
serviceTyp
e String(256) 设备的服务类型。
option String(256) 服务选项。
description String(10240) 设备服务描述信息。
commands List<ServiceCom
mand> 支持的命令名称列表，具体参见
ServiceCommand结构体。
properties List<ServiceProp
erty> 支持的属性名称列表，具体参见ServiceProperty 结构体。
ServiceCommand结构体说明：
参数 类型 描述
command
Name String(256) 命令名称。
paras List<ServiceCom
mandPara> 属性列表，具体参见ServiceCommandPara结构 体。
responses List<ServiceCom
mandResponse> 响应列表，具体参见