应用侧开发-华为云

设备接入 IOTDA-使用Postman调测:调测“查询产品”接口

调测“查询产品”接口应用服务器如果需要查询之前创建的产品详情，可以调用此接口。应用服务器需要构造一个请求，请求示例如下： GET https://iotda.cn-north-4.myhuaweicloud.com/v5/iot/{project_id}/products/{product_id} Content-Type: application/json X-Auth-Token: ******** 接下来参考API文档，调测物联网平台查询产品接口。注：在以下步骤中，只呈现样例调测用到的参数。配置“查询产品”接口的HTTP方法、URL和Headers。单击“Send”，在下方查看返回码和响应消息内容。

设备接入 IOTDA 应用侧开发

设备接入 IOTDA-使用Postman调测:调测“创建设备”接口

调测“创建设备”接口在设备接入物联网平台前，应用服务器需要调用此接口在物联网平台创建设备。在设备接入物联网平台时携带设备唯一标识，完成设备的接入认证。应用服务器需要构造一个HTTP请求，请求示例如下： POST https://iotda.cn-north-4.myhuaweicloud.com/v5/iot/{project_id}/devices Content-Type: application/json X-Auth-Token: ******** { "node_id" : "ABC123456789", "device_name" : "dianadevice", "product_id" : "b640f4c203b7910fc3cbd446ed437cbd", "auth_info" : { "auth_type" : "SECRET", "secure_access" : true, "fingerprint" : "********", "secret" : "********", "timeout" : 300 }, "description" : "watermeter device" } 参考API文档，调测物联网平台创建设备接口。注：在以下步骤中，只呈现样例调测用到的参数。配置“创建设备”接口的HTTP方法、URL和Headers。配置“创建设备”接口的Body。单击“Send”，在下方查看返回码和响应消息内容。请将返回的“device_id”更新到“IoTDA”环境中的“device_id”参数中，用于后续其它接口使用。注意：在postman中自动更新了“device_id”参数，使用时无需手动操作。

设备接入 IOTDA 应用侧开发

设备接入 IOTDA-使用Postman调测:调测“查询设备”接口

调测“查询设备”接口应用服务器需要查询在物联网平台创建的设备详情时，可以调用此接口。应用服务器需要构造一个HTTP请求，请求示例如下： GET https://iotda.cn-north-4.myhuaweicloud.com/v5/iot/{project_id}/devices/{device_id} Content-Type: application/json X-Auth-Token: ******** 参考API文档，调测物联网平台查询设备接口。注：在以下步骤中，只呈现样例调测用到的参数。配置“查询设备”接口的HTTP方法、URL和Headers。单击“Send”，在下方查看返回码和响应消息内容。

设备接入 IOTDA 应用侧开发

设备接入 IOTDA-使用Postman调测:调测“查询IAM用户可以访问的项目列表”接口

调测“查询 IAM 用户可以访问的项目列表”接口在访问物联网平台业务接口前，应用服务器需要调用“查询IAM用户可以访问的项目列表”接口获取用户的项目ID，用于后续访问物联网平台业务接口。应用服务器需要构造一个HTTP请求，请求示例如下： GET https://iam.cn-north-4.myhuaweicloud.com/v3/auth/projects Content-Type: application/json X-Auth-Token: ******** 参考API文档，调测查询IAM用户可以访问的项目列表接口。配置“查询IAM用户可以访问的项目列表”接口的HTTP方法、URL和Headers。单击“Send”，在下方查看返回码和响应消息内容。返回body中包含一个projects列表，查找其中“name”参数值与“IoTDA”环境中“region”参数值相同的条目，取其“id”参数值更新到“IoTDA”环境中“project_id”参数，以便于在调用其它接口时使用。这里我们已经在postman中自动更新了“project_id”参数，使用时无需手动操作。

设备接入 IOTDA 应用侧开发

设备接入 IOTDA-使用Postman调测:调测“获取IAM用户Token”接口

调测“获取IAM用户Token”接口在访问物联网平台业务接口前，应用服务器需要调用“获取IAM用户Token”接口鉴权，华为云认证通过后向应用服务器返回鉴权令牌X-Subject-Token。应用服务器需要构造一个HTTP请求，请求示例如下： POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxx" } } } } 参考API文档，调测获取IAM用户Token接口。配置“获取IAM用户Token”接口的HTTP方法、URL和Headers。配置“获取IAM用户Token”接口的Body。单击“Send”，在下方查看返回码和响应消息内容。请将返回头域中的的X-Subject-Token更新到“IoTDA”环境的“X-Auth-Token”参数中，以便于在调用其它接口时使用。若超过令牌有效时间，需要重新调用鉴权接口。这里我们已经在postman中自动更新了“X-Auth-Token”参数，使用时无需手动操作。

设备接入 IOTDA 应用侧开发

设备接入 IOTDA-使用Postman调测:调测“创建产品”接口

调测“创建产品”接口在设备接入物联网平台前，应用服务器需要调用此接口创建产品，后续注册设备时需要使用这里创建的产品。应用服务器需要构造一个请求，请求示例如下： POST https://iotda.cn-north-4.myhuaweicloud.com/v5/iot/{project_id}/products Content-Type: application/json X-Auth-Token: ******** { "name" : "Thermometer", "device_type" : "Thermometer", "protocol_type" : "MQTT", "data_format" : "binary", "manufacturer_name" : "ABC", "industry" : "smartCity", "description" : "this is a thermometer produced by Huawei", "service_capabilities" : [ { "service_type" : "temperature", "service_id" : "temperature", "description" : "temperature", "properties" : [ { "unit" : "centigrade", "min" : "1", "method" : "R", "max" : "100", "data_type" : "decimal", "description" : "force", "step" : 0.1, "enum_list" : [ "string" ], "required" : true, "property_name" : "temperature", "max_length" : 100 } ], "commands" : [ { "command_name" : "reboot", "responses" : [ { "response_name" : "ACK", "paras" : [ { "unit" : "km/h", "min" : "1", "max" : "100", "para_name" : "force", "data_type" : "string", "description" : "force", "step" : 0.1, "enum_list" : [ "string" ], "required" : false, "max_length" : 100 } ] } ], "paras" : [ { "unit" : "km/h", "min" : "1", "max" : "100", "para_name" : "force", "data_type" : "string", "description" : "force", "step" : 0.1, "enum_list" : [ "string" ], "required" : false, "max_length" : 100 } ] } ], "option" : "Mandatory" } ], "app_id" : "jeQDJQZltU8iKgFFoW060F5SGZka" } 参考API文档，调测物联网平台创建产品接口。注：在以下步骤中，只呈现样例调测用到的参数。配置“创建产品”接口的HTTP方法、URL和Headers。配置“创建产品”接口的BODY。单击“Send”，在下方查看返回码和响应消息内容。将返回的“product_id”更新到“IoTDA”环境中的“product_id”参数中，用于后续其它接口使用。注：在postman中自动更新了“product_id”参数，使用时无需手动操作。

设备接入 IOTDA 应用侧开发

设备接入 IOTDA-使用Postman调测:安装并配置Postman

安装并配置Postman 安装Postman。访问Postman官网，下载并安装Windows 64位Postman最新版本。安装Postman依赖.NET Framework 4.5组件。如需下载Windows 32位Postman最新版本，访问此处下载。填写邮箱、用户名和密码注册Postman。导入Postman环境变量。单击右上角的图标，打开“MANAGE ENVIRONMENTS”窗口。单击“Import”，在弹出的页面中，单击“选择文件”，导入IoTDA.postman_environment.json文件（下载Collection解压后获取）。单击导入的“IoTDA”环境。参考下表修改以下参数。参数名参数说明 IAMEndpoint IAM终端节点，参考IAM地区和终端节点获取。 IoTDAEndpoint 物联网平台终端节点，参考2.e。 IAMUserName IAM用户名，参考我的凭证获取。 IAMPassword 登录华为云的密码。 IAMDoaminId 账号名，参考我的凭证获取。 region 开通设备接入服务的区域，参考物联网平台终端节点获取。 IoTDAEndpoint参考。进入控制台，选择左侧导航栏“总览”，单击“实例基本信息-接入信息”，根据相应的接入类型和协议选择对应的接入地址。图1 总览-获取接入信息返回主页，选择环境变量为刚导入的“IoTDA”。单击左上角的“Import”，单击“Choose Files”导入“应用侧API调用（V5版本）.postman_collection.json”。导入成功后，显示如下。

设备接入 IOTDA 应用侧开发

设备接入 IOTDA-使用Postman调测:概述

概述 Postman是网页调试与辅助接口调用的工具，具有界面简洁清晰、操作方便快捷的特性，可以处理用户发送的HTTP请求，例如：GET，PUT、POST，DELETE等，支持用户修改HTTP请求中的参数并返回响应数据。为充分了解接口，建议提前获取应用侧API参考查阅。我们已经写好了Postman的collection，在Collection中接口的请求结构体已经完成可以直接使用。本文档以Postman为例，模拟应用服务器以HTTPS协议接入物联网平台，调测以下API接口： “获取IAM用户Token”接口 “查询IAM用户可以访问的项目列表”接口 “创建产品”接口 “查询产品”接口 “创建设备”接口 “查询设备”接口

设备接入 IOTDA 应用侧开发

设备接入 IOTDA-API使用指导:接口介绍

接口介绍 API分组应用场景产品管理产品模型定义了该产品下所有设备具备的能力或特征，产品管理为应用服务器提供对已导入物联网平台中产品模型的操作管理功能。设备管理设备管理为应用服务器提供对设备的操作管理功能，包括对设备基本信息和设备数据的操作。设备消息设备消息为应用服务器提供向设备透传消息的功能。设备命令设备的产品模型中定义了物联网平台可向设备下发的命令，设备命令为应用服务器提供向设备下发命令的功能，实现对设备的控制操作。设备属性设备的产品模型中定义了物联网平台可向设备下发的属性，设备属性为应用服务器提供向设备下发属性的功能。 AMQP队列管理 AMQP队列管理为客户创建、删除、查看队列。AMQP队列可通过规则订阅后通过AMQP客户端接收消息数据。接入凭证管理接入凭证是用于AMQP、MQ TTS 等协议建立长链接时认证使用。数据转发、设备联动规则管理为应用服务器提供物联网平台的规则引擎功能，通过设置规则实现业务的联动变化或将数据转发至其他华为云服务。包含设备联动和数据转发两种类型。设备联动：包含触发条件和执行动作两部分。当满足设置的触发条件后，触发相应动作，如“下发命令”、“发送通知”、“上报告警”、“恢复告警”。数据转发：包含设置转发数据、设置转发目标和启动规则三部分。支持转发至“ 数据接入服务 DIS”、“分布式消息服务 Kafka”、“ 对象存储服务 OBS”、“应用与数据集成平台 ROMA Connect”、“第三方应用服务（HTTP推送）”、“AMQP推送消息队列”、、、。订阅管理订阅管理为应用服务器提供对物联网平台资源的订阅功能，若订阅的资源发生变化，平台会通知应用服务器。设备影子设备影子是一个用于存储和检索设备当前状态信息的文件，设备影子为应用服务器提供对设备影子的操作管理功能。每个设备有且只有一个设备影子，由设备ID唯一标识。设备影子仅保存最近一次设备的上报数据和用户设置的预期数据。无论该设备是否在线，都可以通过该影子查询和设置设备的状态。设备组管理设备组管理为应用服务器提供对设备组的管理操作功能，包括对设备组信息和设备组设备的操作。标签管理标签可用于对资源进行分类，标签管理为应用服务器提供对各类资源绑定和解绑标签功能。当前仅设备支持标签。资源空间管理资源空间管理为应用服务器提供对资源空间的管理能力，包括资源空间的增删改查。批量任务批量任务为应用服务器提供批量处理功能，对接入物联网平台的设备进行批量操作。目前提供批量软、固件升级，批量创建/删除/更新设备，批量冻结/解冻设备，批量创建同步/异步命令，批量创建消息和批量配置设备影子的能力。当前单用户单一任务类型的未完成的任务最大为10，超过则无法创建新的任务。设备CA证书管理设备CA证书管理为应用服务器提供对设备CA证书进行操作管理功能，包括对设备CA证书进行上传、验证、查询等操作。物联网平台支持使用证书进行设备接入认证。 OTA升级包管理 OTA升级包管理为应用服务器提供对升级包进行操作管理功能，包括对升级包的创建、查询、删除等操作。广播消息广播消息为应用服务器向订阅了指定Topic的所有在线设备发布消息。设备隧道管理设备隧道可用于应用服务器与设备进行数据传输。数据流转积压策略管理数据流转积压策略管理为应用服务器提供了对积压策略的管理操作功能，包括对数据流转积压策略的创建，查询，修改删除等操作功能。数据流转流控策略管理数据流转流控策略管理为应用服务器提供了对流控策略的管理操作功能，包括对数据流转流控策略的创建，查询，修改删除等操作功能。

设备接入 IOTDA 应用侧开发

设备接入 IOTDA-API使用指导:应用开发资源

应用开发资源为了降低应用的开发难度、提升开发效率，物联网平台开放了应用侧API。应用通过调用物联网平台的API，实现安全接入、设备管理、数据采集、命令下发等业务场景。资源包名描述下载应用侧开发 API Java Demo 物联网平台为应用服务器提供了应用侧API，能够让开发者快速验证API开放的能力，体验业务功能，熟悉业务流程。 API Java Demo 应用侧开发 Java SDK Java SDK提供Java方法调用应用侧API与平台通信。使用指南可以参考Java SDK使用指南。 Java SDK 应用侧开发 C# SDK C# SDK提供C#方法调用应用侧API与平台通信。使用指南可以参考C# SDK使用指南。 C# SDK 应用侧开发 Python SDK Python SDK提供Python方法调用应用侧API与平台通信。使用指南可以参考Python SDK使用指南。 Python SDK 应用侧开发 Go SDK Go SDK提供Go方法调用应用侧API与平台通信。使用指南可以参考Go SDK使用指南。 Go SDK 应用侧开发 Node.js SDK Node.js SDK提供Node.js方法调用应用侧API与平台通信。使用指南可以参考Node.js SDK使用指南。 Node.js SDK 应用侧开发 PHP SDK PHP SDK提供PHP方法调用应用侧API与平台通信。使用指南可以参考PHP SDK使用指南。 PHP SDK

设备接入 IOTDA 应用侧开发

云服务器内容精选

应用侧开发

7*24

备案

专业服务

退订

建议反馈

售前咨询热线