机智云OpenAPI 体验记录/傻瓜式教程

生子当如哈士奇 · 发表于 2017-1-14 17:30:21

本帖最后由生子当如哈士奇于 2017-1-15 09:15 编辑

我来分享一下机智云OpenAPI 体验，同时也算是个傻瓜式教程以供参考。

操作就是通过HTTP API在没有硬件的情况下实现上传数据，查询数据这两个最基本的操作。

具体的步骤我已经做好了总结，以表格的形式给出所有的步骤。（特别注意，表格中的需要：指的是必需什么信息才能完成该操作；表格中的返回：指完成步骤后所能得到的信息并且只列出对后面步骤所必需的信息。如，完成步骤1会能得到Product Key，Product Secret，App ID，App Secret ，数据点标识名，但App Secret对后面没用的就没有列入到表格返回中。）

同时参考官方文档：http://docs.gizwits.com/zh-cn/Cloud/openapi_apps.html

步骤	需要	返回
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} }