工程质量检测监管数据接口标准

检测监管对外接口说明

1.接口说明

1.1.环境地址

baseUri:https://rhjg.gzcqs.com:9003/qdm-external-

qdata/

2.接口清单

3.电子委托信息接口

3.1.接口概述

根据检测单位的机构编码、携带的唯一标识以及各查询条件获取委托信息

3.2.接口地址

#{baserUrl}/qdm/dzwt/onlineEntrusts/1ist

3.3.请求方式（HTTP协议）

HTTP/POST（application/json;charset=UTF-8）

3.4.接口入参

序号名称类型是否必传描述

1secretKeyString是唯一标识字符串

（由平台生成并发

给各检测单位）

2institutionCodeString是机构编码

3eEntrustmentNoString否电子委托单编号

4entruststartDateDate否委托开始日期

5entrustEndDateDate否委托结束日期

6gcNumString否监督登记号

7projectCodeString否工程编号

8projectNameString否工程名称

3.5.接口响应参数说明

序号名称类型描述

1id主键ID

2eEntrustmentNo电子委托单编号

3projectCode工程编号

4projectName工程名称

5gcNum监督登记号

6reportNo报告编号

7subDate网上委托日期

8witnessPersonName见证员

9witnessGroupNumber见证组号

10buildUnit建设单位

11supervisorUnit监理单位

12constructionUnit施工单位

13witnessHeadPortrait见证人头像

14witnessTelephone见证人电话

15witnessCertificateNo见证人证书编号

16witnessCertificateAttachment见证人证书附件

17listJson数组样品信息集合

17-1id主键ID

17-2qrCode如有多个按逗号分割二维码信息

17-3checkProjectTD检测项目ID

17-4checkProjectName检测项目名称

17-5checkProjectParamjson格式检测项目参数

17-6witnessGroupNumber见证组号

17-7samp1eMsgjson格式样品信息

3.6.接口响应

“success”:true,

message:成功，

"code”:200,

“result”:{

“records”:[

(

"id":/z00025e55-7248-4f3b-973f-3fecflc51f26z，,//主键ID

"eEntrustmentNo〃："0L2022T4211”,//电子委托单编号

“projectCode〃：〃02003〃，//工程编号

“projectName”:〃广州南沙新区〃，//工程名称

"gcNum〃：“JD20190112001〃，〃监督登记号

〃reportNo〃：〃0LPG2022〃，//报告编号

“subDate〃：〃2020-06-05〃，//网上委托日期

"witnessPersonName”:〃李四〃，//见证员

"buildUnit":"建设单位"，//建设单位

“supervisorUnit":〃监理单位”，//监理单位

"constructionUnit”:〃施工单位”，//施工单位

"wilnessHeadPortrait”:〃url〃，//见证人头像

“witnessTelephone":"13000000”,//见证人电话

"witnessCertificateNo，z：，，0L2022，/,//见证人证书编号

，zwitnessCertificateAttachment，/：^url^,//见证人证书附件

list":[//样品信息列表

{

"id":/，00025e55-7248-4f3b-973f-3fecflc51f26/，,//主键ID

“qrCode":"112233〃//二维码信息

“checkProjeclID”:〃检测项目ID

“checkProjectName":"电力管沟〃，//检测项目名称

“checkProjectParam”:{

//检测项目参数

)

“witnessGroupNumber"："11122333”〃见证组号

〃samp1eMsg":{

//样品信息

)

)

],

)

],

“total":61,

),

timestamp，z：1641278154242

4.获取材料见证信息

4.1.接口概述

检测机构获取所属的材料见证信息,可以通过qrCode,获取单个材料二维码的信息

4.2.接口地址

#{baserUrl}/qdm/witness/code/list

4.3.请求方式(HTTP协议)

HTTP/GET(application/json;charset=UTF-8)

4.4.接口入参

序号名称类型是否必传描述

1secretKeyString是检测机构标识（用于身份验

证,找相关人员获取）

2projectNameString否工程名称

3checkTypeInteger否送检类型：0-常规见证送检；

1-监督见证送检;2-普通送

检;3-执法监督抽检;4-其他

4startVerificationDateDate否开始验证时间（yyyy-MM-dd）

如果日期为空，则只会获取

当前时间24小时内的

5endVerificationDateDate否结束验证时间（yyyy-MM-dd）

6qrCodeString否材料二维码

7groupCodeString否组号

8pageSizeint否页数（默认10）

9pageNoint否页码（默认1）

4.5.返回参数

序号名称中文描述数据类型

1success成功标识String(64)

2message描述信息String(500)

3code状态码String(64)

4timestamp时间毫秒String(64)

5result返回结果String(64)

result字段说明

序号名称中文描述数据类型

1total总数int

每页显示条数，默认

2sizeint

10

3current当前页int

4pages总页数int

对象集合（records字

5recordsList

段说名）

records字段说明

序号名称中文描述数据类型

1id主键idString(64)

2projectPosition工程部位String(500)

3materialCategoryId材料类别idString(64)

4checkProjectld抽检项目IDString(64)

5manufacturerld厂商IDString(64)

送检类型：o-常规见证

送检；1-监督见证送

6checkTypeInteger

检;2-普通送检;3-执

法监督抽检;4-其他

7productBatch生产批次String(64)

8productCode生产批号String(64)

9remark备注String(500)

10witnessPersonld见证人IDString(64)

11locationAddress定位地址String(256)

12locationPerson定位人String(64)

定位时间(yyyy-MM-

13locationDatedatetime

dd)

14longitude经度String(64)

15dimension纬度String(64)

16qrCode二维码值String(256)

17witnessPersonCertificateNum见证人证书编号String(64)

18witnessPersonName见证人姓名String(64)

19groupCode组号String(64)

20projectName工程名称String(200)

21projectControllerCode工程质量监督号String(64)

22projectAddress工程地址String(500)

23phNum样品编号String(200)

24prNum报告编号String(200)

25projectCode工程编码String(500)

26checkNum见证取样份数Integer

递交时间(yyyy-MM-

27submitTimedatetime

dd)

验证时间(yyyy-MM-

28verificationDatedatetime

dd)

29syNum试验编号String(30)

30groupTable检测项目表名String

4.6.接口响应

“success”:true,

〃〃〃〃

message:,

"code”:200,

，ztimestamp":1647307323779,

“result”:{

“total”:0,

“size”:10,

“current”:1,

〃pages〃：0,

“records”:[{

〃id〃：null,

〃projectPosition〃：null,

z，materialCategoryId,，:null,

z，checkProjectldz，:null,

，，manufacturerld，/:null,

〃checkType〃：null,

，，productBatch，/:null,

/，productCode，/:null,

“remark〃：null,

，，witnessPersonId，/:null,

“locationAddress”:null,

“locationPerson”:null,

z，locationDate，/:null,

“longitude”:null,

“dimension〃：null,

“qrCode〃：null,

〃witnessPersonCertificateNum”:null,

〃witnessPersonName〃：null,

〃groupCode〃：null,

zzprojectName，/:null,

“projectControllerCode〃：null,

z，projectAddress/z:null,

〃phNum〃：null,

〃prNum〃：null,

“projectCode〃:null,

〃checkNum〃：null,

〃submitTime〃:null,

z，verificationDatez，:null,

“syNum”:null

}]

)

)

5.获取混凝土见证信息

5.1.接口概述

检测机构获取所属的混凝土见证信息,可以通过qrCode获取单个混凝土试块的二维码

信息

5.2.接口地址

#{baserlirl}/qdm/witness/concrete/list

5.3.请求方式(HTTP协议)

HTTP/GET(application/json；charset=UTF-8)

5.4.接口入参

序号名称类型是否必传描述

1secretKeyString是检测机构标识（用于身份验

证,找相关人员获取）

2projectNameString否工程名称

3witnessGroupNumberString否见证组号

4startVerificationDateDate否开始验证时间（yyyy-MM-dd）

5endVerificationDateDate否结束验证时间（yyyy-MM-

dd）,如果日期为空，则只会

获取当前时间24小时内的

6qrCodeString否芯片外码（混凝土见证材料

二维码）

7serialNumberString否混凝土流水号

8pageSizeint否页数（默认10）

9pageNoint否页码（默认1）

5.5.返回参数

序号名称中文描述数据类型

1success成功标识String(64)

2message描述信息String(500)

3code状态码String(64)

4timestamp时间毫秒String(64)

返回结果（result字段

5resultString(64)

说明）

result字段说明

序号名称中文描述数据类型

1total总数int

每页显示条数，默认

2sizeint

10

3current当前页int

4pages总页数int

对象集合（records字

5recordsList

段说名）

records字段说明

序号名称中文描述属性

1id主键idString

2projectld工程IDString

3manufacturerId混凝土厂商11）String

4serialNumber混凝土流水号String

5productionUnit生产单位String

6designStrengthGrade设计强度等级String

7samplingPosition取样部位String

8specimenNumber试件编号String

9witnessPersonld见证人IDString

养护条件（1.标准,2.同条

10curingConditionsString

件,3.拆模）

11specimenSize试件尺寸String

12moldingDate成型日期(yyyy-MM-dd)Date

13locationAddress定位地址String

14locationperson定位人String

15locationDate定位时间(yyyy-MM-dd)Date

16longitudeY经度String

17dimensionX维度String

18blockCodeList试块编码List（详情见下表）

19operationStatus操作情况String

20projectName工程名称String

21projectAddr工程地址String

22strengthValue强度代表值String

23projectNum工程监督号String

24witnessPersonName见证人姓名String

25verificationDat验证时间(yyyy-MM-dd)Date

26witnessGroupNumber见证组号String

27supervisionllnit监督单位String

28detectionUnit检测单位String

29detectionllnitName检测单位名称String

30submitDate递交时间(yyyy-MM-dd)Date

31scanDate扫描日期(yyyy-MM-dd)Date

blockCodeList字段说明

序号名称中文描述属性

1id主键idString

2chipinfold芯片idString

3witnessld见证IDString

4qrCode唯一编码String

5chipld外码String

6projectld工程IDString

7projectNum工程监督号String

8seq试块编号Integer

出库状态(1.未入库2.已

9outBoundState入库3.撤销入库4.已出Integer

库

5.6.接口响应

“success”:true,

〃〃〃〃

message:,

"code”:200,

“timestamp〃：1647307323779,

“result”:{

"total":0,

“size〃：10,

“current”:1,

〃pages〃:0,

“records〃：[{

〃id〃：null,

，，createTime，z:null,

“createMan”:null,

，，createld，/：null,

z，updateTime，z:null,

〃updateMan〃：nul1,

“updateld〃：null,

“state”:null,

“isDelete”:null,

/zprojectld，z：null,

“manufacturerId〃：null,

〃serialNumber”:null,

〃productionUnit〃：null,

/，designStrengthGradez，:null,

samp1ingPositionz，:null,

z，specimenNumber，z:null,

“witnessPersonld”:null,

〃curingConditions〃：null,

〃specimenSize〃：null,

〃moIdingDate〃:null,

“locationAddress”:null,

〃locationPerson〃：null,

〃locationDate”:null,

〃longitudeY〃:null,

〃dimensionX〃：null,

z，blockCodeList，z:[{

〃id〃：null,

“chipinfold”:null,

“witnessld”:null,

〃qrCode〃：null,

〃chipld〃：null,

“projectld”:null,

，zprojectNum，z:null,

〃seq〃：null

}],

“operationstatus”:null,

zzprojectName，/:null,

“projectAddr”:null,

“strengthValue”:null,

〃projectNum〃:null,

z，witnessPersonName，z:null,

〃witnessCertificateNum，z：null,

^verificationDate，z:null,

z，witnessGroupNumberz，:null,

z，supervisionUnit，z:null,

“detectionUnit”:null,

“detectionllnitName”:null,

z/witnessFaceInfoFilezz:null,

“submitDate〃：null,

，zconcreteDeliveryIdz/:null,

〃cheqi〃：null,

“chepai”:null,

z，receiveGoodsMan，z:null

}]

)

}

6.检测数据上传

6.1.接口概述

检测系统调用该接口，上传检测相关数据

6.2.接口地址

#{baserllrl}/qdm/automatic/data/collect/insert

6.3.请求方式(HTTP协议)

HTTP/POST(application/json;charset=UTF-8)

6.4.接口入参

序号名称类型是否必传描述

1seci'etKeyString是检测机构标识（用于身份验

证，找相关人员获取）

2stationldString否机构编码

是

3seqldString序号id

4dataTypelDString是

5operationString是操作id

6grouNameString是检测项目表名

7dataString是检测数据实体信息（数据库

字段属性）

6.5.接口响应

"success”:true,〃标识

"message":",〃描述信息

"code”:200,〃状态码

"result":"检测数据插入成功”，〃描述信息

"timestamp”:1634114893984〃时间毫秒

}

7.检测报告上传

7.1.接口概述

检测系统调用该接口，上传检测报告文件

7.2.接口地址

#{baserUr1}/qdm/automatic/data/collect/insert

7.3.请求方式(HTTP协议)

HTTP/POST(application/json;charset=UTF-8)

7.4.接口入参

序号名称类型是否必传描述

1stationldString杳机构编码

2secretKeyString是检测机构标识(用于身份验证，

找相关人员获取)

3seqldString是序号id

4dataTypelDString是

5operationString是操作id

6grouNameString是检测报告文件表名

(REPORTFILELIST)

7dataString是检测数据实体信息

data字段属性说明

序号名称类型是否必传描述

是

1prtnumString试验编码

2fi1eTypeString否文件类型

3prtdateString是报告日期

4rFileString是文件base64字符串

是

5StationlDString机构编码

7.5.接口响应

“success”:true,〃标识

"message":〃描述信息

"code”:200,〃状态码

"result":"检测数据插入成功”，〃描述信息

"timestamp”:1634114893984〃时间毫秒

}

8.判断报告标识号是否存在

8.1.接口概述

根据检测机构编码,试验编码判断报告标识号是否存在,存在直接返回标识号,否则返回空

8.2.接口地址

#（baserUrl}/qdm/identifies/select

8.3.请求方式（HTTP协议）

HTTP/POST(app1ication/x-ww-form-ur1encoded;charset=UTF-8)

8.4.接口入参

序号名称类型是否必传描述

是

1organIDString机构编码

2prtNumString是试验编号

8.5.接口响应

IgzOOOOOlOOOOOl〃报告标识号

9.获取单个报告标识号

9.1.接口概述

根据检测机构编码，计算机凭证，检测项目编码，报告编号获取报告标识号，如果不能正常获取，则返回空字符串,

或者对应的错误提示

9.2.接口地址

#{baserUr1}/qdm/identifies/get

9.3.请求方式(HTTP协议)

HTTP/GET(app1ication/x-ww-form-ur1encoded;charset=UTF-8)

9.4.接口入参

序号名称类型是否必传描述

1organlDString是检测机构编码

2computerString否计算机标识

3grouTableString是检修项目编码

4sys_numString是报告编号

9.5.接口响应

IgzOOOOO1000001〃报告标识号

10.获取批量报告标识号（目前固定获取十个）

10.1.接口概述

根据检测机构编码，计算机凭证，检测项目编码，报告编号批量获取报告标识号，如果无法正常获取，返回空字符

串,或者对应的信息

10.2.接口地址

#{baserUrl}/qdm-server/qdm/identifies/get/list

10.3.请求方式（HTTP协议）

HTTP/GET（application/x-www-form-urlencoded;charset=UTF-8）

10.4.接口入参

序号名称类型是否必传描述

1organIDString是检测机构注册编码

2co