机智云OpenAPI 体验记录/傻瓜式教程
本帖最后由 生子当如哈士奇 于 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_keyProduct Secret数据点标识名
2.用户注册/登陆appID 认证token
3.绑定设备Token 认证请求时间戳,签名product_keymacdid
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. 必须绑定硬件且硬件上线了(证明硬件活跃?),并注册用户(用于记录用户操作?)才能上传数据。
```
:handshake感谢你的分享,大家以后有什么建议尽管提,我们都会认真听取,尽量完善。:lol 好文章,顶起来.... 666,谢谢楼主 Gemini 发表于 2017-1-16 09:54
感谢你的分享,大家以后有什么建议尽管提,我们都会认真听取,尽量完善。 ...
我只能说,十分优秀!我这贴可以删除了。
连postman,websocket都做了傻瓜式教程。
提前祝技术人员,新年快乐。
生子当如哈士奇 发表于 2017-1-18 20:15
我只能说,十分优秀!我这贴可以删除了。
连postman,websocket都做了傻瓜式教程。
提前祝技术人员,新 ...
:handshake大家新年快乐 谢谢楼主,非常详细 :lol楼主厉害 谢谢楼主分享,实用:lol 楼主在吗?有事求教 机智云SOC片上系统的API没有开源也没有说明,肿么办? 非常感谢!! 群主大人你好,我用http 已经可以控制虚拟设备,但是不能控制实际的硬件 ,这个是为什么呢? linky_iot 发表于 2018-5-28 19:05
群主大人你好,我用http 已经可以控制虚拟设备,但是不能控制实际的硬件 ,这个是为什么呢? ...
我也没试过用机智云控制实际的硬件,不好意思哈。
为什么我按试一下,出不来token
页:
[1]