智慧工地数据中心接口之
环境监测接口v3.0
版本 | 时间 | 变更内容 |
V3.0 | 2019-07-19 | 3.0版本 |
工地现场的环境监测设备采集到的包括温度、湿度、风速、风向、PM2.5、PM10、噪音内容的数据通过该接口上传至智慧工地数据中心。本接口可接收硬件设备直传，也能够接收硬件供应商的服务器转发。但要求硬件供应商在接收到工地现场硬件数据后第一时间转发。
上传数据前供应商需要取得智慧工地信息管理平台的授权，否则将无法通过接口上传数据。
数据接口采用http/https协议，使用核心通讯内容采用JSON数据格式。
/api/open/iot/v3/env/runtime
POST
1. 请求头
请求头具体的生成方法请参考《智慧工地数据中心接口之认证鉴权接口》。
2. 请求体
请求体为JSON数据格式，内容为JSON对象数据，表示可以一次传入多行记录。但提醒开发者请不要一次性写入过多数据，建议每次最多不超过50行数据。
[ { "sourceId":"9b2db993-857f-11e7-857d-00163e32d704", "serialNo":" TSVS837819828", "temperature":39.0, "humidity":23.0, "pm2p5":35.2, "pm10":27.9, "noise":63.5, "windSpeed":23.0, "windDirection":274, "recordTime ":"20170811132025" } ] |
各字段说明如下表：
字段名称 | 值类型 | 说明 | 是否 |
sourceId | String | 来源数据id，外部系统跟踪数据用 | 否 |
serialNo | String | 设备物理编号 | 是 |
recordTime | String | 采集时间 | 是 |
temperature | Double | 温度 | 否 |
humidity | Double | 湿度 | 否 |
pm2p5 | Double | PM2.5 | 是 |
pm10 | Double | PM10 | 是 |
noise | Double | 噪声 | 是 |
windSpeed | Double | 风速 | 否 |
windDirection | Double | 风向 | 否 |
{ "code":"1", "message":"请求数据格式错误", content: { ... } } |
返回值说明：
字段名 | 说明 |
code | 错误代码，内容见3.5 |
message | 错误描述 |
content | 错误细节，部分保存失败时会返回保存失败的数据的sourceId列表 |
4. 代码值 | 说明 |
0 | 正常 |
1 | 请求参数格式错误 |
2 | 数据内容错误 |
3 | 无授权 |
4 | 系统异常 |
部分内容由用户投稿或者来源于网络，如有侵权，请联系底部邮箱进行删除！非常感谢您的支持！
