华为云用户手册

返回结果 广播名称 广播参数 成员 描述 TOPIC_ LOG IN_CONNECTED IotaMessage对象 （使用intent.getSerializableExtra(LoginService. LOGIN_BROADCAST_MSG_IE_IOTAMSG)方法获取） 无 登录成功或重连成功。 TOPIC_LOGIN_DISCONNECT IotaMessage对象 （使用intent.getSerializableExtra(LoginService. LOGIN_BROADCAST_MSG_IE_IOTAMSG)方法获取） LOGIN_IE_REASON 登录或重连失败原因。 LOGIN_IE_REASON： 枚举项 枚举值 类型 描述 LOGIN_REASON_NULL 0 NA 无原因。 LGN_REASON_CONNCET_ERR 1 NA 连接失败。 LOGIN_REASON_SERVER_BUSY 2 NA 服务器忙。 LOGIN_REASON_AUTH_FAILED 3 NA 鉴权失败、开发者需要停止重新尝试登录。 LOGIN_REASON_NET_UNAVAILABLE 4 NA 网络不可用。 LOGIN_REASON_DEVICE_NOEXIST 5 NA 设备不存在、开发者需要停止重新尝试登录。 LOGIN_REASON_DEVICE_RMVED 6 NA 设备已删除、开发者需要停止重新尝试登录。 LOGIN_REASON_UNKNOWN 7 NA 未知原因。

错误码 Http状态码 错误码 错误描述 说明 200 100601 The number of device in the group has reach the max. 设备组内设备达到最大值。 处理建议：请确认当前设备组内的设备数量在maxDevNum设置值的范围内。 200 100603 The device group is not existed. 设备组不存在。 处理建议：请检查设备组ID是否正确。 400 100604 The device group request parameter is invalid. 请求参数不合法。 处理建议: 请检查接口请求中的设备ID是否有误。 请检查设备组是否达到最大设备数量限制。 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是否有误。 500 100203 The application is not existed. 应用不存在。 处理建议: 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 500 50252 Internal server error. 服务器运行内部错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。

返回值 AuthRefreshOutDTO 参数 类型 描述 scope String(256) 申请的权限范围，参数值固定为default。 tokenType String(256) 鉴权token的类型，参数值固定为bearer。 expiresIn Number(256) 平台生成并返回accessToken的有效时间，单位为秒。 accessToken String(256) 鉴权参数，访问物联网平台API接口的凭证。 refreshToken String(256) 鉴权参数，用来刷新accessToken，refreshToken的有效时间为“1”个月。

错误码 Http状态码 错误码 错误描述 说明 400 100247 Operation not allowed. The application has been frozen. 应用冻结。 处理建议：请检查应用是否因为欠费冻结。 400 102202 Required Parameter is null or empty. 必选参数为空。 处理建议：请检查请求参数中的必选参数是否已填写。 400 50400 The input is invalid. 输入参数无效。 处理建议：请检查接口调用请求中携带参数的合法性。 401 100208 AppId or secret is not right. appId、secret或refreshToken错误。 处理建议： 请检查appId、secret、refreshToken是否有误，是否新增字符或缺少字符。 请检查请求路径中的IP地址是否有误。 500 50252 Internal server error. 服务器运行内部错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。

参数说明 参数 必选/可选 类型 位置 描述 arInDTO 必选 AuthRefreshInDTO body 见下表AuthRefreshInDTO的描述。 AuthRefreshInDTO 参数 必选/可选 类型 位置 描述 appId 必选 String(256) body 访问物联网平台的应用ID，在物联网平台创建应用时由平台分配获得。 secret 必选 String(256) body 访问物联网平台的应用密钥，与appId对应，在物联网平台创建应用时由平台分配获得。 refreshToken 必选 String(256) body 刷新token，用来获取一个新的accessToken。refreshToken在调用鉴权接口或刷新token接口时获得。

错误码 Http状态码 错误码 错误描述 说明 403 1010009 app throttle exceed. 应用调用接口过于频繁，超过流控值（默认值是100次/60s）。 处理建议：联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 Invalid access token or appId. 错误的token信息。 处理建议：请检查接口请求中所携带的accessToken是否有误。

参数说明 参数 必选/可选 类型 位置 描述 subscriptionId 必选 String path 订阅ID号，通过调用订阅接口返回或者查询订阅接口获得。 appId 必选 String query 设备或者规则等订阅内容主体所属的appId。 accessToken 必选 String header 如果调用了定时刷新token接口，此参数值可以填写null，否则要填写鉴权接口获取的accessToken。

错误码 Http状态码 错误码 错误描述 说明 200 100203 The application is not existed. 应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 200 101001 Resource doesn't exist. 资源不存在。 200 105001 The batchTask count has reached the limit. 单个用户未完成的批量任务数大于等于1个时，返回任务达到数量限制。 200 105002 The batchTask name has exist. 任务名字已存在。 处理建议：修改任务名称。 400 105201 The tagName and tagValue has been used on the platform. 平台已使用tagName和tagValue 。 400 50400 The input is invalid. 输入参数无效。 处理建议：请检查接口调用请求中携带参数的合法性。 401 100028 The user has no right. 用户没有操作权限。 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 105202 The tag is not existed. 标签不存在。 500 100203 The application is not existed. 应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 500 50252 Internal server error. 服务器运行内部错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。

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

返回结果 广播名称 广播参数 成员 描述 IOTA_TOPIC_CONNECTED_NTY HW_MSG对象 无 登录成功或重连成功。 IOTA_TOPIC_DISCONNECT_NTY HW_MSG对象 EN_ULGN_IE_ERR_REASON 登录失败或连接断开。 EN_IOTA_LGN_REASON_TYPE： 枚举项 枚举值 描述 EN_IOTA_LGN_REASON_NULL 0 无原因。 EN_IOTA_LGN_REASON_CONNCET_ERR 1 连接失败。 EN_IOTA_LGN_REASON_SERVER_BUSY 2 服务器忙。 EN_IOTA_LGN_REASON_AUTH_FAILED 3 鉴权失败、开发者需要停止重新尝试登录。 EN_IOTA_LGN_REASON_NET_UNAVAILABLE 5 网络不可用。 EN_IOTA_LGN_REASON_DEVICE_NOEXIST 12 设备不存在、开发者需要停止重新尝试登录。 EN_IOTA_LGN_REASON_DEVICE_RMVED 13 设备已删除、开发者需要停止重新尝试登录。 EN_IOTA_LGN_REASON_UNKNOWN 255 未知原因。

示例 1 2 3 4 5 6 7 8 9 10 11 12 13 Config_Get(“DeviceId”,pcDeviceId); Config_Get(“DeviceSecret”,pcDeviceSecret); Config_Get(“AppId”,pcAppId); Config_Get(“HAAddr”,pcHAServerAddr); Config_Get(“LVSAddr”,pcLVSServerAddr); IOTA_SetConfig(EN_IOTA_CFG_DEVICEID, pcDeviceId); IOTA_SetConfig(EN_IOTA_CFG_DEVI CES ECRET, pcDeviceSecret); IOTA_SetConfig(EN_IOTA_CFG_APPID, pcAppId); IOTA_SetConfig(EN_IOTA_CFG_HA_ADDR, pcHAServerAddr); IOTA_SetConfig(EN_IOTA_CFG_LVS_ADDR, pcLVSServerAddr); IOTA_Login(); 然后等待Agent Lite的连接状态广播。 需要提前实现连接状态通知广播接收处理函数，建议： 对于网关设备，在连接成功的处理函数中需要进行非直连设备状态上报的处理，并且将缓存的所有上报数据进行上报。 在连接断开的处理函数中记录设备断开状态，之后如果有数据上报，需要进行缓存，等到连接成功后再进行上报。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 // 开发者注册该函数进行连接成功后的处理 HW_iNT Device_ConnectedHandler(HW_UiNT uiCookie, HW_MSG pstMsg) { //update device states //send buffer data return 0; } // 开发者注册该函数进行连接失败后的处理 HW_iNT Device_DisconnectHandler(HW_UiNT uiCookie, HW_MSG pstMsg) { //stop reporting data return 0; } //绑定广播接收处理函数 HW_BroadCastReg(“IOTA_TOPIC_CONNECTED_NTY”, Device_ConnectedHandler); HW_BroadCastReg(“IOTA_TOPIC_DISCONNECT_NTY”, Device_DisconnectHandler); 设备登录后，表示该设备已经成功的连接到物联网平台。 连接成功后，如果因为网络或服务器原因导致连接断开，Agent Lite会自动尝试重新连接，并将实时状态通过这两个广播上报给第三方应用。

示例 开发者调用设备登出接口。 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 发生拥塞，当前的网络已经被流控。