还剩6页未读,继续阅读
文本内容:
广西壮族自治区建筑扬尘噪音监管平台数据接口标准年月日2019626
一、总则3
二、接入要求和前置条件3
三、系统接入接口标准4平台接口调用说明
3.14签名方式
3.24签名示例
3.34通用说明
3.45接口说明
3.56接口地址
3.67
一、总则为推进广西壮族自治区建筑扬尘噪音监管平台以下简称本平台在各地市及项目上的普及应用,为便于各项目采购、安装扬尘噪音监测设备,或已安装有扬尘噪音监测设备的项目接入本平台,特制定本规范
二、接入要求和前置条件各平台或设备在接入本平台前,应满足基本条件和特定条件,以下为基本条件-安装要求已完成现场安装,并且运行良好若该应用厂家已于事前完成了与本平台对接,则不受该条件限制二网络要求现场网络已接入公网,即公网环境能够访问本地数据库,或本地数据能上传至公网平台三准备工作熟悉本平台的标准接口,熟悉接入方法和业务逻辑;评估接入本平台的技术难度和现场条件,不具备接入条件的,需完善现场接入环境要求,做到技术上无问题
三、系统接入接口标准-平台接口调用说明监管平台提供以下信息用于服务调用:用户唯一凭证appid用户唯一凭证秘钥secret正式环境测试Demo:测试账号appid:appIdDemo测试密钥(secret)dd4fo85459d
(二)签名方式使用系统默认加密
1.MD5按照参数名称升序排列
2.连接字符串,连接参数名与参数值,并在首尾加上
3.secreto生成签名,位大写值
4.32MD5
(三)签名示例secretABCDEFGL获取项目/api/provide/service/bidareas/infoappid=l234567projectld=l23连接字符串(日期字符串不要)
1.urlEncode ABCDEFGLappid1234567projectld123ABCDEFGL生成签名
2.24B9ACDC4DE23CD6C8E3B5E16678A666拼接完整请求
3.url/api/provide/service/bidareas/infoappid=1234567proj ectld=123sign=24B9ACDC4DE23CD6c8E3B5E16678A666通用说明
4.最多1pageSize1000)接口返【返回字段2返回的业务数据data返回详见下面code,code定义code接口调用返回信息Message)标准定义3Code成功0参数不正确40签名错误41请求频繁42请求超过最大次数4344其它接口说明
5.)获取租户下项目列表1根据授权信息获取租户下的项目列表)接口地址2/api/provide/service/projectsappid=APPIDsign=SIGN方法:get)参数说明3参数类型是否必须说明是唯一凭证appid string是签名sign string)返回数据示例4ncoden:0,message:success,ndatan:[nprojectldn:projectName1:nXX项目二],throwable:null)返回字段说明5字段字段名称字段格式备注项目项目projectld IDstring ID项目名称项目名称proj ectNamestring)上报设备状态信息6环境监测设备需要在整点()时向监管平台上报设00:00:00〜24:00:00备状态信息,即每个设备天需上报次124接口地址
6.)接入地址1地址/api/provide/service/environment/devicetappid=APPIDsign=SIGN方式:post格式json参数说明参数类型是否必须说明是唯一凭证appid string日签名sign string是项目projectld StringID是设备deviceld StringID设备状态;可用;true:日deviceStatus boolean不可用false:是上报时间(毫秒值)dateTime longmanufactorN日厂商名称Stringame返回示例code0,messagesuccess”,throwable:null返回字段说明字段字段名称字段格式备注返回码表示成功code int0返回消息返回消息message string)上报环境监测数据2环境监测设备需要在整点()时向监管平台上00:00:00〜24:00:00报环境监测数据,即每个设备天需上报次124接口地址方/api/provide/service/environment/datatappid=APPIDsign=SIGN式post格式json参数说明参数类型是否必须说明是唯一凭证appid string是签名sign stringenvAttributeT环境监测数据类型pm25是String()(噪音)ype pm
2.5noise(温度)temp windSpeed(风速)()pmlO pmlO是单位unit Stringpm25,pml0:ug/m3℃noise:dB tempwindSpeed:m/s是数值value String是上报时间(毫秒值)dateTime long返回示例ncoden:0,message:success”,throwable:null)返回字段说明字段字段名称字段格式备注返回码表示成功code int0返回消息返回消息message string。