文档首页 > > 快速入门> Postman模拟应用接入

Postman模拟应用接入

分享
更新时间: 2019/09/26 GMT+08:00

为了降低应用侧的开发难度、提升应用侧开发效率,物联网平台向应用侧开放了丰富的Restful API。本文档以Postman为例,模拟应用服务器以HTTPS协议接入物联网平台。

前提条件

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

获取应用接入信息

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

  1. 登录华为云官方网站,访问设备接入服务
  2. 进入管理控制台后,查看应用接入信息,记录域名和端口。

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

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

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

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

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

新增产品模型

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

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

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

配置Postman证书

  1. 打开Postman的“Settings”菜单。

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

  3. 下载并配置Postman证书(解压后在“certificate -> Northbound API -> postman”目录下)。“Host”栏的地址和端口填写物联网平台开放给应用的域名与端口(HTTPS协议),“client.crt”“client.key”为客户端证书和私钥文件。

调测“鉴权”接口

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

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

    参数

    取值

    HTTP方法

    POST

    URL

    https://server:port/iocm/app/sec/v1.1.0/login 其中server:port为获取应用接入信息时获取的域名和端口。

  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/deviceCredentials 其中server:port为获取应用接入信息时获取的域名和端口。

    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模拟应用服务器接入物联网平台后,您应该已经基本了解应用服务器如何通过调用物联网平台开放的接口与平台交互。

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

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区