码迷,mamicode.com
首页 > 其他好文 > 详细

yeelink平台试玩

时间:2015-07-14 10:08:23      阅读:195      评论:0      收藏:0      [点我收藏+]

标签:yeelink   云平台   

最近正在琢磨实现ESP8266的广域网功能,准备接入一些大的云平台。后续做了一些平台对接之后,会专门写一篇文章来总结对比各家的云平台。

这里很感谢yeelink为开发者提供的便利,两年多前接触以太网的时候就听过yeelink,后来看到他们出了自己的灯,后来又加入了小米生态链,感觉他们在良好地发展着。目前了解到yeelink的平台是接入门槛最低的,注册开发者帐号即可使用。于是乎做了一些尝试,写下这篇文章。

转载请注明:http://blog.csdn.net/sadshen/article/details/46872795

一、API梳理

梳理了yeelinkAPIhttp://www.yeelink.net/develop/api),API满足http。因此我就从http中的方法和URL两个方面来讲述这个API

技术分享

1.方法

可以看到http四种方法分别对应yeelink四种操作方式。

POST   -创建

PUT    -编辑

GET    -罗列/查看

DELETE -删除

 

2.URL

YeeLink的层次结构还是很清晰的,设备包含传感器,传感器包含数据点(图像传感器没有数据点,为图像数据)。

/device目录下存放着用户创建的设备,具体的设备目录(/device/<device_id>)下存放着设备拥有的传感器。每个传感器目录(/device/<device_id>/sensors/<sensor_id>)下又包含数据点目录,存放着历次的数据点。我还是画个框图。


/device

├─DeviceId_1

│  │  title-Dev1,about-xx,tags-xx,local-xx,latitude-xx,longitude-xx

│  │  

│  └─sensors

│      ├─SensorId_1

│      │  │  type-value,title-Sensor1,about-xx,tags-xx,unit-xx

│      │  │  

│      │  └─datapoints

│      ├─SensorId_2

│      │  │  type-switch,title-Sensor2,about-xx,tags-xx,unit-xx

│      │  │  

│      │  └─datapoints

│      ├─SensorId_3

│      │  │  type-gen,title-Sensor3,about-xx,tags-xx,unit-xx

│      │  │  

│      │  └─datapoints

│      └─SensorId_4

│          │  type-photo,title-Sensor3,about-xx,tags-xx,unit-xx

│          │  

│          └─photos

└─DeviceId_2


3.总结

1点是操作方法,第2URL是操作对象,二者结合的一系列动作就是设备与云平台的交互了。

搞明白了这个之后,就能很轻松知道yeelink的罗列和查看的区别。

罗列设备:      Get /device

查看具体设备:  Get /device/<device_id>

罗列传感器:    Get /device/<device_id>/sensors

查看具体传感器:Get /device/<device_id>/sensors/<sensor_id>

 

二、cURL操作示例

ESP局域网通信的学习笔记中,我已经安装了curl工具。接下来就模仿API示例来与yeelink平台进行通信,熟悉下yeelink的交互。

我在yeelink上建了DEV1DEV2两个设备,在DEV1中还创建了几个传感器。

 

罗列设备

curl --request GET --header "U-ApiKey: e510ad132988d34c6fc9c3a9322f6f10" http://api.yeelink.net/v1.0/devices

 技术分享

 

罗列传感器

curl --request GET --header "U-ApiKey: e510ad132988d34c6fc9c3a9322f6f10" http://api.yeelink.net/v1.0/device/140430/sensors

 技术分享

 

上报数据点

curl -i --request POST --data {\value\:26.6} --header "U-ApiKey: e510ad132988d34c6fc9c3a9322f6f10http://api.yeelink.net/v1.0/device/140430/sensor/159032/datapoints

查看数据点

curl --request GET --header "U-ApiKey: e510ad132988d34c6fc9c3a9322f6f10http://api.yeelink.net/v1.0/device/140430/sensor/159032/datapoints

 技术分享

 

可以看到POST26.6摄氏度在平台上也有了相应的变化:

技术分享

 

三、总结

借助cURL工具,快速地熟悉了yeelink的交互。Yeelink的层次结构很清晰,上手很快。

接下去就是编写具体的嵌入式代码来实现http通信了。

版权声明:本文为博主原创文章,未经博主允许不得转载。

yeelink平台试玩

标签:yeelink   云平台   

原文地址:http://blog.csdn.net/sadshen/article/details/46872795

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!