本帖最后由 生子当如哈士奇 于 2017-1-15 09:15 编辑
我来分享一下机智云OpenAPI 体验,同时也算是个傻瓜式教程以供参考。 操作就是通过HTTP API在没有硬件的情况下实现上传数据,查询数据这两个最基本的操作。 具体的步骤我已经做好了总结,以表格的形式给出所有的步骤。(特别注意,表格中的需要:指的是必需什么信息才能完成该操作;表格中的返回:指完成步骤后所能得到的信息并且只列出对后面步骤所必需的信息。如,完成步骤1会能得到Product Key,Product Secret,App ID,App Secret ,数据点标识名,但App Secret对后面没用的就没有列入到表格返回中。) 步骤 | 需要 | 返回 | 1.创建产品,应用,数据点 | | appID, product_key Product Secret 数据点标识名 | 2.用户注册/登陆 | appID 认证 | token | 3.绑定设备 | Token 认证 请求时间戳, 签名 product_key mac | did | 4.上传数据 | did | | 5.查看状态 | did | | 1. 建产品,应用,数据点 这个直接用图片表示会很直观,注意在操作过程中要记录好appID,product_key,Product Secret,数据点标识名,用的时候直接用,这样就不需要回头再找了。 图3 创建了布尔型数据点aa
2. 用户注册/登陆进入在线调试API页面:http://swagger.gizwits.com/doc/index/openapi_apps
按试一下
3.绑定设备 打开虚拟设备
时间戳与md5可以用这两个网站实现:
http://www.atool.org/timestamp.php
http://md5jiami.51240.com/
lower(md5(product_secret + timestamp))就是指product_secret字符串加上timestamp字符串,加密后取其小写(32位)。
在线调试API具体操作你们应该会用了,我直接放我写的内容以作参考就可以了,就不再放图这么低效了。
特别注意虚拟设备的MAC地址填写virtual:site。(这个是我卡了两天的地方,QQ群上求助才解决这问题)
3.绑定设备 POST /app/bind_mac { "product_key": "88e35e65f188494cb591d816f7cef5b3", "mac": "virtual:site", "remark": "true", "dev_alias": "alw" } 响应主体: { "remark": "true", "ws_port": 8080, "did": "YFCKvAikPYNaXEvLKBa4pd", "port_s": 8883, "is_disabled": false, "host": "sandbox.gizwits.com", "product_key": "88e35e65f188494cb591d816f7cef5b3", "port": 1883, "mac": "virtual:site", "role": "normal", "dev_alias": "alw", "is_online": false, "passcode": "123456", "type": "normal", "wss_port": 8880}
|
4.上传数据~
4.上传数据
{ "attrs": { "aa":true } } 响应主体: {}
// 注意,这里的空响应代表着成功。 |
5.查看状态
~
响应主体: { "did": "YFCKvAikPYNaXEvLKBa4pd", "updated_at": 1484296248, "attr": { "aa": true} }
//完成查询到我所上传的数值,大家可以多试几下。 |
总结: 1. 没有足够多的傻瓜式教程,这对没有基础的人不够友好。(最基本的示范(傻瓜式入门教程)应该在社区给出,这样极有利于开发人员的上手,减轻技术支持的负担。) 2. 机智云的在线调试API做得不错~ 3. 必须绑定硬件且硬件上线了(证明硬件活跃?),并注册用户(用于记录用户操作?)才能上传数据。
```
|