应用快速接入
为了降低应用侧的开发难度、提升应用侧开发效率,物联网平台向应用侧开放了丰富的API。本文档以在线调试(即API Explorer)和本地调试(Postman)为例,模拟应用服务器以HTTPS协议为例接入物联网平台。
在线调试(推荐)
API Explorer提供在线API检索及接口调试,您可以使用在线调试快速接入物联网平台。使用API Explorer可以无码化快速调用接口,详细请参考在线调试。
- API Explorer调试支持基础版、标准版和企业版。
- 登录后instance_id自动填充,无需用户输入。
- 多实例下需下拉选择对应实例ID,默认基础版。
- 使用API Explorer调试时接入地址对应所选择的实例ID,具体可参考平台对接信息。
例如调试创建产品接口:
本地调试
本地调试是指以Postman方式调用应用侧接口为例介绍如何使用设备接入服务。
具体步骤如下:
步骤1:开通设备接入服务。访问设备接入服务,单击“管理控制台”后开通服务。
步骤2:创建产品。创建一个MQTT协议的产品。
步骤3:配置环境。下载并安装Postman,Postman建议使用7.17.0版本。
步骤4:调用服务。使用Postman调用API接口,查看返回结果或状态码与错误码。
- 步骤1:开通设备接入服务
目前设备接入服务仅在华北-北京四、华东-上海一、华南-广州、华南-广州-友好用户、亚太-曼谷、亚太-新加坡、中国-香港、非洲-约翰内斯堡环境上线。
- 步骤2:创建产品
调用接口前,需要先在物联网平台创建一款产品。
- 访问设备接入服务,单击“管理控制台”进入设备接入控制台。选择您的实例,单击实例卡片进入。
- 选择左侧导航栏的“产品”,单击 。
- 按照页面提示填写参数,创建一个MQTT协议的产品,然后单击“确定”。
基本信息
所属资源空间
平台自动将新创建的产品归属在默认资源空间下。如需归属在其他资源空间下,下拉选择所属的资源空间。如无对应的资源空间,请先创建资源空间。
产品名称
自定义。长度不超过64,只允许中文、字母、数字、以及_?'#().,&%@!-等字符的组合。
协议类型
建议选择MQTT。
数据格式
选择JSON。
所属行业
请根据实际情况选择。
所属子行业
请根据实际情况选择。
设备类型
请根据实际情况选择。
高级配置
产品ID
定制ProductID,用于唯一标识一个产品。如果携带此参数,平台将产品ID设置为该参数值;如果不携带此参数,产品ID在物联网平台创建产品后由平台分配获得。
产品描述
产品描述。请根据实际情况填写。
- 步骤3:配置环境
下载并安装Postman,详细操作请参考安装并配置Postman。
- 步骤4:调用服务
配置完Postman后,模拟应用服务器以HTTPS协议接入物联网平台,调测以下API接口:
进阶体验
按照本页面的指导,使用Postman模拟应用服务器接入物联网平台后,您应该已经基本了解应用服务器如何通过调用物联网平台开放的接口与平台交互。
若您想要进一步体验设备接入服务,可参考开发指南开发真实应用和真实设备,并接入物联网平台,体验更多功能。