工程質(zhì)量檢測監(jiān)管數(shù)據(jù)接口標(biāo)準(zhǔn)

檢測監(jiān)管對外接口說明

1.接口說明

1.1.環(huán)境地址

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

qdata/

2.接口清單

3.電子委托信息接口

3.1.接口概述

根據(jù)檢測單位的機(jī)構(gòu)編碼、攜帶的唯一標(biāo)識以及各查詢條件獲取委托信息

3.2.接口地址

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

3.3.請求方式（HTTP協(xié)議）

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

3.4.接口入?yún)?/p>

序號名稱類型是否必傳描述

1secretKeyString是唯一標(biāo)識字符串

（由平臺生成并發(fā)

給各檢測單位）

2institutionCodeString是機(jī)構(gòu)編碼

3eEntrustmentNoString否電子委托單編號

4entruststartDateDate否委托開始日期

5entrustEndDateDate否委托結(jié)束日期

6gcNumString否監(jiān)督登記號

7projectCodeString否工程編號

8projectNameString否工程名稱

3.5.接口響應(yīng)參數(shù)說明

序號名稱類型描述

1id主鍵ID

2eEntrustmentNo電子委托單編號

3projectCode工程編號

4projectName工程名稱

5gcNum監(jiān)督登記號

6reportNo報(bào)告編號

7subDate網(wǎng)上委托日期

8witnessPersonName見證員

9witnessGroupNumber見證組號

10buildUnit建設(shè)單位

11supervisorUnit監(jiān)理單位

12constructionUnit施工單位

13witnessHeadPortrait見證人頭像

14witnessTelephone見證人電話

15witnessCertificateNo見證人證書編號

16witnessCertificateAttachment見證人證書附件

17listJson數(shù)組樣品信息集合

17-1id主鍵ID

17-2qrCode如有多個按逗號分割二維碼信息

17-3checkProjectTD檢測項(xiàng)目ID

17-4checkProjectName檢測項(xiàng)目名稱

17-5checkProjectParamjson格式檢測項(xiàng)目參數(shù)

17-6witnessGroupNumber見證組號

17-7samp1eMsgjson格式樣品信息

3.6.接口響應(yīng)

“success”:true,

message:成功，

"code”:200,

“result”:{

“records”:[

(

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

"eEntrustmentNo〃："0L2022T4211”,//電子委托單編號

“projectCode〃：〃02003〃，//工程編號

“projectName”:〃廣州南沙新區(qū)〃，//工程名稱

"gcNum〃：“JD20190112001〃，〃監(jiān)督登記號

〃reportNo〃：〃0LPG2022〃，//報(bào)告編號

“subDate〃：〃2020-06-05〃，//網(wǎng)上委托日期

"witnessPersonName”:〃李四〃，//見證員

"buildUnit":"建設(shè)單位"，//建設(shè)單位

“supervisorUnit":〃監(jiān)理單位”，//監(jiān)理單位

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

"wilnessHeadPortrait”:〃url〃，//見證人頭像

“witnessTelephone":"13000000”,//見證人電話

"witnessCertificateNo，z：，，0L2022，/,//見證人證書編號

，zwitnessCertificateAttachment，/：^url^,//見證人證書附件

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

{

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

“qrCode":"112233〃//二維碼信息

“checkProjeclID”:〃檢測項(xiàng)目ID

“checkProjectName":"電力管溝〃，//檢測項(xiàng)目名稱

“checkProjectParam”:{

//檢測項(xiàng)目參數(shù)

)

“witnessGroupNumber"："11122333”〃見證組號

〃samp1eMsg":{

//樣品信息

)

)

],

)

],

“total":61,

),

timestamp，z：1641278154242

4.獲取材料見證信息

4.1.接口概述

檢測機(jī)構(gòu)獲取所屬的材料見證信息,可以通過qrCode,獲取單個材料二維碼的信息

4.2.接口地址

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

4.3.請求方式(HTTP協(xié)議)

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

4.4.接口入?yún)?/p>

序號名稱類型是否必傳描述

1secretKeyString是檢測機(jī)構(gòu)標(biāo)識（用于身份驗(yàn)

證,找相關(guān)人員獲取）

2projectNameString否工程名稱

3checkTypeInteger否送檢類型：0-常規(guī)見證送檢；

1-監(jiān)督見證送檢;2-普通送

檢;3-執(zhí)法監(jiān)督抽檢;4-其他

4startVerificationDateDate否開始驗(yàn)證時(shí)間（yyyy-MM-dd）

如果日期為空，則只會獲取

當(dāng)前時(shí)間24小時(shí)內(nèi)的

5endVerificationDateDate否結(jié)束驗(yàn)證時(shí)間（yyyy-MM-dd）

6qrCodeString否材料二維碼

7groupCodeString否組號

8pageSizeint否頁數(shù)（默認(rèn)10）

9pageNoint否頁碼（默認(rèn)1）

4.5.返回參數(shù)

序號名稱中文描述數(shù)據(jù)類型

1success成功標(biāo)識String(64)

2message描述信息String(500)

3code狀態(tài)碼String(64)

4timestamp時(shí)間毫秒String(64)

5result返回結(jié)果String(64)

result字段說明

序號名稱中文描述數(shù)據(jù)類型

1total總數(shù)int

每頁顯示條數(shù)，默認(rèn)

2sizeint

10

3current當(dāng)前頁int

4pages總頁數(shù)int

對象集合（records字

5recordsList

段說名）

records字段說明

序號名稱中文描述數(shù)據(jù)類型

1id主鍵idString(64)

2projectPosition工程部位String(500)

3materialCategoryId材料類別idString(64)

4checkProjectld抽檢項(xiàng)目IDString(64)

5manufacturerld廠商IDString(64)

送檢類型：o-常規(guī)見證

送檢；1-監(jiān)督見證送

6checkTypeInteger

檢;2-普通送檢;3-執(zhí)

法監(jiān)督抽檢;4-其他

7productBatch生產(chǎn)批次String(64)

8productCode生產(chǎn)批號String(64)

9remark備注String(500)

10witnessPersonld見證人IDString(64)

11locationAddress定位地址String(256)

12locationPerson定位人String(64)

定位時(shí)間(yyyy-MM-

13locationDatedatetime

dd)

14longitude經(jīng)度String(64)

15dimension緯度String(64)

16qrCode二維碼值String(256)

17witnessPersonCertificateNum見證人證書編號String(64)

18witnessPersonName見證人姓名String(64)

19groupCode組號String(64)

20projectName工程名稱String(200)

21projectControllerCode工程質(zhì)量監(jiān)督號String(64)

22projectAddress工程地址String(500)

23phNum樣品編號String(200)

24prNum報(bào)告編號String(200)

25projectCode工程編碼String(500)

26checkNum見證取樣份數(shù)Integer

遞交時(shí)間(yyyy-MM-

27submitTimedatetime

dd)

驗(yàn)證時(shí)間(yyyy-MM-

28verificationDatedatetime

dd)

29syNum試驗(yàn)編號String(30)

30groupTable檢測項(xiàng)目表名String

4.6.接口響應(yīng)

“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,

“l(fā)ocationAddress”:null,

“l(fā)ocationPerson”:null,

z，locationDate，/:null,

“l(fā)ongitude”: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.接口概述

檢測機(jī)構(gòu)獲取所屬的混凝土見證信息,可以通過qrCode獲取單個混凝土試塊的二維碼

信息

5.2.接口地址

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

5.3.請求方式(HTTP協(xié)議)

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

5.4.接口入?yún)?/p>

序號名稱類型是否必傳描述

1secretKeyString是檢測機(jī)構(gòu)標(biāo)識（用于身份驗(yàn)

證,找相關(guān)人員獲取）

2projectNameString否工程名稱

3witnessGroupNumberString否見證組號

4startVerificationDateDate否開始驗(yàn)證時(shí)間（yyyy-MM-dd）

5endVerificationDateDate否結(jié)束驗(yàn)證時(shí)間（yyyy-MM-

dd）,如果日期為空，則只會

獲取當(dāng)前時(shí)間24小時(shí)內(nèi)的

6qrCodeString否芯片外碼（混凝土見證材料

二維碼）

7serialNumberString否混凝土流水號

8pageSizeint否頁數(shù)（默認(rèn)10）

9pageNoint否頁碼（默認(rèn)1）

5.5.返回參數(shù)

序號名稱中文描述數(shù)據(jù)類型

1success成功標(biāo)識String(64)

2message描述信息String(500)

3code狀態(tài)碼String(64)

4timestamp時(shí)間毫秒String(64)

返回結(jié)果（result字段

5resultString(64)

說明）

result字段說明

序號名稱中文描述數(shù)據(jù)類型

1total總數(shù)int

每頁顯示條數(shù)，默認(rèn)

2sizeint

10

3current當(dāng)前頁int

4pages總頁數(shù)int

對象集合（records字

5recordsList

段說名）

records字段說明

序號名稱中文描述屬性

1id主鍵idString

2projectld工程IDString

3manufacturerId混凝土廠商11）String

4serialNumber混凝土流水號String

5productionUnit生產(chǎn)單位String

6designStrengthGrade設(shè)計(jì)強(qiáng)度等級String

7samplingPosition取樣部位String

8specimenNumber試件編號String

9witnessPersonld見證人IDString

養(yǎng)護(hù)條件（1.標(biāo)準(zhǔn),2.同條

10curingConditionsString

件,3.拆模）

11specimenSize試件尺寸String

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

13locationAddress定位地址String

14locationperson定位人String

15locationDate定位時(shí)間(yyyy-MM-dd)Date

16longitudeY經(jīng)度String

17dimensionX維度String

18blockCodeList試塊編碼List（詳情見下表）

19operationStatus操作情況String

20projectName工程名稱String

21projectAddr工程地址String

22strengthValue強(qiáng)度代表值String

23projectNum工程監(jiān)督號String

24witnessPersonName見證人姓名String

25verificationDat驗(yàn)證時(shí)間(yyyy-MM-dd)Date

26witnessGroupNumber見證組號String

27supervisionllnit監(jiān)督單位String

28detectionUnit檢測單位String

29detectionllnitName檢測單位名稱String

30submitDate遞交時(shí)間(yyyy-MM-dd)Date

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

blockCodeList字段說明

序號名稱中文描述屬性

1id主鍵idString

2chipinfold芯片idString

3witnessld見證IDString

4qrCode唯一編碼String

5chipld外碼String

6projectld工程IDString

7projectNum工程監(jiān)督號String

8seq試塊編號Integer

出庫狀態(tài)(1.未入庫2.已

9outBoundState入庫3.撤銷入庫4.已出Integer

庫

5.6.接口響應(yīng)

“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,

“l(fā)ocationAddress”: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.檢測數(shù)據(jù)上傳

6.1.接口概述

檢測系統(tǒng)調(diào)用該接口，上傳檢測相關(guān)數(shù)據(jù)

6.2.接口地址

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

6.3.請求方式(HTTP協(xié)議)

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

6.4.接口入?yún)?/p>

序號名稱類型是否必傳描述

1seci'etKeyString是檢測機(jī)構(gòu)標(biāo)識（用于身份驗(yàn)

證，找相關(guān)人員獲?。?/p>

2stationldString否機(jī)構(gòu)編碼

是

3seqldString序號id

4dataTypelDString是

5operationString是操作id

6grouNameString是檢測項(xiàng)目表名

7dataString是檢測數(shù)據(jù)實(shí)體信息（數(shù)據(jù)庫

字段屬性）

6.5.接口響應(yīng)

"success”:true,〃標(biāo)識

"message":",〃描述信息

"code”:200,〃狀態(tài)碼

"result":"檢測數(shù)據(jù)插入成功”，〃描述信息

"timestamp”:1634114893984〃時(shí)間毫秒

}

7.檢測報(bào)告上傳

7.1.接口概述

檢測系統(tǒng)調(diào)用該接口，上傳檢測報(bào)告文件

7.2.接口地址

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

7.3.請求方式(HTTP協(xié)議)

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

7.4.接口入?yún)?/p>

序號名稱類型是否必傳描述

1stationldString杳機(jī)構(gòu)編碼

2secretKeyString是檢測機(jī)構(gòu)標(biāo)識(用于身份驗(yàn)證，

找相關(guān)人員獲取)

3seqldString是序號id

4dataTypelDString是

5operationString是操作id

6grouNameString是檢測報(bào)告文件表名

(REPORTFILELIST)

7dataString是檢測數(shù)據(jù)實(shí)體信息

data字段屬性說明

序號名稱類型是否必傳描述

是

1prtnumString試驗(yàn)編碼

2fi1eTypeString否文件類型

3prtdateString是報(bào)告日期

4rFileString是文件base64字符串

是

5StationlDString機(jī)構(gòu)編碼

7.5.接口響應(yīng)

“success”:true,〃標(biāo)識

"message":〃描述信息

"code”:200,〃狀態(tài)碼

"result":"檢測數(shù)據(jù)插入成功”，〃描述信息

"timestamp”:1634114893984〃時(shí)間毫秒

}

8.判斷報(bào)告標(biāo)識號是否存在

8.1.接口概述

根據(jù)檢測機(jī)構(gòu)編碼,試驗(yàn)編碼判斷報(bào)告標(biāo)識號是否存在,存在直接返回標(biāo)識號,否則返回空

8.2.接口地址

#（baserUrl}/qdm/identifies/select

8.3.請求方式（HTTP協(xié)議）

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

8.4.接口入?yún)?/p>

序號名稱類型是否必傳描述

是

1organIDString機(jī)構(gòu)編碼

2prtNumString是試驗(yàn)編號

8.5.接口響應(yīng)

IgzOOOOOlOOOOOl〃報(bào)告標(biāo)識號

9.獲取單個報(bào)告標(biāo)識號

9.1.接口概述

根據(jù)檢測機(jī)構(gòu)編碼，計(jì)算機(jī)憑證，檢測項(xiàng)目編碼，報(bào)告編號獲取報(bào)告標(biāo)識號，如果不能正常獲取，則返回空字符串,

或者對應(yīng)的錯誤提示

9.2.接口地址

#{baserUr1}/qdm/identifies/get

9.3.請求方式(HTTP協(xié)議)

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

9.4.接口入?yún)?/p>

序號名稱類型是否必傳描述

1organlDString是檢測機(jī)構(gòu)編碼

2computerString否計(jì)算機(jī)標(biāo)識

3grouTableString是檢修項(xiàng)目編碼

4sys_numString是報(bào)告編號

9.5.接口響應(yīng)

IgzOOOOO1000001〃報(bào)告標(biāo)識號

10.獲取批量報(bào)告標(biāo)識號（目前固定獲取十個）

10.1.接口概述

根據(jù)檢測機(jī)構(gòu)編碼，計(jì)算機(jī)憑證，檢測項(xiàng)目編碼，報(bào)告編號批量獲取報(bào)告標(biāo)識號，如果無法正常獲取，返回空字符

串,或者對應(yīng)的信息

10.2.接口地址

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

10.3.請求方式（HTTP協(xié)議）

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

10.4.接口入?yún)?/p>

序號名稱類型是否必傳描述

1organIDString是檢測機(jī)構(gòu)注冊編碼

2co