整体机制
整个系统采取 用户-设备-传感器 三层概念，每一层都提供对应的API来让用户方便获取或更新数据，满足不同种类的物联网应用。
授权机制
用户注册成功后会分配一个Userkey，在调用需要授权的API时，需要在HTTP的Header中增加 userkey:您的userkey，用Curl举例，如下：
curl --request POST http://www.lewei50.com/api/V1/Gateway/UpdateSensors/01 --data "[{'Name':'T1','Value':'23'}]" --header "userkey:2c59c80b372exxxxxxe1632b99227899"
Userkey可以在我的账户->个人信息中找到，如图所示
调用机制
1.HTTP类型分为两种：Post和Get，Get方式直接在Url增加参数即可，处理Post方式，需要根据API参考的格式Post对应的数据，用Curl举例 -request POST --data [{"Name":"T1","Value":“23"}]
2.返回格式均为Json，参照API参考获知各字段信息
API参考
目前API分为3个大类，用户可以在对应大类中方便找到自己需要的API，每个API都包含如下实例所示信息：
gateway/updateSensors
上传测量设备数据
URL
http://www.lewei50.com/api/v1/gateway/updatesensors/{网关标识}
是否需要Userkey
是
URL请求参数
无
HTTP请求方式
POST
Post数据实例
[ { "Name":"T1", "Value":"1" }, { "Name":"01H1", "Value":"96.2" }]
Post数据格式说明
| 必选 | 类型 | 说明 | |
|---|---|---|---|
| Name | 是 | string | 测量设备标识 |
| Value | 是 | string | 测量设备当前值 |
返回格式
JSON
返回结果实例
{ "Successful": true, "Message": null}
返回字段说明
| 字段 | 字段类型 | 说明 |
|---|---|---|
| Successful | boolean | 是否上传成功 |
| Message | string | 上传出错时的错误信息 |
注意事项&详细说明
注意区分大小写
在线调试工具
API测试
我们为每个API提供了在线测试工具，用户可以通过点击API参考中的在线测试工具链接打开测试页面，如图所示：
需要注意：对于Url中http://www.lewei50.com/api/V1/gateway/UpdateSensors/{网关标识}大括号中间的内容需要替换成用户真实的数据。
右侧会列出Request和Response的详细数据，方便用户参考。
如果你需要更详细的技术交流或者疑问咨询，可以加入乐为物联技术支持群：59162154；或关注乐为物联新浪微博@乐为物联；
关注乐联网微信：搜索公众账号“乐联网”。或者扫描下面的二维码来添加关注“乐联网”。
