完整版远程监控系统接口标准文档格式.docx
《完整版远程监控系统接口标准文档格式.docx》由会员分享，可在线阅读，更多相关《完整版远程监控系统接口标准文档格式.docx（82页珍藏版）》请在冰豆网上搜索。
//localhost:
8080/webservice/demo/upload?
ak=APP00001&
ts=1403593817968&
token=wSzH0G5jKAxYILGo+5BOEd5g05g=
UrlEncode后的结果是：
token=wSzH0G5jKAxYILGo%2B5BOEd5g05g%3D
6.参数定义
1.
2.
3.
4.
5.
6.
7.
6.1.验证参数
接口调用时必须上传的权限验证参数，所以在接口定义的请求参数不再说明。
名称
说明
数据类型
appId
互联互通中心颁发给源系统的唯一标识
String
token
认证码=BASE64（SHA1（SHA1（appId+timestamp+secret）））secret为SDIC颁发给BAS的密钥
timestamp
当前时间戳
6.2.请求值
在业务数据新增、更新业务数据的时候，将请求参数格式话为json对象，json对象作为字符串提交。
业务数据json标准：
{
"
sourceId"
:
xxxxxx"
"
corpCode"
corpName"
:
"
personName"
idCard"
......
}
6.3.返回值
6.3.1.返回类型
接口调用的返回均采用json对象返回。
6.3.1.1.记录返回数据标准
{
result"
true,
data"
{
"
dcPK"
DC_4028e5d346d1b1690146d1b5c8f80001"
企业机构代码"
企业名称"
人员名称"
......
status"
新增"
dataVersion"
1,
photo"
//192.168.102.5:
8093/attach/ATTACH_3/2014/11/27/x.jpg"
}
}
6.3.1.2.异常返回数据标准
false,
error"
错误描述"
error_code"
00000"
6.3.2.异常编码error_code定义
异常类型
异常编码
异常描述
请求错误
00000
00001
请求参数错误
00002
请求格式错误
00003
请求超时
00004
请求的appId在系统中找不到
00005
授权错误
00006
没有访问权限
00007
文件上传的请求方式必须为post，MIME类型必须为multipart/form-data
系统错误
10001
10002
上传文件发生错误
7.数据标准
7.1.项目申报基本交互单元信息
该信息由建设单位在“动态系统”进行申报，并上传到互联互通中心，远程监控系统在从互联互通中心通过8.1的查询接口进行下载获取。
该交互单元在草稿状态就已经上传，所以项目省代码是为空的（只有在项目审核通过的时候才会生成并上传到互联互通中心）。
目前该基本交互单元已经将“动态系统”从2011年至今的符合条件的项目数据（草稿、退回、提交（审核中）、待确认、已确认、竣工提交（审核中）、审核通过（在建）、暂停、完工、竣工）都补充上传到互联互通中心。
字段名称
字段代码
字段
类型
长度
小数
位数
约束
条件
备注
项目名称
prjName
varchar
2000
M
项目省代码
provincePrjNum
30
项目主键
proId
64
建设单位机构代码
corpCode
25
建设单位机构名称
corpName
200
项目创建日期
createDate
Date
7.2.工程项目基本信息
该工程信息库在互联互通中心只包含工程项目状态为：
审核通过在建、暂停、完工、竣工的项目信息。
如果想获取除7.1信息外的其他字段信息可以通过查询8.2的接口获取7.2的工程项目基本信息（比如质量监督站名称，安全监督站名称等等）。
项目编号
prjNum
20
详见编码规则
项目编号（省编号）
工程所属地
prjBelongAddr
100
工程所在地
prjLocalAddr
建设单位名称
buildCorpName
建设单位组织机构代码
buildCorpCode
15
建设单位负责人
buildPersonName
建设单位负责人电话
buildPersonPhone
O
项目所在省
provinceNum
int
详见数据字典表TBXZQDMDIC
项目所在地市
cityNum
项目所在区县
countyNum
当前工程状态
prjStatus
6
记录登记时间
date
7.3.单位工程基本信息
项目Id
单位工程Id
itemId
Varchar
单位工程名称
singleProName
1000
单位工程类别
singleProType
50
建筑高度
archHeight
decimal
4
建筑面积
archArea
decimal
市政长度
muniLength
状态
itemStatus
±
0.000以上层数
structUpfloorNum
0.000以下层数
structDwfloorNum
7.4.远程监控安装信息
该信息由施工单位在“动态系统”进行申报，并上传到互联互通中心，远程监控系统在从互联互通中心通过8.3的查询接口进行下载获取。
当服务运营商安装结束后，远程监控系统调用互联互通中心8.3的更新接口，把完成时间、备注等相关数据返回到互联互通中心。
约束条件
申报Id
dcPk
动态系统登记
监管系统项目主键
远程监控系统项目主键
detectProId
服务运营商
serviceOperator
电信、移动、联通
申报时间
declareDate
datetime
申报备注
declareRemark
申报施工单位组织机构代码
申报施工单位名称
计划安装完成时间
planInstallDate
动态系统产生
申报时间+30天
实际安装完成时间
actualInstallDate
远程监控系统返回
安装备注
installRemark
…
7.5.远程监控设备安装接入数据信息
该信息由远程监控系统登记，远程监管系统调用8.10下的4个接口时，会自动生成这张表数据。
施工单位组织机构代码
施工单位名称
设备编号
devId
升级会员 