附件3全國工程質量安全監管信息平臺建筑起重機械使用登記證書電子證照數據交換接口規范（試運行）2023年08月文檔修訂歷史序號版本修訂日期修改記錄11.02023-08全國工程質量安全監管信息平臺電子證照數據交換接口規范-建筑起重機械使用登記證書（試運行）目錄15262一、概述 —概述1.1、目的本文檔是為全國工程質量安全監管信息平臺與各省、自治區、直轄市、新疆生產建設兵團建筑起重機械使用登記證書電子證照系統進行數據共享提供統一對接標準，均按照此接口規范進行對接。1.2、參考資料《全國一體化政務服務平臺電子證照建筑起重機械使用登記證書》1.3、基本術語1.3.1、資源請求方資源請求方是指需要調用服務API的對象，是數據需求方。1.3.2、資源提供方資源提供方是指擁有資源方對外提供資源數據的對象，是數據提供方。1.3.3、服務API服務API是資源提供方對外提供數據服務的實現形式之一。其是由信息資源共享交換平臺基于RESTAPI技術實現。1.3.4、服務授權服務API只有在授權權限給相應的應用系統之后，資源請求方才能調用該服務API。1.4、參數類型說明C4：表示最多4位的字符型字符串，不足4位按實際位數；C..：表示可變長度的字符型字符串；N5：表示最多5位的數字型字符串，不足5位按實際位數；N..：表示可變長度的數字型字符串；Date：表示日期類型字符串。Text：表示大文本字符串。服務申請流程2.1、賬號開設各省（直轄市、自治區、新疆生產建設兵團）通過住建部平臺以數據接口形式上報電子證照數據，由各省（直轄市、自治區、新疆生產建設兵團）按要求填寫申請表。部信息中心對接入申請進行審核，確認信息無誤后予以批準，由部信息中心完成相關業務系統應用注冊工作，并將應用標識（AppKey/client_id）和應用密鑰（AppSecret/client_secret）等對接材料以郵件形式發放給各省（直轄市、自治區、新疆生產建設兵團）進行對接。服務調用流程請用戶將該接口授權的應用key、應用密鑰這兩個值提供給應用開發商，應用開發商按照下面的步驟調用接口資源。3.1、步驟一、獲取認證token共享平臺提供基于OAuth2.0的統一身份鑒權方式。第三方應用通過申請令牌token，來完成對API的調用訪問，各省份的應用標識client_id與client_secret會提前分發。其中對于所有訪問用戶隱私API的請求，需要提供用戶授權令牌來校驗該第三方調用是否是合法調用，而對于所有平臺基礎支撐API，需要提供客戶端授權令牌來進行校驗。關于OAuth2.0協議的詳細介紹，可以參考W3C的官方文檔。開發者可以先瀏覽OAuth2.0的接口文檔，熟悉OAuth2的接口及參數的含義，然后我們根據用戶授權認證和客戶端授權認證2種場景各自說明如何使用OAuth2.0。表3-1接口信息接口地址（政務外網）http://**/epoint-soa-web/rest/oauth2/token請求方式POST參數格式請求參數Body類型：x-www-form-urlencoded接口說明獲取token請求參數參數名數據類型是否必需說明client_idC...是應用標識client_secretC...是應用密碼grant_typeC...是固定值：client_credentials請求參數示例返回結果參數參數名數據類型是否必需說明access_tokenC...是最終獲取到的tokenrefresh_tokenC...是刷新token票據expires_inC...是token有效期返回結果示例正確示例：錯誤示例：{3.2、步驟二、上傳資源數據根據得到的token,調用接口,上傳數據。3.3、Java代碼參考示例publicclassCallAPI{//客戶端賬號標識,請修正為實際值staticStringAppKey="eae5****-****-****-****-********58a7";//客戶端賬號密碼,請修正為實際值staticStringAppSecret="d0c9****-****-****-****-********096c";//認證平臺地址，具備token接口，只需要配置到認證平臺應用系統名即可,請修正為實際值staticStringSSOUrl=":port/epoint-sso-web";//調用憑證，考慮憑證需要遠程調用接口獲取，需要靜態化，不用每次調用重新獲取staticAssertionTokenInfo;//生成調用憑證staticAssertiongetToken(booleanrefresh){//如果憑證已經生成且不需要強制更新的情況下，則只需要獲取原有憑證即可，避免不必要的遠程調用if(TokenInfo==null||refresh){//利用SDK方法獲取調用憑證，傳入客戶端賬號、密碼和認證平臺地址，采用的是客戶端認證模式TokenInfo=AssertionUtil.getAssertionStateless(AppKey,AppSecret,SSOUrl);}returnTokenInfo;}//調用最終API方法publicstaticStringAPIInvoke(StringUrl,StringAccess_Token,Map<string,object="">Params){//實際需要調用的API的地址，將調用憑證token作為參數傳入Url=Url+"?access_token="+Access_Token;//通過SDK的HttpClientUtil調用API，獲得返回值Map<string,string="">headers=newHashMap<>();headers.put("Authorization","Bearer"+Access_Token);return(String)HttpClientUtil.post(Url,headers,Params,2);}publicstaticvoidmain(String[]args)throwsException{//實際API地址,請修正為實際值StringUrl=":port/rest/***";//調用API的參數,請修正為實際值Map<string,object="">Params=newHashMap<>();Params.put("服務器IP","");//考慮調用憑證緩存化，一定時間后調用憑證肯定會過期，當憑證過期時，引入重試機制，即憑證需要強制更新，并重新調用API接口//本示例重試最多3次，3次失敗則不再繼續重試。for(inti=0;i<3;i++){StringAccess_Token=getToken(i>0).getAccessToken();Stringresult=APIInvoke(Url,Access_Token,Params);If("1".equals(result)){break;}}}}此方法預期會出現3類異常情況，針對各類異常的信息和處置方法上述代碼引用Jar包下載：表3-3異常解決方案"error='invalid_client',或description='非法的ClientID'"請檢查AppKey值是否配置準確error='unauthorized_client',description='未驗證通過的客戶端身份'請檢查AppSecret值是否配置準確mon.exception.OAuthSystemException:java.io.FileNotFoundException請檢查AppKey值是否配置準確3.4、標準代碼定義表3-4返回代碼代碼定義1上傳成功（業務數據校驗接口、電子證照文件歸集接口、數據更正接口）上傳成功，操作類型為01或02時返回二維碼賦碼（業務數據賦碼接口）0上傳失敗，并返回具體錯誤原因500內部服務器錯誤賦碼和二維碼加解密4.1、賦碼接口返回密文解密方法4.1.1、解密流程圖圖4-1-14.1.2、import引用引用如下：importjavax.crypto.Cipher;importjavax.crypto.spec.SecretKeySpec;importjavax.xml.bind.annotation.adapters.HexBinaryAdapter;importorg.apache.log4j.Logger;importcom.alibaba.fastjson.JSONObject;4.1.3、解密方法解密方法如下：/***解密**@paramencryCertid*加密后的證照的唯一標識*@paramencryKey*ras加密后的key*@paramprivateKeyString*私鑰*/publicJSONObjectdecryption(StringencryCertid,StringencryKey,StringprivateKeyString){JSONObjectrtnObj=newJSONObject();try{//先將key進行ras解密StringdecryKey=RasDecrypt(encryKey,privateKeyString);//生成密鑰對象,如果算法是DES，那么這個構造函數不會檢查key是否為8個字節長SecretKeySpecsecretKeySpec=newSecretKeySpec(decryKey.getBytes(),"DES");//獲取加解密實例Ciphercipher=Cipher.getInstance("DES/ECB/PKCS5Padding");//初始化解密模式cipher.init(Cipher.DECRYPT_MODE,secretKeySpec);//HexBinaryAdapter十六進制轉換工具HexBinaryAdapterhexBinaryAdapter=newHexBinaryAdapter();//解密byte[]ecertidResult=cipher.doFinal(hexBinaryAdapter.unmarshal(encryCertid));//結果rtnObj.put("certid",newString(ecertidResult));rtnObj.put("decryKey",decryKey);}catch(Exceptione){logger.error(e.getMessage(),e);}returnrtnObj;}4.1.4、解密結果示例{"certid":"202232000001000001","decryKey":"12345678"}4.1.5、說明結果包含內容：certid：二維碼賦碼，通過“4.1.3解密方法”解密decryKey：8位數字，通過“4.1.3解密方法”解密以上解密方法需要的privateKeyString私鑰參數值，由住房和城鄉建設部全國工程質量安全監管信息平臺技術支持單獨提供。4.2、電子證照二維碼明文加密方法4.2.1、加密流程圖圖4-2-14.2.2、import引用引用如下：importjavax.crypto.Cipher;importjavax.crypto.spec.SecretKeySpec;importjavax.xml.bind.annotation.adapters.HexBinaryAdapter;importorg.apache.log4j.Logger;importcom.alibaba.fastjson.JSONObject;4.2.3、加密方法加密方法如下：/***返回加密后的證照id密文和key*@paramcertid*證照的唯一標識ID賦碼*@parampublicKeyString*公鑰字符串（部里單獨提供給省里）*@return*/publicJSONObjectencryption(Stringcertid,StringpublicKeyString){JSONObjectrtnObj=newJSONObject();try{//隨機生成8個字符的字符串（以下key值只是示例，可以指定或者隨機生成）Stringkey="12345678";//RandomStringUtils.randomAlphanumeric(8);//生成密鑰對象,如果算法是DES，那么這個構造函數不會檢查key是否為8個字節長SecretKeySpecsecretKeySpec=newSecretKeySpec(key.getBytes(),"DES");//獲取加解密實例Ciphercipher=Cipher.getInstance("DES/ECB/PKCS5Padding");//初始化加密模式cipher.init(Cipher.ENCRYPT_MODE,secretKeySpec);//加密byte[]ecertidByte=cipher.doFinal(certid.getBytes());//HexBinaryAdapter十六進制轉換工具,把byte數據轉換成十六進制的字符串表示。HexBinaryAdapterhexBinaryAdapter=newHexBinaryAdapter();//返回的ID密文rtnObj.put("encryCertid",hexBinaryAdapter.marshal(ecertidByte));//將隨機字符串用ras加密StringencryKey=RasEncrypt(key,publicKeyString);//返回的key密文rtnObj.put("encryKey",encryKey);}catch(Exceptione){logger.error(e.getMessage(),e);}returnrtnObj;}4.2.4、加密結果示例明文如下：密文如下：/fwmh/middlepage.html?ID=8B9704DDABA730072E5546FD5B8F61E4890FE52BAB2E71B8&k=XX8U+FFI3yRWEZ0UQ1qJxS+gsdth779BypvXY5MKfNRELdegoHfCoymJUNG4Q/rTco69eBZ1TYEK+rCNrCbVAg==&certype=11100000000013338W083&province=5100004.2.5、說明電子證照二維碼包含內容：URL：二維碼掃碼查詢提示頁面，固定為：/fwmh/middlepage.htmlID：二維碼賦碼的密文，通過“4.2.3加密方法”加密k：8位隨機密鑰，通過“4.2.3加密方法”加密certype：電子證照類型代碼。表4-2-5證照類型名稱證照類型代碼建筑起重機械使用登記證書11100000000013338W083province：固定值對接省份6位轄區代碼以上加密方法需要的publicKeyString公鑰參數值，由住房和城鄉建設部全國工程質量安全監管信息平臺技術支持單獨提供。對接接口標準5.1、建筑起重機械使用登記證書根據業務場景提供建筑起重機械使用登記證書調用接口的詳細說明，流程指南詳見附錄1。推送操作類型原證書狀態推送的證書狀態賦碼調用接口順序辦理新發電子證照和既有電子證照后續業務場景辦理新發電子證照/有效是①業務數據校驗接口②業務數據賦碼接口③相關人員信息接收接口④電子證照文件歸集接口辦理注銷有效注銷否①相關人員信息接收接口②證書狀態變更接口辦理注銷失效注銷否辦理撤銷有效撤銷否①證書狀態變更接口辦理撤銷失效撤銷否辦理失效有效失效否辦理其他業務失效有效否5.1.1、業務數據校驗接口使用場景說明：省級電子證照系統進行業務審批需要上報建筑起重機械使用登記證書業務數據時，提前對數據預校驗，可以申請調用業務數據校驗接口。表5-1-1接口信息接口地址http://**/epoint-gateway/zjbzasdzzz/rest/dzzzqzjxsyjdzrest/qzjxsydjz_check請求方式POST返回方式JSON接口說明建筑起重機械使用登記證書業務數據校驗接口；支持多條數據上傳，單次上傳上限10條。請求參數名稱數據類型是否必需備注AcceptDataJSON是記錄集合。Json對象AcceptData相關字段名稱數據類型是否必需備注businessDataIdC36是業務數據ID，地方電子證照系統業務主鍵areaCodeC6是所屬省、自治區、直轄市、市轄區行政區劃代碼，按照民政部官網《2020年中華人民共和國行政區劃代碼》deviceCategoryCodeC1是類別代碼，使用登記證所對應的建筑起重機械的類別的代碼，詳見6.1-建筑起重機械類別代碼表deviceModelC..200是規格型號,使用登記證所對應的建筑起重機械的規格型號factoryNumC..200是出廠編號，建筑起重機械所對應的唯一出廠編號manufactureCorpCodeC18是制造單位統一社會信用代碼,建筑起重機械制造單位的統一社會信用代碼operateTypeC2是操作類型，詳見6.1-操作類型代碼表和6.1-證書狀態與操作類型關系代碼表certNumC20滿足條件必填證照編號，建筑起重機械使用登記證書的唯一編號，按照《全國一體化政務服務平臺電子證照建筑起重機械使用登記證書》附錄A.1編號規則生成，當操作類型是辦理新發電子證照時，非必填，其他的操作類型要求必填請求參數示例{ "AcceptData":[{ "businessDataId":"73faca65c31a484b8f6b719c94******", "areaCode":"110101", "deviceCategoryCode":"T", "deviceModel":"QTZ80(WA6010-6A)", "factoryNum":"1012T002124869", "manufactureCorpCode":"914300007121944054", "operateType":"10", "certNum":"110101T（2023）0000001" }]}返回結果參數名稱數據類型是否必需備注ReturnCodeC1是返回代碼，詳見6.1-返回代碼代碼表ReturnMsgC..500是返回信息ReturnDataJSON是返回數據結果集Json對象ReturnData相關字段名稱數據類型是否必需備注ErrorDataJSON/錯誤信息集合，返回代碼為0時需要+ErrorGuidC..50/錯誤數據標識，返回代碼為0時需要+ErrorCodeC..50/錯誤碼，返回代碼為0時需要+ErrorMsgC..1000/錯誤信息，返回代碼為0時需要SuccessDataJSON/成功數據集合，返回代碼為1時需要+businessDataIdC..50/業務數據ID，返回代碼為1時需要+SuccessCodeC..50/成功碼，返回代碼為1時需要+SuccessMsgC..1000/成功信息，返回代碼為1時需要WarnDataJSON/預警信息集合，返回代碼為2時需要+WarnGuidC..50/預警數據標識，返回代碼為2時需要+WarnCodeC..50/預警碼，返回代碼為2時需要+WarnMsgC..1000/預警信息，返回代碼為2時需要返回結果示例①返回代碼為1時的結果信息：{ "ReturnCode":"1", "ReturnMsg":"業務數據校驗成功", "ReturnData":{ "SuccessData":[{ "businessDataId":"73faca65c31a484b8f6b719c94******", "SuccessCode":"S-02-LEZ-XX", "SuccessMsg":"該國家標準電子證照業務數據校驗成功" }] }}②返回代碼為0時的結果信息：{ "ReturnCode":"0", "ReturnMsg":"業務數據校驗失敗", "ReturnData":{ "ErrorData":[{ "ErrorGuid":"73faca65c31a484b8f6b719c94******", "ErrorCode":"E-02-LEZ-XX", "ErrorMsg":"該制造單位漢中市金志建筑機械安裝租賃有限責任公司的起重機械設備（出廠編號：1012T002124868），已存在國家標準電子證照，發證地：北京市，證照編號：110101T（2023）*******！" }] }}③返回代碼為2時的結果信息：{ "ReturnCode":"2", "ReturnMsg":"業務數據校驗成功有預警", "ReturnData":{ "WarnData":[{ "WarnGuid":"73faca65c31a484b8f6b719c94******", "WarnCode":"E-02-LEZ-XX", "WarnMsg":"XXXX" }], "SuccessData":[{ "businessDataId":"73faca65c31a484b8f6b719c94******", "SuccessCode":"S-02-LEZ-XX", "SuccessMsg":"該國家標準電子證照業務數據校驗成功" }] }}5.1.2、業務數據賦碼接口使用場景說明：省級電子證照系統需要上報建筑起重機械使用登記證書業務數據進行歸集并申請二維碼賦碼時，可以申請調用業務數據賦碼接口。補充說明：當操作類型“辦理新發電子證照”時，需要將設備基本信息作為業務信息參數進行上報。表5-1-2接口信息接口地址http://**/epoint-gateway/zjbzasdzzz/rest/dzzzqzjxsyjdzrest/qzjxsydjz_fm請求方式POST返回方式JSON接口說明建筑起重機械使用登記證書業務數據賦碼接口；支持多條數據上傳，單次上傳上限10條；操作類型為“辦理新發電子證照”時會進行二維碼賦碼。請求參數名稱數據類型是否必需備注AcceptDataJSON是記錄集合。Json對象AcceptData相關字段名稱數據類型是否必需備注businessDataIdC36是業務數據ID，地方電子證照系統業務主鍵areaCodeC6是所屬省、自治區、直轄市、市轄區行政區劃代碼，按照民政部官網《2020年中華人民共和國行政區劃代碼》certNumC20是證照編號，建筑起重機械使用登記證書的唯一編號，按照《全國一體化政務服務平臺電子證照建筑起重機械使用登記證書》附錄A.1編號規則生成issuAuthNameC..200是發證機關，負責頒發和管理該建筑起重機械使用登記證書的縣級及以上人民政府住房城鄉建設主管部門名稱issuAuthCodeC18是發證機關代碼，證照頒發機關的統一社會信用代碼issuDateDate是發證日期，該證照頒發的日期，按照公元紀年精確至日。用于照面展示時，用阿拉伯數字將年、月、日標全，月、日不標虛位deviceCategoryCodeC1是類別代碼,使用登記證所對應的建筑起重機械的類別的代碼，詳見6.1-建筑起重機械類別代碼表deviceModelC..200是規格型號,使用登記證所對應的建筑起重機械的規格型號factoryNumC..200是出廠編號,建筑起重機械所對應的唯一出廠編號recordNumC16是備案編號,由產權單位在建筑起重機械首次出租或安裝前，向本單位工商注冊所在地縣級及以上地方人民政府建設主管部門辦理的備案證明的編號manufactureCorpNameC..200是制造單位,建筑起重機械制造單位的名稱manufactureCorpCodeC18是制造單位統一社會信用代碼,建筑起重機械制造單位的統一社會信用代碼propertyCorpNameC..200是產權單位,建筑起重機械出租單位或者自購建筑起重機械使用單位propertyCorpCodeC18是產權單位統一社會信用代碼,建筑起重機械產權單位的統一社會信用代碼projectNameC..200是工程名稱,辦理該建筑起重機械使用登記的建設工程的名稱projectLocationC..200是工程項目地址,辦理該建筑起重機械使用登記的建設工程所在的詳細地址applyConstructionPermitC1是是否辦理施工許可證,建筑起重機械使用登記的建設工程是否辦理施工許可證constructionPermitNumC18滿足條件必填建筑工程施工許可證編號,建筑起重機械使用登記的建設工程的施工許可證唯一標識碼，已辦理施工許可證時必填useCorpNameC..200是使用單位,建筑起重機械使用單位名稱useCorpCodeC18是使用單位統一社會信用代碼,建筑起重機械使用單位的統一社會信用代碼maintenanceCorpNameC..200是維保單位,進行建筑起重機械維修保養單位的名稱maintenanceCorpCodeC18是維保單位統一社會信用代碼,建筑起重機械維保單位的統一社會信用代碼useCorpManagerC..50是使用單位項目負責人,建筑施工起重機械使用單位的項目負責人useCorpManagerIdC..18是使用單位項目負責人身份證件號碼,建筑施工起重機械使用單位的負責人有效身份證件號碼installCorpNameC..200是安裝單位,從事建筑起重機械安裝活動的單位，安裝單位應具有相關資質installCorpCodeC18是安裝單位統一社會信用代碼,建筑起重機械的安裝單位的統一社會信用代碼installDateDate是安裝日期，建筑起重機械安裝日期，按照公元紀年精確至日。用于照面展示時，用阿拉伯數字將年、月、日標全，月、日不標虛位installPositionC..20是安裝位置，建筑起重機械安裝的具體位置信息，用基于2000國家大地坐標系（CGCS2000）的經緯度坐標點表示，格式為“經度,緯度”,經緯度至少精確到小數點后第四位testCorpNameC..200是檢測單位，進行建筑起重機械檢測的單位名稱testCorpCodeC18是檢測單位統一社會信用代碼，建筑起重機械檢測單位的統一社會信用代碼testDateDate是檢測日期，建筑起重機械安裝檢測合格報告出具日期，按照公元紀年精確至日。用于照面展示時，用阿拉伯數字將年、月、日標全，月、日不標虛位certStatusC2是證書狀態代碼，詳見6.1-證書狀態類型代碼表certStatusDescriptionC..200滿足條件必填證書狀態描述，證書狀態為“其他”時進行的補充描述associatedCertIdC73滿足條件必填關聯證照標識，該證書關聯的最近一個已失效建筑起重機械使用登記證書的標識，規則同表5-1-4中的“證照標識”businessInformationJSON是業務信息，按JSON串方式（第一個參數為持證主體或證照本身關聯的業務類型，第二個參數為持證主體或證照本身涉及的業務信息）方式組織的對應業務類型代碼的具體業務信息，參數類型詳見6.1-設備基本信息業務類型代碼表，需要上報設備基本信息operateTypeC2是操作類型，詳見6.1-操作類型代碼表和6.1-證書狀態與操作類型關系代碼表請求參數示例{ "AcceptData":[{ "businessDataId":"73faca65c31a484b8f6b719c94******", "areaCode":"110101", "certNum":"110101T（2023）0000001", "issuAuthName":"北京市住房和城市建設委員會", "issuAuthCode":"11110000000021135M", "issuDate":"2023-05-25", "deviceCategoryCode":"T", "deviceModel":"QTZ80(WA6010-6A)", "factoryNum":"1012T002124869", "recordNum":"京AA-T-2111-03691", "manufactureCorpName":"中聯重科股份有限公司", "manufactureCorpCode":"914300007121944054", "propertyCorpName":"漢中市金志建筑機械安裝租賃有限責任公司", "propertyCorpCode":"9161070056714569XF", "projectName":"北京市建設工程項目", "projectLocation":"北京市北京市朝陽區建國路18號", "applyConstructionPermit":"1", "constructionPermitNum":, "useCorpName":"漢中市金志建筑機械安裝租賃有限責任公司", "useCorpCode":"9161070056714569XF", "maintenanceCorpName":"中聯重科股份有限公司", "maintenanceCorpCode":"914300007121944054", "useCorpManager":"張三", "useCorpManagerId":", "installCorpName":"中聯重科股份有限公司", "installCorpCode":"914300007121944054", "installDate":"2023-04-25", "installPosition":"116.4937,39.9017", "testCorpName":"山東華寧設備檢測有限公司", "testCorpCode":"91370100570499093L", "testDate":"2023-04-26", "certStatus":"01", "certStatusDescription":"有效", "associatedCertId":"005.2.11100000000013338W083.11110000000021135M.2023T0000001.001.G", "businessInformation":[{ "itemvalue":"1001", "itemtext":20 },{ "itemvalue":"1002", "itemtext":20 },{ "itemvalue":"1003", "itemtext":20 },{ "itemvalue":"1004", "itemtext":20 }], "operateType":"10" }]}返回結果參數名稱數據類型是否必需備注ReturnCodeC1是返回代碼，詳見6.1-返回代碼代碼表ReturnMsgC..500是返回信息ReturnDataJSON是返回數據結果集Json對象ReturnData相關字段名稱數據類型是否必需備注ErrorDataJSON/錯誤信息集合，返回代碼為0時需要+ErrorGuidC..50/錯誤數據標識，返回代碼為0時需要+ErrorCodeC..50/錯誤碼，返回代碼為0時需要+ErrorMsgC..1000/錯誤信息，返回代碼為0時需要SuccessDataJSON/成功數據集合，返回代碼為1時需要+businessDataIdC..50/業務數據ID，返回代碼為1時需要+SuccessCodeC..50/成功碼，返回代碼為1時需要+encryKeyC..200/二維碼賦碼加密key，返回代碼為1時需要+encryCertidC..200/二維碼賦碼加密ID，返回代碼為1時需要+SuccessMsgC..1000/成功信息補充說明，返回代碼為1時需要WarnDataJSON/預警信息集合，返回代碼為2時需要+WarnGuidC..50/預警信息標識，返回代碼為2時需要+WarnCodeC..50/預警碼，返回代碼為2時需要+WarnMsgC..1000/預警信息，返回代碼為2時需要返回結果示例①返回代碼為1時的結果信息：{ "ReturnCode":"1", "ReturnMsg":"業務數據賦碼成功", "SuccessData":[{ "businessDataId":"73faca65c31a484b8f6b719c94******", "SuccessCode":"S-03-LEZ-XX", "encryCertid":"EDBE76D9217A23212E5546FD5B8F61E4671575AD27******", "encryKey":"Th2MCBlpx2sGE69qphb0dtb3yZo4jIJ4F9nWR4kMR5vXvmQDTPm0LT+GO9V+AFXkD1ZH7vm1oHsD3H7e2b******", "SuccessMsg":"" }]}②返回代碼為0時的結果信息：{ "ReturnCode":"0", "ReturnMsg":"業務數據賦碼失敗", "ReturnData":{ "ErrorData":[{ "ErrorGuid":"73faca65c31a484b8f6b719c94******", "ErrorCode":"E-03-LEZ-XX", "ErrorMsg":

"不符合安裝日期<=檢測日期<=發證日期<=當前日期" "ErrorFields":

[{"FieldName":"行政區劃代碼（areacode）","FieldValue":"430000","FieldDesc":""},], }] }}③返回代碼為2時的結果信息：{ "ReturnCode":"2", "ReturnMsg":"業務數據賦碼成功有預警", "ReturnData":{ "WarnData":[{ "WarnGuid":"73faca65c31a484b8f6b719c94******", "WarnCode":"W-03-LEZ-XX", "WarnMsg":"XXX" }], "SuccessData":[{ "businessDataId":"73faca65c31a484b8f6b719c94******","SuccessCode":"S-03-LEZ-XX", "encryCertid":"EDBE76D9217A23212E5546FD5B8F61E4671575AD27******", "encryKey":"Th2MCBlpx2sGE69qphb0dtb3yZo4jIJ4F9nWR4kMR5vXvmQDTPm0LT+GO9V+AFXkD1ZH7vm1oHsD3H7e2b******", "SuccessMsg":"" }] }}5.1.3、證書狀態變更接口使用場景說明：當對證書狀態需要更新且不需要賦碼時，可以申請調用建筑起重機械使用登記證書證書狀態變更接口。補充說明：當操作類型“辦理注銷”時，需要先將拆卸相關人員信息調用相關人員信息接收接口進行上報，再調用證書狀態變更接口。表5-1-3接口信息接口地址http://**/epoint-gateway/zjbzasdzzz/rest/dzzzqzjxsyjdzrest/qzjxsydjz_update請求方式POST返回方式JSON接口說明建筑起重機械使用登記證書證書狀態變更接口；支持多條數據上傳，單次上傳上限10條。請求參數名稱數據類型是否必需備注AcceptDataJSON是記錄集合。Json對象AcceptData相關字段名稱數據類型是否必需備注businessDataIdC36是業務數據ID，地方電子證照系統業務主鍵certIdC73是證照標識，由省級建筑起重機械使用登記證書電子證照系統按照規則自動生成的唯一標識，按照《全國一體化政務服務平臺電子證照建筑起重機械使用登記證書》標準附錄A.2生成areaCodeC6是所屬省、自治區、直轄市、市轄區行政區劃代碼，按照民政部官網《2020年中華人民共和國行政區劃代碼》certNumC..26是證照編號，按照《全國一體化政務服務平臺電子證照建筑起重機械使用登記證書》附錄A.1編號規則生成的證書唯一編號。deviceCategoryCodeC1是類別代碼,使用登記證所對應的建筑起重機械的類別的代碼，詳見6.1-建筑起重機械類別代碼表deviceModelC..200是規格型號,使用登記證所對應的建筑起重機械的規格型號factoryNumC..200是出廠編號,建筑起重機械所對應的唯一出廠編號manufactureCorpCodeC18是制造單位統一社會信用代碼,建筑起重機械制造單位的統一社會信用代碼useCorpCodeC18是使用單位統一社會信用代碼，持該證照的使用單位的統一社會信用代碼certStatusC2是證書狀態代碼，詳見6.1-證書狀態類型代碼表certStatusDescriptionC..200滿足條件必填證書狀態描述，證書狀態為“其他”時進行的補充描述operateTypeC2是操作類型，詳見6.1-操作類型代碼表和6.1-證書狀態與操作類型關系代碼表請求參數示例{ "AcceptData":[{ "businessDataId":"73faca65c31a484b8f6b719c94******", "certId":"005.2.11100000000013338W083.11110000000021135M.2023T0000001.001.G", "areaCode":"110101", "certNum":"110101T（2023）0000001", "deviceCategoryCode":"T", "deviceModel":"QTZ80(WA6010-6A)", "factoryNum":"1012T002124869", "manufactureCorpCode":"914300007121944054", "useCorpCode":"9161070056714569XF", "certStatus":"02", "certStatusDescription":"撤銷",//證書狀態為“99”時進行的補充描述 "operateType":"30" }]}返回結果參數名稱數據類型是否必需備注ReturnCodeC1是返回代碼，詳見6.1-返回代碼代碼表ReturnMsgC..500是返回信息ReturnDataJSON是返回數據結果集Json對象ReturnData相關字段名稱數據類型是否必需備注ErrorDataJSON/錯誤信息集合，返回代碼為0時需要+ErrorGuidC..50/錯誤數據標識，返回代碼為0時需要+ErrorCodeC..50/錯誤碼，返回代碼為0時需要+certNumC..26/證照編號，返回代碼為0時需要+ErrorMsgC..1000/錯誤信息，返回代碼為0時需要SuccessDataJSON/成功數據集合，返回代碼為1時需要+businessDataIdC..50/業務數據唯一標識，返回代碼為1時需要+SuccessCodeC..50/成功碼，返回代碼為1時需要+certNumC..26/證照編號，返回代碼為1時需要+SuccessMsgC..1000/成功信息，返回代碼為1時需要返回結果示例①返回代碼為1時的結果信息：{ "ReturnCode":"1", "ReturnMsg":"證書狀態更新成功", "ReturnData":{ "SuccessData":[{ "businessDataId":"73faca65c31a484b8f6b719c94******","SuccessCode":"S-04-LEZ-XX", "certNum":"110101T（2023）0000001", "SuccessMsg":"該國家標準電子證照證書狀態更新成功" }] }}②返回代碼為0時的結果信息：{ "ReturnCode":"0", "ReturnMsg":"證書狀態更新失敗", "ReturnData":{ "ErrorData":[{ "ErrorGuid":"73faca65c31a484b8f6b719c94******","ErrorCode":"E-04-LEZ-XX", "certNum":"110101T（2023）0000001", "ErrorMsg":"XXXX" }] }}5.1.4、電子證照文件歸集接口使用場景說明：省級電子證照系統需要上報建筑起重機械使用登記證書電子證照文件信息進行歸集時，可以申請調用電子證照文件歸集接口。表5-1-4接口信息接口地址http://**/epoint-gateway/zjbzasdzzz/rest/dzzzqzjxsyjdzrest/qzjxsydjz_gj請求方式POST返回方式JSON接口說明建筑起重機械使用登記證書電子證照文件歸集接口；支持多條數據上傳，單次上傳上限10條。請求參數名稱數據類型是否必需備注AcceptDataJSON是記錄集合。Json對象AcceptData相關字段名稱數據類型是否必需備注fmcodeC..50是二維碼賦碼，業務數據歸集接口匯集成功后，如符合發放電子證照要求，則會生成二維碼賦碼密文，通過“4.1二維碼賦碼密文解密方法”解密后生成二維碼賦碼certIdC73是證照標識，由省級建筑起重機械使用登記證書電子證照系統按照規則自動生成的唯一標識，按照《全國一體化政務服務平臺電子證照建筑起重機械使用登記證書》標準附錄A.2生成certPreviewUrlC..500是證照預覽地址，安全生產許可電子證照預覽頁面URL地址，需https域名互聯網訪問請求參數示例{ "AcceptData":[{ "fmcode":"1100002022000000001", "certId":"005.2.11100000000013338W083.11110000000021135M.2023T0000001.001.G", "certPreviewUrl":"http://localhost:8089/szjsframegl/rest/frame/base/attach/attachAction/getContent?isCommondto=true&attachGuid=b9ec8896-68f2-499e-ac9f-c7b7c8e3ba94" }]}certPreviewUrl入參預覽示例返回結果參數名稱數據類型是否必需備注ReturnCodeC1是返回代碼，詳見6.1-返回代碼代碼表ReturnMsgC..500是返回信息ReturnDataJSON是返回數據結果集Json對象ReturnData相關字段名稱數據類型是否必需備注ErrorDataJSON/錯誤信息集合，返回代碼為0時需要+ErrorGuidC..50/錯誤數據標識，返回代碼為0時需要+fmcodeC..50/二維碼賦碼，返回代碼為0時需要+ErrorCodeC..50/錯誤碼，返回代碼為0時需要+certNumC..26/證照編號，返回代碼為0時需要+ErrorMsgC..1000/錯誤信息，返回代碼為0時需要SuccessDataJSON/成功數據集合，返回代碼為1時需要+fmcodeC..50/二維碼賦碼，返回代碼為1時需要+SucccessCodeC..50/成功碼，返回代碼為1時需要+certNumC..26/證照編號，返回代碼為1時需要+SuccessMsgC..1000/成功信息，返回代碼為1時需要返回結果示例①返回代碼為1時的結果信息：{ "ReturnCode":"1", "ReturnMsg":"電子證照文件歸集成功", "ReturnData":{"SuccessData":[{ "fmcode":"1100002022000000001", "SuccessCode":"S-05-LEZ-XX", "certNum":"110101T（2023）0000001", "SuccessMsg":"該國家標準電子證照證照文件歸集成功！" }]}}②返回代碼為0時的結果信息：{ "ReturnCode":"0", "ReturnMsg":"電子證照文件歸集失敗", "ReturnData":{ "ErrorData":[{ "ErrorGuid":"73faca65c31a484b8f6b719c94******", "fmcode":"1100002022000000001", "ErrorCode":"E-05-LEZ-XX", "certNum":"110101T（2023）0000001", "ErrorMsg":"fmcode錯誤，校驗失敗，請重新調整！" }] }}5.1.5、相關人員信息接收接口使用場景說明：省級電子證照系統需要上報建筑起重機械使用過程中的相關人員信息業務數據，可以申請調用相關人員信息接收接口。表5-1-5接口信息接口地址http://**/epoint-gateway/zjbzasdzzz/rest/dzzzqzjxsyjdzrest/qzjxsydjz_ryxx請求方式POST返回方式JSON接口說明建筑起重機械使用相關人員信息接收接口接口；支持多條數據上傳，單次上傳上限10條。請求參數名稱數據類型是否必需備注AcceptDataJSON是記錄集合。Json對象AcceptData相關字段名稱數據類型是否必需備注businessDataIdC36是業務數據ID，地方電子證照系統業務主鍵certNumC20是證照編號，建筑起重機械使用登記證書的唯一編號，按照《全國一體化政務服務平臺電子證照建筑起重機械使用登記證書》附錄A.1編號規則生成certIdC73是證照標識，由省級建筑起重機械使用登記證書電子證照系統按照規則自動生成的唯一標識，按照《全國一體化政務服務平臺電子證照建筑起重機械使用登記證書》標準附錄A.2生成personInfoListJSON是業務信息，按JSON各式上報建筑起重機械設備涉及的相關人員業務信息集合。Json對象personinfolist相關字段名稱數據類型是否必需備注personTypeC..50是人員類型，詳見6.1-相關人員信息業務類型代碼表nameC..50是姓名，持證人姓名，與持證人身份證件記載信息一致identityCardC..18是身份證件號碼，持證人員的有效身份證件號identityCardTypeC3是身份證件號碼類型代碼，持證人員的有效身份證件號碼類型，可取值為公民身份號碼、護照號等，從GB/T36903-2018的附錄A中選取dataFlagC1是數據有效標識，如果數據變為無效該字段為0，詳見6.1-數據有效標識字典表dataRemarkC..500滿足條件必填數據無效原因，即數據刪除原因，數據有效標識為無效時必填請求參數示例{ "AcceptData":[{ "businessDataId":"73faca65c31a484b8f6b719c94******", "certNum":"110101T（2023）0000001", "certId":"005.2.11100000000013338W083.11110000000021135M.2023T0000001.001.G", "personInfoList":[{ "personType":"1001", "name":"張**", "identityCard":"4106221988010******", "identityCardType":"111", "dataF