华为云用户手册

示例 开发者调用设备登出接口。 1 LoginService. logout(); 开发者调用登出接口前需要实现Agent Lite提供的观察者接口。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 public class AgentliteLogin implements MyObserver { public AgentliteLogin (Observable loginService) { loginService. registerObserver (this); } //登出结果回调，在AgentliteLogin中重写update方法 @Override public void update(IotaMessage arg0) { // TODO Auto-generated method stub System.out.println("LoginManager收到通知:" + arg0); int mMsgType = arg0.getMsgType(); switch(mMsgType) { case 1: loginResultAction(arg0); break; case 2: logoutResultAction(arg0); break; default: break; } }

参数说明 参数 必选/可选 类型 位置 描述 qbdiInDTO 必选 QueryBatchDevicesInfoInDTO query 见下表PostDeviceCommandInDTO2的描述。 accessToken 必选 String header 如果调用了定时刷新token接口，此参数值可以填写null，否则要填写鉴权接口获取的accessToken。 PostDeviceCommandInDTO2 参数 必选/可选 类型 位置 描述 appId 必选 String query 如果是本应用的设备，此参数值可以填写null，否则填写授权应用的appId。 gatewayId 可选 String query 网关ID，用于标识一个网关设备。 nodeType 可选 String query 节点类型，取值：ENDPOINT/GATEWAY/UNKNOW。 deviceType 可选 String query 设备类型。 pageNo 可选 Integer query 查询的页码。 值为空时查询内容不分页 值大于等于0的整数时分页查询 值等于0时查询第一页 pageSize 可选 Integer query 查询每页信息的数量， 缺省值：1。 status 可选 String query 查询设备的状态。 ONLINE：在线 OFFLINE：不在线 ABNORMAL：异常状态 startTime 可选 String query 查询注册设备信息时间在startTime之后的记录。时间格式：yyyyMMdd'T'HHmmss'Z'，如 20151212T121212Z。 endTime 可选 String query 查询注册设备信息时间在endTime之前的记录。时间格式：yyyyMMdd'T'HHmmss'Z'，如 20151212T121212Z。 sort 可选 String query 指定返回记录的排序。 ASC：按注册设备的时间升序排列 DESC：按注册设备的时间降序排列 缺省值：DESC。 select 可选 String query 指定返回记录，可取值：imsi。

错误码 Http状态码 错误码 错误描述 说明 400 100216 The application input is invalid. 应用输入无效。 处理建议：请参考请求参数说明检查接口请求中的参数是否有误。 400 100218 The gatewayId and pageNo can't be both null. 网关ID和pageNo不能同时为空。 处理建议：请检查请求参数中gatewayId或pageNo是否填写。 400 100405 The request parameter is invalid. 请求参数不合法。 处理建议：请参考请求参数说明检查接口请求中的参数是否有误。 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是否有误。 500 50252 Internal server error. 服务器运行内部错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。

错误码 Http状态码 错误码 错误描述 说明 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是否有误。 404 100225 The resource is not found 找不到资源。 处理建议：请检查订阅类型是否有误。

参数说明 参数 必选/可选 类型 位置 描述 dbsInDTO 必选 DeleteBatchSubInDTO body 见下表DeleteBatchSubInDTO的描述。 accessToken 必选 String header 如果调用了定时刷新token接口，此参数值可以填写null，否则要填写鉴权接口获取的accessToken。 DeleteBatchSubInDTO 参数 必选/可选 类型 位置 描述 appId 可选 String(256) query 设备或者规则等订阅内容主体所属的appId。 notifyType 可选 String(256) query 通知类型，第三方应用可以根据通知类型对消息分别进行处理。 bindDevice（绑定设备） deviceAdded（添加新设备） deviceInfoChanged（设备信息变化） deviceDataChanged（设备数据变化） deviceDatasChanged（设备数据批量变化） deviceCapabilitiesChanged（设备服务能力变化，订阅后推送设备服务能力变化通知） deviceCapabilitiesAdded（设备服务能力增加，订阅后推送设备服务能力增加通知） deviceCapabilitiesDeleted（设备服务能力删除，订阅后推送设备服务能力删除通知） deviceDeleted（删除设备） messageConfirm（消息确认） commandRsp（命令响应） deviceDesiredPropertiesModifyStatusChanged（修改设备影子状态变更） swUpgradeStateChangeNotify（软件升级状态变更通知） swUpgradeResultNotify（软件升级结果通知） fwUpgradeStateChangeNotify（固件升级状态变更通知） fwUpgradeResultNotify（固件升级结果通知） callbackUrl 可选 String(256) query 订阅回调的URL地址。

错误码 Http状态码 错误码 错误描述 说明 200 103028 The license pool resources. License资源用尽。 400 100003 Invalid verify code. 验证码无效。 处理建议：请检查接口请求中的verifyCode是否有误。若请求参数中未带verifyCode，请联系物联网平台维护人员处理。 400 100007 Bad request message. 参数不合法。 处理建议：deviceId未赋值，请参考请求参数说明填写请求。 400 100416 The device has already been binded. 设备已经绑定。 处理建议：请检查设备是否已经注册。 400 100426 The nodeId is duplicated. nodeId重复。 处理建议：请检查接口请求中nodeId是否有误。 400 50400 The input is invalid. 输入参数无效。 处理建议：请检查接口调用请求中携带参数的合法性。 401 100025 AppId for auth not exist. 获取不到appId鉴权信息。 处理建议： 请检查请求结构体的Header头域中是否给字段app_key赋值。 若通过HTTP调用，请联系物联网平台维护人员确认Header头域中放置appId的字段名是app_key还是x-app-key。 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是否有误。 403 600002 The product not existed. 产品不存在。 处理建议：物联网平台未找到productId对应的产品，请检查productId是否有误。 500 100001 Internal server error. 服务内部处理错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。 500 100203 The application is not existed. 授权应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 500 100412 The amount of device has reached the limit. 当前应用下设备数量达到上限。 处理建议：请检查当前应用下的设备数量是否已达到所申请资源的上限。 500 100441 The amount of nonSecure device has reached the limit. 非安全设备数量已达到上限。 处理建议： 请注册安全设备（“isSecure”参数设置为“true”），即设备使用安全协议方式接入。 请联系物联网平台维护人员处理。 500 103026 The license is not exist. License不存在。 处理建议：物联网平台内部License问题，请联系物联网平台维护人员处理。 500 50252 Internal server error. 服务器运行内部错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。

返回值 RegDirectDeviceOutDTO 参数 类型 描述 deviceId String(256) 设备ID，用于唯一标识一个设备。 verifyCode String(256) 验证码，设备可以通过验证码获取设备ID和密码。若在请求中指定verifyCode，则响应中返回请求中指定的verifyCode；若请求中不指定verifyCode，则由物联网平台自动生成。 timeout Number 验证码有效时间，单位秒，设备需要在有效时间内接入物联网平台。 psk String(32) 随机psk参数，若请求中携带了psk，则使用请求中的psk，否则由平台生成随机psk参数。

错误码 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是否有误。 500 50252 Internal server error. 服务器运行内部错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。

参数说明 参数 必选/可选 类型 位置 描述 qddhInDTO 必选 QueryDeviceDesiredHistoryInDTO query 见下表QueryDeviceDesiredHistoryInDTO的描述。 accessToken 必选 String header 填写鉴权接口获取的accessToken。 QueryDeviceDesiredHistoryInDTO 参数 必选/可选 类型 位置 描述 appId 必选 String query 如果是本应用的设备，此参数值可以填写None，否则填写授权应用的appId。 deviceId 必选 String query 设备ID，用于唯一标识一个设备。 gatewayId 必选 String query 网关ID，用于标识一个网关设备。 serviceId 可选 String query 设备的服务标识。 property 可选 String query 服务属性数据。 pageNo 可选 Integer query 查询的页码。 值为空时查询内容不分页 值大于等于0的整数时分页查询 值等于0时查询第一页 pageSize 可选 Integer query 查询每页信息的数量， 缺省值：“1”。 startTime 可选 String query 查询产生时间在startTime之后的历史数据。时间格式：yyyyMMdd'T'HHmmss'Z'，如 “20151212T121212Z”。 endTime 可选 String query 查询产生时间在endTime之前的历史数据。时间格式：yyyyMMdd'T'HHmmss'Z'，如 “20151212T121212Z”。

错误码 Http状态码 错误码 错误描述 说明 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是否有误。 404 100403 The device is not existed. 设备不存在。 处理建议：物联网平台未找到deviceId对应的设备，请检查deviceId是否有误。 404 100418 The deviceData is not existed. 设备信息不存在。 处理建议： 请求参数中携带的deviceId错误。请确认该deviceId是否属于该appId或者deviceId是否写错。 Header中携带的appId有误，请确认该appId下是否有该deviceId。 如果URL中携带了可选参数appId，请检查该appId是否有误。 500 100203 The application is not existed. 应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 500 50252 Internal server error. 服务器运行内部错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。

参数说明 参数 必选/可选 类型 位置 描述 deviceId 必选 String path 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 cascade 必选 Boolean query 仅当设备下连接了非直连设备时生效，不设置时可填写null。 true，级联删除，即删除直连设备和其下的非直连设备。 false，删除直连设备，但是不删其下的非直连设备，并将非直连设备的属性变为直连设备属性。 appId 必选 String query 如果是本应用的设备，此参数值可以填写null，否则填写授权应用的appId。 accessToken 必选 String header 如果调用了定时刷新token接口，此参数值可以填写null，否则要填写鉴权接口获取的accessToken。

错误码 Http状态码 错误码 错误描述 说明 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是否有误。 404 100225 The resource is not found 找不到资源。 处理建议：请检查订阅ID是否有误。

参数说明 枚举项 枚举值 类型 描述 EN_IOTA_DATATRANS_IE_RESULT 0 unsigned int 命令执行返回结果。 成功：0。 失败：1。 EN_IOTA_DATATRANS_IE_DEVICEID 1 String 设备ID。 EN_IOTA_DATATRANS_IE_REQUESTID 2 String 请求ID。 EN_IOTA_DATATRANS_IE_SERVICEID 3 String 服务ID。 EN_IOTA_DATATRANS_IE_METHOD 4 String 服务方法。 EN_IOTA_DATATRANS_IE_CMDCONTENT 5 String 命令内容，以Json格式进行拼装的服务命令参数，开发者根据对应服务命令的定义进行Json解析，从而获取命令参数值。

示例 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 // 开发者注册该函数进行命令接收的处理 HW_iNT Switch_CommandRecvtHandler(HW_UiNT uiCookie, HW_MSG pstMsg) { HW_cHAR *pcMethod, *pcServiceId, *pcCmdContent, *pcDeviceId; pcDeviceId = HW_MsgGetStr(pstMsg, EN_IOTA_DATATRANS_IE_DEVICEID); pcServiceId = HW_MsgGetStr(pstMsg, EN_IOTA_DATATRANS_IE_SERVICEID); pcMethod = HW_MsgGetStr(pstMsg, EN_IOTA_DATATRANS_IE_METHOD); pcCmdContent = HW_MsgGetStr(pstMsg, EN_IOTA_DATATRANS_IE_CMDCONTENT); if (strcmp(pcServiceId, “switch”)) { //根据Proflie定义的命令参数，使用Json组件解析pcCmdContent //Send command to Switch } return 0; } //在设备添加成功后立即注册设备命令接收广播 HW_BroadCastReg(“IOTA_TOPIC_SERVICE_CMD_RECEIVE/XXXX_XXXX_XXXX_XXXX”, Device_AddResultHandler); 开发者需要在设备添加成功后注册该设备的命令接收广播，广播主题为 “IOTA_TOPIC_SERVICE_CMD_RECEIVE/设备ID”，Agent Lite收到平台发往给设备的命令后会直接广播给该设备注册的广播处理函数。如果开发者不需要按设备进行分发，直接使用主题名即可，即“ IOTA_TOPIC_SERVICE_CMD_RECEIVE”。

返回值 RegDirectDeviceOutDTO 参数 类型 描述 deviceId String(256) 设备ID，用于唯一标识一个设备。 verifyCode String(256) 设备验证码，设备可以通过验证码完成物联网平台的接入认证。若在请求中指定verifyCode，则响应中返回请求中指定的verifyCode；若请求中不指定verifyCode，则由物联网平台自动生成。 timeout Integer 验证码有效时间，单位秒，设备需要在有效时间内接入物联网平台。若为“0”，则表示设备验证码不会失效。 psk String(32) 随机psk参数，若请求中携带了psk，则使用请求中的psk，否则由平台生成随机psk参数。

错误码 Http状态码 错误码 错误描述 说明 200 103028 The license pool resources. License资源用尽。 400 100003 Invalid verify code. 验证码无效。 处理建议：请检查接口请求中的verifyCode是否有误。若请求参数中未带verifyCode，请联系物联网平台维护人员处理。 400 100007 Bad request message. 参数不合法。 处理建议：deviceId未赋值，请参考请求参数说明填写请求。 400 100416 The device has already been binded. 设备已经绑定。 处理建议：请检查设备是否已经注册。 400 100426 The nodeId is duplicated. nodeId重复。 处理建议：请检查接口请求中nodeId是否有误。 400 50400 The input is invalid. 输入参数无效。 处理建议：请检查接口调用请求中携带参数的合法性。 401 100025 AppId for auth not exist. 获取不到appId鉴权信息。 处理建议： 请检查请求结构体的Header头域中是否给字段app_key赋值。 若通过HTTP调用，请联系物联网平台维护人员确认Header头域中放置appId的字段名是app_key还是x-app-key。 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是否有误。 403 600002 The product not existed. 产品不存在。 处理建议：物联网平台未找到productId对应的产品，请检查productId是否有误。 500 100001 Internal server error. 服务内部处理错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。 500 100203 The application is not existed. 授权应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 500 100412 The amount of device has reached the limit. 当前应用下设备数量达到上限。 处理建议：请检查当前应用下的设备数量是否已达到所申请资源的上限。 500 100441 The amount of nonSecure device has reached the limit. 非安全设备数量已达到上限。 处理建议： 请注册安全设备（“isSecure”参数设置为“true”），即设备使用安全协议方式接入。 请联系物联网平台维护人员处理。 500 103026 The license is not exist. License不存在。 处理建议：物联网平台内部License问题，请联系物联网平台维护人员处理。 500 50252 Internal server error. 服务器运行内部错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。

错误码 Http状态码 错误码 错误描述 说明 200 100203 The application is not existed. 应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 400 100022 The input is invalid. 输入参数无效。 处理建议：请检查接口调用请求中携带参数的合法性。 400 100440 The isSecure is invalid. isSecure参数值有误。 400 50400 The input is invalid. 输入参数无效。 处理建议：请检查接口调用请求中携带参数的合法性。 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是否有误。 403 500004 The amount of frozen devices has reached the limit. 被冻结设备已达到上限。 404 100403 The device is not existed. 设备不存在。 处理建议：物联网平台未找到deviceId对应的设备，请检查deviceId是否有误。 404 100418 The deviceData is not existed. 设备信息不存在。 处理建议： 请求参数中携带的deviceId错误。请确认该deviceId是否属于该appId或者deviceId是否写错。 Header中携带的appId有误，请确认该appId下是否有该deviceId。 如果URL中携带了可选参数appId，请检查该appId是否有误。 500 100203 The application is not existed. 应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 500 100441 The amount of nonSecure device has reached the limit. 非安全设备数量已达到上限。 500 50252 Internal server error. 服务器运行内部错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。

错误码 Http状态码 错误码 错误描述 说明 200 100203 The application is not existed. 应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 200 100217 The application hasn't been authorized. 应用未被授权。 处理建议：若非应用授权场景，请确认请求参数中的appId为空。 200 100602 The device group name has been used. 设备组名字已经存在。 处理建议：请修改接口请求中的设备组名称。 200 100607 The devGroup has reached the limit. 设备组数目达到限制。 处理建议：请检查已创建的设备组数量是否已达到License限定的数量上限。 400 100609 Too much devices to add. 添加太多设备至设备组。 处理建议：请确认deviceIds中的设备ID数量在maxDevNum设置值的范围内。 400 50400 The input is invalid. 输入参数无效。 处理建议：请检查接口调用请求中携带参数的合法性。 403 1010009 app throttle exceed. 应用调用接口过于频繁，超过流控值（默认值是100次/60s）。 处理建议：联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 Invalid access token or appId. 错误的token信息。 处理建议：请检查接口请求中所携带的accessToken是否有误。 500 50252 Internal server error. 服务器运行内部错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。

错误码 Http状态码 错误码 错误描述 说明 200 100203 The application is not existed. 应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 200 100217 The application hasn't been authorized. 应用未被授权。 处理建议：若非应用授权场景，请确认请求参数中的appId为空。 200 100418 The deviceData is not existed. 设备信息不存在。 处理建议： 请求参数中携带的deviceId错误。请确认该deviceId是否属于该appId或者deviceId是否写错。 Header中携带的appId有误，请确认该appId下是否有该deviceId。 如果URL中携带了可选参数appId，请检查该appId是否有误。 200 100428 The device is not online. 设备不在线。 处理建议：请检查设备与物联网平台的连接是否正常。 200 100431 The serviceType is not exist. 服务类型不存在。 处理建议： 请检查该设备的Profile文件是否已上传到物联网平台。 请检查请求参数是否正确，或者serviceId在Profile文件中是否存在。 400 100022 The input is invalid. 输入参数无效。 处理建议： 请确认startTime和endTime都不为空，且endTime比startTime晚。 请确认pageNo不为空，且pageNo大于0。 请检查pageSize不为空，且pageSize大于1。 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 100001 Internal server error. 服务内部处理错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。 500 100023 The data in dataBase is abnomal. 数据库异常。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。 500 100220 Get AppKey from header failed. 获取appKey失败。 处理建议 : 请检查接口请求的header中是否携带appId。 500 101016 Get iotws address failed. 获取iotws地址失败。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。 500 101017 Get newCallbackUrl from oss failed. 从oss获取新的回调地址失败。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。 503 100501 Congestion occurs, and the current network has been flow-controlled 发生拥塞，当前的网络已经被流控。

错误码 Http状态码 错误码 错误描述 说明 400 120015 Bad request error. 请求错误。 处理建议：请检查接口请求中fileId的格式是否正确。 403 1010009 app throttle exceed. 应用调用接口过于频繁，超过流控值（默认值是100次/60s）。 处理建议：联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 Invalid access token or appId. 错误的token信息。 处理建议：请检查接口请求中所携带的accessToken是否有误。 404 123002 Device or package file not found. 设备或包不存在。 处理建议：请检查接口请求中的fileId是否正确。

响应参数 QueryUpgradePackageOutDTO 参数 类型 描述 fileId String 版本包ID。 name String 版本包名称。 version String 版本包的版本号。 fileType String 版本包类型。 firmwarePackage：固件包 softwarePackage：软件包 deviceType String 版本包适用的设备类型。 model String 版本包适用的设备型号。 manufacturerName String 版本包适用的设备厂商名称。 protocolType String 版本包适用的设备协议类型。 description String 版本包的描述信息。 date String 版本包的生成时间。 uploadTime String 版本包的上传日期。

注意事项 调用此接口后，SDK会启动一个线程自动刷新accessToken，且accessToken只在SDK内部管理，第三方应用不必关心；调用其他业务接口时，accessToken直接传入null即可（如果传入的accessToken不是null，则使用传入的accessToken）。 可以调用stopRefreshTokenTimer()方法停止线程，一旦调用了stopRefreshTokenTimer()方法，调用其他业务接口，accessToken不可为null，accessToken转由第三方应用自行管理。

参数说明 参数 必选/可选 类型 位置 描述 smdInDTO 必选 SubDeviceManagementDataInDTO body 见下表SubDeviceManagementDataInDTO的描述。 accessToken 必选 String header 如果调用了定时刷新token接口，此参数值可以填写null，否则要填写鉴权接口获取的accessToken。 SubDeviceManagementDataInDTO 参数 必选/可选 类型 位置 描述 notifyType 必选 String body 通知类型。 swUpgradeStateChangeNotify（软件升级状态变更通知，订阅后推送软件升级状态变更通知） swUpgradeResultNotify（软件升级结果通知，订阅后推送软件升级结果通知） fwUpgradeStateChangeNotify（固件升级状态变更通知，订阅后推送固件升级状态变更通知） fwUpgradeResultNotify（固件升级结果通知，订阅后推送固件升级结果通知） callbackurl 必选 String body 订阅的回调地址，用于接收对应类型的通知消息。 必须使用HTTPS信道回调地址，同时回调地址中必须指定回调地址的端口。例如：https://XXX.XXX.XXX.XXX:443/callbackurltest 说明： HTTP信道只可用于调测。

错误码 Http状态码 错误码 错误描述 说明 400 100222 Internal server error. 回调地址非法。 处理建议：请检查请求体中的回调地址是否有误。 400 100228 The application input is invalid. 应用输入无效。 处理建议：请参考请求参数说明检查接口请求中的参数是否有误。 403 100203 The application is not existed. 应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 403 1010009 app throttle exceed. 应用调用接口过于频繁，超过流控值（默认值是100次/60s）。 处理建议：联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 Invalid access token or appId. 错误的token信息。 处理建议：请检查接口请求中所携带的accessToken是否有误。 500 100229 Get AppKey from header failed. 从消息头获取AppKey失败。 500 100244 register out route fail. 注册路由失败。 处理建议：联系物联网平台维护人员。

参数说明 参数 必选/可选 类型 位置 描述 smdInDTO 必选 SubDeviceManagementDataInDTO body 见下表SubDeviceManagementDataInDTO的描述。 accessToken 必选 String header 填写鉴权接口获取的accessToken。 SubDeviceManagementDataInDTO 参数 必选/可选 类型 位置 描述 notifyType 必选 String body 通知类型。 swUpgradeStateChangeNotify（软件升级状态变更通知，订阅后推送软件升级状态变更通知） swUpgradeResultNotify（软件升级结果通知，订阅后推送软件升级结果通知） fwUpgradeStateChangeNotify（固件升级状态变更通知，订阅后推送固件升级状态变更通知） fwUpgradeResultNotify（固件升级结果通知，订阅后推送固件升级结果通知） callbackurl 必选 String body 订阅的回调地址，用于接收对应类型的通知消息。 必须使用HTTPS信道回调地址，同时回调地址中必须指定回调地址的端口。例如：https://XXX.XXX.XXX.XXX:443/callbackurltest 说明： HTTP信道只可用于调测。

错误码 Http状态码 错误码 错误描述 说明 400 100222 Internal server error. 回调地址非法。 处理建议：请检查请求体中的回调地址是否有误。 400 100228 The application input is invalid. 应用输入无效。 处理建议：请参考请求参数说明检查接口请求中的参数是否有误。 403 100203 The application is not existed. 应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 403 1010009 app throttle exceed. 应用调用接口过于频繁，超过流控值（默认值是100次/60s）。 处理建议：联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 Invalid access token or appId. 错误的token信息。 处理建议：请检查接口请求中所携带的accessToken是否有误。 500 100229 Get AppKey from header failed. 从消息头获取AppKey失败。 500 100244 register out route fail. 注册路由失败。 处理建议：联系物联网平台维护人员。

错误码 Http状态码 错误码 错误描述 说明 400 100022 The input is invalid 输入参数无效。 处理建议：请检查接口调用请求中携带参数的合法性。 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是否有误。 404 105005 The batchTask is not existed. 批量任务不存在。 处理建议：请检查接口请求中的taskId是否有误。 500 100203 The application is not existed. 应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 500 50252 Internal server error. 服务器运行内部错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。

参数说明 参数 必选/可选 类型 位置 描述 qtdInDTO 必选 QueryTaskDetailsInDTO query 见下表QueryTaskDetailsInDTO的描述。 accessToken 必选 String header 填写鉴权接口获取的accessToken。 QueryTaskDetailsInDTO 参数 必选/可选 类型 位置 描述 appId 可选 String query 如果是本应用的任务，此参数值可以填写None，否则填写授权应用的appId。 taskId 必选 String query 批量任务的ID。 status 可选 String query 任务的详情状态，“Pending/Success/Fail/Timeout”。 deviceId 可选 String query 设备Id，查询批量命令任务时使用。 commandId 可选 String query 命令Id，查询批量命令任务时使用。 pageNo 可选 Integer query 分页查询参数。 值为空时，查询内容不分页。 值为大于等于0的整数时，分页查询。 值为0时查询第一页。 pageSize 可选 Integer query 分页查询参数，取值大于等于1的整数，缺省值：“1”。

参数说明 参数 必选/可选 类型 位置 描述 devGroupId 必选 String path 设备组ID，在增加设备组后由物联网平台返回获得。 accessAppId 可选 String query 如果是本应用的设备组，此参数值可以填写null，否则填写授权应用的appId。 accessToken 必选 String header 如果调用了定时刷新token接口，此参数值可以填写null，否则要填写鉴权接口获取的accessToken。

错误码 Http状态码 错误码 错误描述 说明 200 100203 The application is not existed. 应用不存在。 处理建议: 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 200 100217 The application hasn't been authorized. 应用未被授权。 处理建议：若非应用授权场景，请确认请求参数中的appId为空。 200 100603 The device group is not existed. 设备组不存在。 处理建议：请检查设备组ID是否正确。 403 1010009 app throttle exceed. 应用调用接口过于频繁，超过流控值（默认值是100次/60s）。 处理建议：联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 Invalid access token or appId. 错误的token信息。 处理建议：请检查接口请求中所携带的accessToken是否有误。 500 50252 Internal server error. 服务器运行内部错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。