数据点 Datapoint

导航中心
快速开始 开发示例 案例分析 客户端下载 API文档 传感云SDK 使用条款 常见问题

数据点API (版本1.0)

API列表
插入数据点 data/v1/numerical/insert 插入数值型传感器数据点 查看接口
data/v1/gps/insert 插入GPS型传感器数据点 查看接口
data/v1/pic/upload 插入图片型传感器数据点 查看接口
data/v1/generic/insert 插入泛型传感器数据点 查看接口
更新数据点 data/v1/numerical/update 更新数值型传感器数据点 查看接口
data/v1/gps/update 更新GPS型传感器数据点 查看接口
data/v1/generic/update 更新泛型传感器数据点 查看接口
data/v1/onoff/switch 更新开关型传感器数据点 查看接口
批量上传 data/v1/numerical/batch 批量上传数值型传感器数据点 查看接口
data/v1/show 查看最新数据点 查看接口
data/v1/destroy 删除数据点 查看接口


插入数值型传感器数据点

URL

http://api.wsncloud.com/data/v1/numerical/insert

HTTP请求方式

POST

请求参数

参数名 必需 类型 说明
ak true string 用户密钥
id true string 传感器ID
value true double 数据值
timestamp false String 数据时间戳,格式:2013-10-18 14:36:38,不填默认为服务器当前时间

返回结果

JSON

{"status":"Ok","info":"1381943341550"}


插入GPS型传感器数据点

URL

http://api.wsncloud.com/data/v1/gps/insert

HTTP请求方式

POST

请求参数

参数名 必需 类型 说明
ak true string 用户密钥
id true string 传感器ID
lat true double 纬度
lng true double 经度
speed true double 速度
timestamp true String 数据时间戳,格式:2013-10-18 14:36:38,不填默认为服务器当前时间

返回结果

JSON

{"status":"Ok","info":"1381943341550"}



插入图片型传感器数据点

URL

http://api.wsncloud.com/data/v1/pic/upload

HTTP请求方式

POST

请求参数

参数名 必需 类型 说明
ak true string 用户密钥
id true string 传感器ID
pic true binary 要上传的图片,仅支持JPEG、GIF、PNG格式,图片大小小于1M。
  注意采用multipart/form-data编码方式
timestamp true String 数据时间戳,格式:2013-10-18 14:36:38,不填默认为服务器当前时间

返回结果

JSON

{"status":"Ok","info":"1381943341550"}



插入泛型传感器数据点

URL

http://api.wsncloud.com/data/v1/generic/insert

HTTP请求方式

POST

请求参数

参数名 必需 类型 说明
ak true string 用户密钥
id true string 传感器ID
value true string 自定义字符串,大小限定为1024个字符
timestamp true String 数据时间戳,格式:2013-10-18 14:36:38,不填默认为服务器当前时间

返回结果

JSON

{"status":"Ok","info":"1381943341550"}



更新数值型传感器数据点

URL

http://api.wsncloud.com/data/v1/numerical/update

HTTP请求方式

POST

请求参数

参数名 必需 类型 说明
ak true string 用户密钥
id true string 数据点ID
value true string 数据值

返回结果

JSON

{"status":"Ok","info":""}



更新GPS型传感器数据点

URL

http://api.wsncloud.com/data/v1/gps/update

HTTP请求方式

POST

请求参数

参数名 必需 类型 说明
ak true string 用户密钥
id true string 数据点ID
lat true Double 纬度
lng true Double 经度
speed true Double 速度

返回结果

JSON

{"status":"Ok","info":""}



更新泛型传感器数据点

URL

http://api.wsncloud.com/data/v1/generic/update

HTTP请求方式

POST

请求参数

参数名 必需 类型 说明
ak true string 用户密钥
id true string 数据点ID
value true String 自定义字符串,大小限定为1024个字符

返回结果

JSON

{"status":"Ok","info":""}



更新开关型传感器数据点

URL

http://api.wsncloud.com/data/v1/onoff/switch

HTTP请求方式

POST

请求参数

参数名 必需 类型 说明
ak true string 用户密钥
sensorId true string 传感器ID

返回结果

JSON

{"value":0} //返回当前最新状态,0关,1开



批量上传数值型传感器数据点

URL

http://api.wsncloud.com/data/v1/numerical/batch

HTTP请求方式

POST

请求参数

参数名 必需 类型 说明
ak true string 用户密钥
id true string 传感器ID
value true String 数据值

格式:

[

{"timestamp":"2012-01-02 11:11:00","value":21},

{"value":23},

{"timestamp":"2012-08-02 15:33:00","value":18}

]

返回结果

JSON

{"status":"Ok","info":""}



查看最新数据点

URL

http://api.wsncloud.com/data/v1/show

HTTP请求方式

GET

请求参数

参数名 必需 类型 说明
ak true string 用户密钥
sensorId true string 传感器ID

返回结果

JSON

数值型传感器返回值:

{
	"id":"527e6cea13acdf164a48adee",
	"value":11.0,
	"datetime":"2013-10-18 14:36:38"
}

GPS型传感器返回值:

{
	"id":"527e6cea13acdf164a48adee",
	"lat":31.5,
	"lng":121.01212,
	"speed":90.5,
	"datetime":"2013-10-18 18:14:49"
}

开关型传感器返回值:

{
	"value":1,
	"datetime":"2013-10-18 14:29:42"
}

图片型传感器返回值:

{
	"id":"527e6cea13acdf164a48adee",
	"url":"http://img.wsncloud.com/*****/887edd17-cf5d-44d1-9fb3-bb3b793124b1.jpg",
	"datetime":"2013-10-18 18:45:25"
}

泛型传感器返回值:

{
	"id":"527e6cea13acdf164a48adee",
	"value":"test data",
	"datetime":"2013-10-18 18:55:32"
}



删除数据点

URL

http://api.wsncloud.com/data/v1/destroy

HTTP请求方式

POST

请求参数

参数名 必需 类型 说明
ak true string 用户密钥
sensorId true string 传感器ID
dataId true String 数据点ID

返回结果

JSON

{"status":"Ok","info":""}