应用快速接入（联通用户专用）

前提条件

• 已经注册华为云官方帐号，可点击注册页面完成注册。
• 已经在华为云上完成实名制认证，可点击实名认证完成认证。
• 已开通设备管理服务，可访问设备管理服务，点击“立即使用”后开通服务。

获取应用接入信息

在设备接入服务控制台获取应用接入所需的信息。

1. 登录华为云官方网站，访问设备接入服务。
2. 进入管理控制台后，查看应用接入信息，记录域名和端口。针对不支持用域名接入的设备，通过在cmd命令框中执行“ping 域名”获取IP地址，用IP地址接入平台。由于IP地址不固定，用户需要将IP地址做成可配置项。

   注：设备管理服务基于设备接入服务，因此设备管理服务的接入地址与设备接入服务相同。

   

3. 点击控制台左侧导航的“设备管理”切换到设备管理页面，再点击界面右上角的“进入设备管理服务”。

   无需输入登录账号/密码，自动跳转登录。

4. 进入设备管理控制台后，单击默认应用。

   

5. 单击“重置”，获取新的应用密钥。记录应用ID和新的应用密钥。

   

新增产品模型

创建产品模型用于后续设备接入。产品模型指接入平台的设备的类型，产品信息包括设备的名称、厂商、协议等信息。创建产品模型可以方便的管理接入的不同类型的设备。

1. 在设备接入管理单击页面左下角的切换左侧菜单，打开“产品模型”页面，点击页面右上角的“新增产品模型 > 手动创建”。
2. 填写产品基本信息，点击“确定”。创建一个MQTT协议的产品。

   

3. 查看新创建产品模型详情，保存产品ID，后续将用于创建设备。

   

配置Postman证书

1. 访问Postman官网，下载并安装Postman。
2. 打开Postman的“Settings”菜单。

   

3. 关闭证书校验，使Postman不再校验服务端的证书。

   

4. 下载并配置Postman证书（解压后在“certificate -> Northbound API -> postman”目录下）。“Host”栏的地址和端口填写物联网平台开放给应用的域名与端口（登录至设备接入服务控制台后查看“应用对接信息”获取），不能通过域名接入的设备，“Host”栏填写从2中获取的IP地址，“client.crt”与“client.key”为客户端证书和私钥文件。

   

调测“鉴权”接口

参考鉴权接口文档，调测物联网平台鉴权接口。

1. 配置“鉴权”接口的HTTP方法、URL。

   

   参数	取值
   HTTP方法	POST
   URL	https://server:port/iocm/app/sec/v1.1.0/login 其中server:port为获取应用接入信息时获取的域名和端口。不能通过域名接入的设备，此处填写从2中获取的IP地址。

2. 配置“鉴权”接口的Body。

   

   参数	取值
   Content-Type	选择application/x-www-form-urlencoded。 注：选择Body格式后Postman会自动添加一个Content-Type头域。
   appId	填写获取应用接入信息时获取的应用ID。
   secret	填写获取应用接入信息时获取的应用密钥。

3. 点击“Send”，在下方查看返回码和响应消息内容。

   

   名称	类型	说明
   accessToken	String	访问令牌。
   tokenType	String	鉴权token类型，当前仅支持bearer类型。
   refreshToken	String	刷新令牌，用来刷新accessToken（1个月的有效期）。
   expiresIn	Integer	平台生成并返回accessToken的有效时间，单位秒。
   scope	String	申请的权限范围，当前不支持配置权限，默认有所有权限。

4. 请将返回的accessToken妥善保存，后续将用于调测“创建设备”接口。

调测“注册设备（验证码方式）”接口

参考注册设备接口文档，在物联网平台上创建一个设备。

1. 配置“注册设备（验证码方式）”接口的HTTP方法、URL和Headers。

   

   参数	取值
   HTTP方法	POST
   URL	https://server:port/iocm/app/reg/v1.1.0/devices其中server:port为获取应用接入信息时获取的域名和端口。不能通过域名接入的设备，此处填写从2中获取的IP地址。
   app_key	填写获取应用接入信息时获取的应用ID。
   Authorization	填写为“Bearer {accessToken}”，其中{accessToken}为调用鉴权接口返回的accessToken。
   Content-Type	无需专门填写，后续填写Body时选择即可。

2. 配置“鉴权”接口的Body。

   参数	取值
   Content-Type	选择raw之后选择JSON(application/json)。 注：选择Body格式后Postman会自动添加一个Content-Type头域。
   productId	填写为产品ID。
   nodeId	建议填写为设备的IMEI，无真实设备可随意填写，两个参数建议填写为相同的值。
   verifyCode
   timeout	设备验证码的超时时间，单位：秒。若设备在有效时间内未接入物联网平台并激活，则平台会删除该设备的注册信息。

3. 点击“Send”，在下方查看返回码和响应消息内容。

   

   名称	类型	说明
   deviceId	String(256)	设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。
   verifyCode	String(256)	设备验证码，设备可以通过验证码完成物联网平台的接入认证。若在请求中指定verifyCode，则响应中返回请求中指定的verifyCode；若请求中不指定verifyCode，则由物联网平台自动生成。
   timeout	Integer	验证码有效时间，单位秒，设备需要在有效时间内接入物联网平台。
   psk	String(32)	随机psk参数，若请求中携带了psk，则使用请求中的psk，否则由平台生成随机psk参数。

4. 在物联网平台上查看注册的设备。

   

进阶体验

按照本页面的指导，使用Postman模拟应用服务器接入物联网平台后，您应该已经基本了解应用服务器如何通过调用物联网平台开放的接口与平台交互。

若您想要进一步体验设备管理服务，可参考开发指南开发真实应用和真实设备，并接入物联网平台，体验更多功能。