历史数据

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

历史数据API (版本1.0)

查询历史数据点

URL

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

HTTP请求方式

GET

请求参数

参数名 必需 类型 说明
ak true string 用户密钥
id true string 传感器ID
start true String 查询开始时间戳,格式:2010-01-01 01:01:01
end true String 查询结束时间戳,格式:2010-01-01 01:01:01
interval true int 数据采样间隔,具体值见下方文档说明
page true int 分页页码,每页100条数据,不填默认取第一页数据

数据采样间隔参数说明

参数名 说明
1 每一秒取一个数据点
30 每30秒取一个数据点
60 每一分钟取一个数据点
300 每一分钟取一个数据点
900 每15分钟取一个数据点
1800 每30分钟取一个数据点
3600 每一小时取一个数据点
10800 每3小时取一个数据点
21600 每6小时取一个数据点
43200 每12小时取一个数据点
86400 每24小时取一个数据点

返回结果

JSON

数值型传感器返回值:

{
	"totalRecords":3,
	"totalPages":1,
	"currentPage":1,
	"records":[
		{
			"value":20.0,
			"id":"52601a4113acb050a6be7483",
			"datetime":"2013-10-18 01:11:29"
		},
		{
			"value":30.0,
			"id":"52601aa413acb050a6be7486",
			"datetime":"2013-10-18 01:13:08"
		},
		{
			"value":18.0,
			"id":"52615eb113ac47887081da7b",
			"datetime":"2013-10-19 00:15:45"
		}
	]
}

GPS型传感器返回值:

{
	"totalRecords":2,
	"totalPages":1,
	"currentPage":1,
	"records":[
		{
			"lat":31.5,
			"lng":121.01212,
			"speed":90.5,
			"id":"525ec73b13ac19a95c7f2285",
			"datetime":"2013-10-17 01:04:59"
		},
		{
			"lat":31.5,
			"lng":121.01212,
			"speed":90.5,
			"id":"525ec82d13ac19a95c7f2289",
			"datetime":"2013-10-17 01:09:01"
		}
	]
}

图片型传感器返回值:

{
	"totalRecords":4,
	"totalPages":1,
	"currentPage":1,
	"records":[
		{
			"url":"http://img.wsncloud.com/****/a290-a94e8ac2ace7.jpg",
			"id":"5269df439a7077a937425a20",
			"datetime":"2012-01-15 14:18:20"
		},
		{
			"url":"http://img.wsncloud.com/****/9fb3-bb3b793124b1.jpg",
			"id":"526111459a70a105ca0b677c",
			"datetime":"2013-10-18 18:45:25"
		},
		{
			"url":"http://img.wsncloud.com/****/930c-9a5a720ec7a5.jpg",
			"id":"5269de5e9a7077a937425a1e",
			"datetime":"2013-10-25 10:58:38"
		},
		{
			"url":"http://img.wsncloud.com/****/9d76-f32ad016e7ba.jpg",
			"id":"5269df029a7077a937425a1f",
			"datetime":"2013-10-25 11:01:22"
		}
	]
}

泛型传感器返回值:

{
	"totalRecords":1,
	"totalPages":1,
	"currentPage":1,
	"records":[
		{
			"value":"test data",
			"id":"527f2f0ce36fb4f8ffed5ab3",
			"datetime":"2013-11-04 18:29:10"
		}
	]
}

返回值参数说明

参数名 说明
totalRecords 总共的数据条数
totalPages 总共的页数,按每页100条数据进行分页
currentPage 当前查询的页码数
records 记录结果集

备注说明

该接口查询返回结果数最大不能超过50000,如果数据量过大,请缩短查询时间跨度