Yeeklink作为一个开放的公共物联网接入平台,目的是为服务所有所有的爱好者和开发者,使传感器数据的接入、存储和展现变得轻松简单。下面我们介绍一下如何使用Yeelink平台完成您的轻松接入。

第一步:注册用户

注册用户
请注意填写电子邮件,注册后,会自动收到一封激活邮件,账号和API只有在激活以后才能正常使用。 注意填写电子邮件

第二步:点击邮箱内的链接,激活您的账号,这时就可以正常使用API了。

激活

第三步:点击登陆按钮,输入用户名和密码登陆,接着就能看到自己的账号信息了。

登录

在出现用户页面后,填写用户和密码即可完成登陆

登录

登陆之后,控制面板上出现了"用户中心",可以通过这个用户中心来管理和查看自己的物联网设备啦!

登录成功

点击"用户中心"后,可以首先增加一个物联网设备:

准备增加设备

通过点击"我的设备"—>"增加新设备":

增加设备 增加设备

保存后该设备就准备好进行数据上传和使用了。
增加新设备完毕就需要为该设备增加一个或多个传感器了(一个设备可以同时支持多个传感器)

增加传感器

增加传感器后,系统会自动为每一个传感器生成坐标图,用来显示采集数据的曲线图。

数据曲线图

要完成数据的上传,要进行如下操作:

API key

从上图中,能看到"我的账户设置"里面,有属于您的API KEY,这个API key能够是您的数据和其他人区分出来,务必请安全保存不要泄露。

第四步:数据的上传

URL

由上图可知,该传感器的Device=8,Sensor=12是在服务器系统中的唯一标示,上传数据时由这两个ID和APIKEY进行验证。

API

根据API手册,就需要发送POST到URL http://api.yeelink.net/v1.0/device/8/sensor/12/datapoints

按照协议来说,需要发送(POST BODY里面需要增加)如下数据:

{
  "value":34.12
}
这样,就能把该传感器的数据发送到服务器了,系统会自动获取当前时间作为标记,进行存储。

如果你是使用Curl进行测试,命令行下面输入:
curl --request POST --data '{"value":349}' --header "U-ApiKey: 您申请的API_KEY" --verbose http://api.yeelink.net/v1.0/device/8/sensor/12/datapoints
默认服务器将以服务器的当前时间对该数据进行存储,如果您对时间有特别的要求,可以发送带timestamp的数据给服务器,格式如图中所示:

data

如果多发送几个点,回到传感器的页面,按F5键进行刷新,就能看到绘图空间已经帮您将数据点从数据库取出并绘制成一个Flash的图片了。

数据曲线

第五步:数据的取回(特殊需求使用)

用如下的方法取回数据

API

如果只想取回我们刚才插入的所有数据,可以发送HTTP GET到如下的URL:
http://api.yeelink.net/v1.0/device/8/sensor/12/datapoints

hurl

服务器会默认返回最新的一条数据记录"{\"timestamp\":1337158055,\"value\":243}"
如果是希望返回某个时间段的数据,则可以参考API文档中的历史数据小节。

注册以获取 API key