云服务器内容精选
-
参数说明 参数 必选/可选 类型 位置 描述 taskId 必选 String path 批量任务ID,创建批量任务后获得。 select 必选 String query 指定可选的返回值,可取值:tag。不指定时可填写null。 appId 必选 String query 如果是本应用的任务,此参数值可以填写null,否则填写授权应用的appId。 accessToken 必选 String header 如果调用了定时刷新token接口,此参数值可以填写null,否则要填写鉴权接口获取的accessToken。
-
错误码 Http状态码 错误码 错误描述 说明 400 100019 Illegal request. 非法请求。 处理建议:请检查接口请求中的必须参数是否为空。 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是否有误。
-
示例 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 // 开发者调用该接口进行设备删除 HW_cHAR *pcDeviceId = stDevice.pcDeviceId; IOTA_HubDeviceRemove(HW_NULL, pcDeviceId); 结果处理: HW_iNT Device_RemoveResultHandler(HW_UiNT uiCookie, HW_MSG pstMsg) { uiResult = HW_MsgGetUint (pstMsg, EN_IOTA_HUB_IE_RESULT); if (EN_IOTA_HUB_RESULT_SUC CES S != uiResult) { // retry with uiCookie return 0; } return 0; } HW_BroadCastReg(“IOTA_TOPIC_HUB_RMVDEV_RSP”, Device_RemovResultHandler);
-
返回结果 广播名称 广播参数 成员 描述 IOTA_TOPIC_HUB_RMVDEV_RSP HW_MSG对象 EN_IOTA_HUB_IE_TYPE 删除结果。 EN_IOTA_HUB_IE_TYPE: 枚举项 枚举值 类型 描述 EN_IOTA_HUB_IE_RESULT 0 EN_IOTA_HUB_RESULT_TYPE 添加/删除执行结果。 EN_IOTA_HUB_IE_DEVICEID 1 String 添加成功后分配的设备ID。 EN_IOTA_HUB_RESULT_TYPE: 枚举项 枚举值 描述 EN_IOTA_HUB_RESULT_SUCCESS 0 添加/删除执行成功。 EN_IOTA_HUB_RESULT_DEVICE_EXIST 1 设备已存在。 EN_IOTA_HUB_RESULT_DEVICE_NOTEXIST 2 设备不存在。 EN_IOTA_HUB_RESULT_DEVICE_FAILED 255 执行失败。
-
错误码 Http状态码 错误码 错误描述 说明 400 100247 Operation not allowed. The application has been frozen. 应用冻结。 处理建议:请检查应用是否因为欠费冻结。 400 102202 Required Parameter is null or empty. 必选参数为空。 处理建议:请检查请求参数中的必选参数是否已填写。 401 100208 AppId or secret is not right. appId或secret错误。 处理建议: 请检查appId和secret是否有误,是否新增字符或缺少字符。 请检查请求路径中的IP地址是否有误。 500 50252 Internal server error. 服务器运行内部错误。 处理建议:物联网平台内部错误,请联系物联网平台维护人员处理。
-
返回值 AuthOutDTO 参数 类型 描述 scope String(256) 申请权限范围,即accessToken所能访问物联网平台资源的范围,参数值固定为default。 tokenType String(256) accessToken的类型,参数值固定为bearer。 expiresIn Number(256) 平台生成并返回accessToken的有效时间,单位为秒。 accessToken String(256) 鉴权参数,访问物联网平台API接口的凭证。 refreshToken String(256) 鉴权参数,用来刷新accessToken,refreshToken的有效时间为“1”个月。
-
参数说明 参数 必选/可选 类型 位置 描述 clientInfo 必选 ClientInfo - 见下表ClientInfo的描述。 ClientInfo 参数 必选/可选 类型 位置 描述 platformIp 必选 String(256) path 设置平台的IP。 platformPort 必选 String(256) path 设置平台的端口,如“8743”。 appId 必选 String(256) body 访问物联网平台的应用ID,在物联网平台创建应用时由平台分配获得。 secret 必选 String(256) body 访问物联网平台的应用密钥,与appId对应,在物联网平台创建应用时由平台分配获得。
-
错误码 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 100432 The device command is muted. 设备命令已被禁用。 处理建议:请检查接口请求参数method中的命令是否有误。 400 100022 The input is invalid. 输入参数无效。 处理建议:请检查接口调用请求中携带参数的合法性。 400 102203 CommandName is invalid. 命令名称无效。 处理建议:请检查接口请求参数method中携带的命令是否有误。 403 100450 The gateway is not online. 网关不在线。 处理建议:请检查网关与物联网平台的连接是否正常。 403 1010009 app throttle exceed. 应用调用接口过于频繁,超过流控值(默认值是100次/60s)。 处理建议:联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 Invalid access token or appId. 错误的token信息。 处理建议:请检查接口请求中所携带的accessToken是否有误。 404 100444 The serviceType is not exist. 服务类型不存在。 处理建议:请检查接口请求参数toType中的服务类型是否有误。 500 100001 Internal server error. 服务内部处理错误。 处理建议:物联网平台内部错误,请联系物联网平台维护人员处理。 500 100023 The data in dataBase is abnomal. 数据库异常。 处理建议:物联网平台内部错误,请联系物联网平台维护人员处理。 500 50252 Internal server error. 服务内部处理错误。 处理建议:物联网平台内部错误,请联系物联网平台维护人员处理。 503 100501 Congestion occurs, and the current network has been flow-controlled 发生拥塞,当前的网络已经被流控。
-
典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令,第三方应用可调用此接口向设备下发命令,配置或修改设备的服务属性,以实现对设备的控制。 物联网平台不对设备命令进行缓存而是直接下发命令,设备不在线时命令下发失败。下发命令的具体格式需要第三方应用与设备自定义,物联网平台在接口中直接进行封装,透传。 此接口适用于使用MQTT协议接入的设备,例如集成了AgentLite SDK的设备。
-
参数说明 参数 必选/可选 类型 位置 描述 commandDTO 必选 CommandDTO body 见下表CommandDTO的描述。 deviceId 必选 String(1-64) path 设备ID,用于唯一标识一个设备。 serviceId 必选 String(1-64) path 服务ID,唯一标识一个服务。 appId 可选 String query 如果是本应用的设备,此参数值可以填写None,否则填写授权应用的appId。 accessToken 必选 String header 填写鉴权接口获取的accessToken。 CommandDTO 参数 必选/可选 类型 位置 描述 header 必选 CommandNA2CloudHeader body 具体参见CommandNA2CloudHeader结构体。 body 可选 Object body 消息的消息体。JsonObject里面是一个个健值对。每个健都是profile中命令的参数名(paraName)。 CommandNA2CloudHeader结构体说明: 参数 必选/可选 类型 位置 描述 requestId 可选 String(0-128) body 用于标识一个命令,不能重复。 mode 必选 Enum body 是否要确认消息。 “NOACK”:不需要确认消息 “ACK”:需要确认消息 其它值无效 from 可选 String(128) body 表示消息发布者的地址。 App发起的请求:“/users/{userId}” 第三方应用发起的请求:“/{serviceName}” 物联网平台发起的请求:“/cloud/{serviceName}” toType 可选 Enum body 消息接受者的类型,“CLOUD/GATEWAY”。 to 可选 String(128) body 消息接收者的地址。 method 必选 String(1-32) body 命令名称,如:“DISCOVERY”为发现非直连设备,“REMOVE”为删除非直连设备。 callbackURL 可选 String(1024) body 命令的回调路径。
-
响应参数 InvokeDeviceServiceOutDTO 参数 类型 描述 status String(128) 命令状态。 “sent”:已发送 “deliveried”:已投递,toType为“CLOUD”的请求才有该返回值 “failed”:失败,toType为“CLOUD”的请求才有该返回值 timestamp String(128) 发送命令的时间戳,时间格式:yyyyMMdd'T'HHmmss'Z', 如“20151212T121212Z”。 requestId String(128) 设备命令ID。 toType为“GATEWAY”时,如果请求有requestId则同请求的requestId一致,如果请求无requestId则平台分配一个序列号。 toType为“CLOUD”时,则为空。
-
参数说明 参数 必选/可选 类型 位置 描述 cdcctInDTO 必选 CreateDeviceCmdCancelTaskInDTO body 见下表CreateDeviceCmdCancelTaskInDTO的描述。 appId 可选 String query 如果是本应用的设备,此参数值可以填写None,否则填写授权应用的appId。 accessToken 必选 String header 填写鉴权接口获取的accessToken。 CreateDeviceCmdCancelTaskInDTO 参数 必选/可选 类型 位置 描述 deviceId 必选 String(1-64) body 待撤销设备命令的设备ID,撤销任务将会撤销所有向该设备下发的命令。
-
错误码 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是否有误。 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是否有误。 500 100001 Internal server error. 服务内部处理错误。 处理建议:物联网平台内部错误,请联系物联网平台维护人员处理。 500 100220 Get AppKey from header failed. 获取appKey失败。 处理建议 : 请检查接口请求的header中是否携带appId。 503 100501 Congestion occurs, and the current network has been flow-controlled 发生拥塞,当前的网络已经被流控。
-
错误码 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. 服务器运行内部错误。 处理建议:物联网平台内部错误,请联系物联网平台维护人员处理。
-
参数说明 参数 必选/可选 类型 位置 描述 qbdiInDTO 必选 QueryBatchDevicesInfoInDTO query 见下表QueryBatchDevicesInfoInDTO的描述。 accessToken 必选 String header 填写鉴权接口获取的accessToken。 QueryBatchDevicesInfoInDTO 参数 必选/可选 类型 位置 描述 appId 必选 String query 如果是本应用的设备,此参数值可以填写None,否则填写授权应用的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”。
更多精彩内容
CDN加速
GaussDB
文字转换成语音
免费的服务器
如何创建网站
域名网站购买
私有云桌面
云主机哪个好
域名怎么备案
手机云电脑
SSL证书申请
云点播服务器
免费OCR是什么
电脑云桌面
域名备案怎么弄
语音转文字
文字图片识别
云桌面是什么
网址安全检测
网站建设搭建
国外CDN加速
SSL免费证书申请
短信批量发送
图片OCR识别
云数据库MySQL
个人域名购买
录音转文字
扫描图片识别文字
OCR图片识别
行驶证识别
虚拟电话号码
电话呼叫中心软件
怎么制作一个网站
Email注册网站
华为VNC
图像文字识别
企业网站制作
个人网站搭建
华为云计算
免费租用云托管
云桌面云服务器
ocr文字识别免费版
HTTPS证书申请
图片文字识别转换
国外域名注册商
使用免费虚拟主机
云电脑主机多少钱
鲲鹏云手机
短信验证码平台
OCR图片文字识别
SSL证书是什么
申请企业邮箱步骤
免费的企业用邮箱
云免流搭建教程
域名价格