收藏官网首页
查看: 9815|回复: 2

[技术分享] 利用openapi(postman)控制虚拟设备

34

主题

896

帖子

2274

积分

超级版主

Rank: 8Rank: 8

积分
2274
发表于 2017-1-6 10:09:42 | 显示全部楼层 |阅读模式
免费使用STM32、APP自动代码生成工具
概述:
本文档介绍了机智云云端提供api接口(openapi),应用端(PC)利用工具(postman)发送HTTP请求实现用户登陆,设备绑定,设备远程控制等功能。
图片1.png

1、准备工作
设备:开发者中心-个人项目-虚拟设备
软件:postman
其他:机智云开发者账号
参考文档:openapi指南
辅助工具链接:Unix时间戳
2、云端创建产品
1)新建产品
注册完成后,登陆至机智云开发者中心后台后,点击开发者中心后台右上角的“创建新产品”菜单,在跳转页面新建一个名为“Openapi”的产品,选择“Wi-Fi/移动网络方案”方式接入,并完成产品创建。如下图:
图片2.png
图片3.png
2)云端数据点(产品功能点)
3.1)数据点介绍:
数据点:即设备产品的功能的抽象,用于描述产品功能及其参数。创建数据点后,设备与云端通讯的数据格式即可确定,设备、机智云可以相互识别设备与机智云互联互通的数据。更多的解析和新建指引,可以在开发者中心数据点页面右上角“定义数据点教程”中查看找到帮助,以建立属于你自己产品的数据点,如下图:
图片4.png
3.2)新建数据点:
然后以本次的项目“Openapi”为例,简单描述一下云端数据点和产品的功能点的关系,本次的项目“Openapi”,它需要实现的功能是远程开灯和关灯,那我们只需在云端建立一个“布尔值”的可写数据点即可完成这件事,如下图:
图片5.png
添加数据点完成之后,点击下图的“应用”即可,完成整个产品的数据点的新建工作。
图片6.png
3.2)新建应用配置:
“openapi”的个人项目为例,点击服务-应用配置-添加新应用,如下图
图片7.png
之后填入应用名称,名称自定义,平台这里我们选择Android平台,点击添加,如下图
图片8.png
点击添加后会出现一个新应用,这里注意App id就是之后HTTP请求所用到的重要参数,如下图
图片9.png
3、Postman安装和导入
1) 去官网下载最新的postman客户端:postman官网
2) 下载完注册后是注册进入之后是collections是只有postman自带的echo。需要点击左上角import导入,或者按照文档中心的openapi文档。根据请求类型,来填url,header,body的key和value。
3) 下面我们选择导入已经收集好的请求,如下图:
图片10.png
Import From Link填入:
https://www.getpostman.com/collections/c76186e38f06e3f4a46a
然后点击import,就会出现如下图所示的文件夹
图片11.png
4、使用Postman进行HTTP请求
步骤流程:
图片12.png
1) 通过匿名登陆POST请求获取User_token
首先我们使用匿名登陆的POST请求获得Token,Appid在3.2)步骤新建的应用配置可以获取到,在Headers的页面上填入Appid,在Body页面填入phone_id之后点击send发送请求,下面会弹出一个返回框,在body一栏,获取到User_token,则说明请求成功,如下图
图片13.png
图片14.png
2) 打开虚拟设备获取did和passcode
之后我们回到个人项目-虚拟设备,点击启动虚拟设备,获取该虚拟设备的did和passcode如下图
图片15.png
图片16.png
3) 通过did+passcode的POST请求绑定设备
我们这里选择用did+passcode的绑定方式的POST请求来绑定设备,在Headers填入之前获取的Appid和User_token,在Body填入从虚拟设备上获取的did和passcode,然后返回success则表示绑定成功,如下图
图片17.png
图片18.png
4) 通过MAC的POST请求绑定设备(注:第4步成功后,这步骤可跳过)
我们这里选择用MAC的绑定方式的POST请求来绑定设备,在Headers填入之前获取的Appid和User_token,Timestamp为Unix时间戳(有效时间为五分钟),Signature的算法利用MD5加密的方法{MD5(product_secret+X-Gizwits-Timestamp).lower()},Body填入product_key和设备的mac,点击send,发现设备在线则成功,如下图
注:Timestamp和Signature获取的链接为:Unix时间戳 SignatureMD5加密
图片19.png
图片20.png
图片21.png
图片22.png
图片23.png
5) 通过获取绑定设备列表GET请求来查看设备是否在在线
点击获取绑定设备列表的GET请求,在Headers一栏填入Appid和User_token,点击send,然后返回一串JSON格式的信息,“is_online”的值是true表示设备在线,如下图
图片24.png
6) 通过远程控制设备的POST请求来控制设备
点击远程控制设备的POST请求,先在Headers填入AppID和User_token,在Url后填入自己的设备ID(did),在body根据自己的数据点的标识名和要发送的数据的值按照JSON格式填入并点击send发送,返回为空则表示成功,如下图
图片25.png
图片26.png
7) 验证设备是否已被控制
回到个人项目中,发现虚拟设备的值已改变,根据通讯日志,我们将标识名为Led_onoff的布尔型数据点修改成了true,如下图
图片27.png

2

主题

12

帖子

92

积分

注册会员

Rank: 2

积分
92
发表于 2017-2-24 14:38:43 来自手机 | 显示全部楼层
X-Gizwits-Signature = MD5(product_secret + X-Gizwits-Timestamp).lower() 我前台生成和后台生成都试过了,都会报 400         9044 X-Gizwits-Signature invalid! 这个错。谁能帮我解答下啊,谢谢了。

34

主题

896

帖子

2274

积分

超级版主

Rank: 8Rank: 8

积分
2274
 楼主| 发表于 2017-2-27 15:29:04 | 显示全部楼层
gogobody 发表于 2017-2-24 14:38
X-Gizwits-Signature = MD5(product_secret + X-Gizwits-Timestamp).lower() 我前台生成和后台生成都试过了 ...

你的时间戳超时了。或者你的参数填错了
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

加入Q群 返回顶部

版权与免责声明 © 2006-2024 Gizwits IoT Technology Co., Ltd. ( 粤ICP备11090211号 )

快速回复 返回顶部 返回列表