附件3-全國工程質量安全監(jiān)管信息平臺電子證照數(shù)據(jù)交換接口規(guī)范-建筑施工起重機械使用登記證書（試運行）

附件3全國工程質量安全監(jiān)管信息平臺建筑起重機械使用登記證書電子證照數(shù)據(jù)交換接口規(guī)范（試運行）2023年08月文檔修訂歷史序號版本修訂日期修改記錄11.02023-08全國工程質量安全監(jiān)管信息平臺電子證照數(shù)據(jù)交換接口規(guī)范-建筑起重機械使用登記證書（試運行）目錄15262一、概述 —概述1.1、目的本文檔是為全國工程質量安全監(jiān)管信息平臺與各省、自治區(qū)、直轄市、新疆生產(chǎn)建設兵團建筑起重機械使用登記證書電子證照系統(tǒng)進行數(shù)據(jù)共享提供統(tǒng)一對接標準，均按照此接口規(guī)范進行對接。1.2、參考資料《全國一體化政務服務平臺電子證照建筑起重機械使用登記證書》1.3、基本術語1.3.1、資源請求方資源請求方是指需要調用服務API的對象，是數(shù)據(jù)需求方。1.3.2、資源提供方資源提供方是指擁有資源方對外提供資源數(shù)據(jù)的對象，是數(shù)據(jù)提供方。1.3.3、服務API服務API是資源提供方對外提供數(shù)據(jù)服務的實現(xiàn)形式之一。其是由信息資源共享交換平臺基于RESTAPI技術實現(xiàn)。1.3.4、服務授權服務API只有在授權權限給相應的應用系統(tǒng)之后，資源請求方才能調用該服務API。1.4、參數(shù)類型說明C4：表示最多4位的字符型字符串，不足4位按實際位數(shù)；C..：表示可變長度的字符型字符串；N5：表示最多5位的數(shù)字型字符串，不足5位按實際位數(shù)；N..：表示可變長度的數(shù)字型字符串；Date：表示日期類型字符串。Text：表示大文本字符串。服務申請流程2.1、賬號開設各省（直轄市、自治區(qū)、新疆生產(chǎn)建設兵團）通過住建部平臺以數(shù)據(jù)接口形式上報電子證照數(shù)據(jù)，由各?。ㄖ陛犑小⒆灾螀^(qū)、新疆生產(chǎn)建設兵團）按要求填寫申請表。部信息中心對接入申請進行審核，確認信息無誤后予以批準，由部信息中心完成相關業(yè)務系統(tǒng)應用注冊工作，并將應用標識（AppKey/client_id）和應用密鑰（AppSecret/client_secret）等對接材料以郵件形式發(fā)放給各?。ㄖ陛犑?、自治區(qū)、新疆生產(chǎn)建設兵團）進行對接。服務調用流程請用戶將該接口授權的應用key、應用密鑰這兩個值提供給應用開發(fā)商，應用開發(fā)商按照下面的步驟調用接口資源。3.1、步驟一、獲取認證token共享平臺提供基于OAuth2.0的統(tǒng)一身份鑒權方式。第三方應用通過申請令牌token，來完成對API的調用訪問，各省份的應用標識client_id與client_secret會提前分發(fā)。其中對于所有訪問用戶隱私API的請求，需要提供用戶授權令牌來校驗該第三方調用是否是合法調用，而對于所有平臺基礎支撐API，需要提供客戶端授權令牌來進行校驗。關于OAuth2.0協(xié)議的詳細介紹，可以參考W3C的官方文檔。開發(fā)者可以先瀏覽OAuth2.0的接口文檔，熟悉OAuth2的接口及參數(shù)的含義，然后我們根據(jù)用戶授權認證和客戶端授權認證2種場景各自說明如何使用OAuth2.0。表3-1接口信息接口地址（政務外網(wǎng)）http://**/epoint-soa-web/rest/oauth2/token請求方式POST參數(shù)格式請求參數(shù)Body類型：x-www-form-urlencoded接口說明獲取token請求參數(shù)參數(shù)名數(shù)據(jù)類型是否必需說明client_idC...是應用標識client_secretC...是應用密碼grant_typeC...是固定值：client_credentials請求參數(shù)示例返回結果參數(shù)參數(shù)名數(shù)據(jù)類型是否必需說明access_tokenC...是最終獲取到的tokenrefresh_tokenC...是刷新token票據(jù)expires_inC...是token有效期返回結果示例正確示例：錯誤示例：{3.2、步驟二、上傳資源數(shù)據(jù)根據(jù)得到的token,調用接口,上傳數(shù)據(jù)。3.3、Java代碼參考示例publicclassCallAPI{//客戶端賬號標識,請修正為實際值staticStringAppKey="eae5****-****-****-****-********58a7";//客戶端賬號密碼,請修正為實際值staticStringAppSecret="d0c9****-****-****-****-********096c";//認證平臺地址，具備token接口，只需要配置到認證平臺應用系統(tǒng)名即可,請修正為實際值staticStringSSOUrl=":port/epoint-sso-web";//調用憑證，考慮憑證需要遠程調用接口獲取，需要靜態(tài)化，不用每次調用重新獲取staticAssertionTokenInfo;//生成調用憑證staticAssertiongetToken(booleanrefresh){//如果憑證已經(jīng)生成且不需要強制更新的情況下，則只需要獲取原有憑證即可，避免不必要的遠程調用if(TokenInfo==null||refresh){//利用SDK方法獲取調用憑證，傳入客戶端賬號、密碼和認證平臺地址，采用的是客戶端認證模式TokenInfo=AssertionUtil.getAssertionStateless(AppKey,AppSecret,SSOUrl);}returnTokenInfo;}//調用最終API方法publicstaticStringAPIInvoke(StringUrl,StringAccess_Token,Map<string,object="">Params){//實際需要調用的API的地址，將調用憑證token作為參數(shù)傳入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的參數(shù),請修正為實際值Map<string,object="">Params=newHashMap<>();Params.put("服務器IP","");//考慮調用憑證緩存化，一定時間后調用憑證肯定會過期，當憑證過期時，引入重試機制，即憑證需要強制更新，并重新調用API接口//本示例重試最多3次，3次失敗則不再繼續(xù)重試。for(inti=0;i<3;i++){StringAccess_Token=getToken(i>0).getAccessToken();Stringresult=APIInvoke(Url,Access_Token,Params);If("1".equals(result)){break;}}}}此方法預期會出現(xiàn)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上傳成功（業(yè)務數(shù)據(jù)校驗接口、電子證照文件歸集接口、數(shù)據(jù)更正接口）上傳成功，操作類型為01或02時返回二維碼賦碼（業(yè)務數(shù)據(jù)賦碼接口）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，那么這個構造函數(shù)不會檢查key是否為8個字節(jié)長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位數(shù)字，通過“4.1.3解密方法”解密以上解密方法需要的privateKeyString私鑰參數(shù)值，由住房和城鄉(xiāng)建設部全國工程質量安全監(jiān)管信息平臺技術支持單獨提供。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，那么這個構造函數(shù)不會檢查key是否為8個字節(jié)長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數(shù)據(jù)轉換成十六進制的字符串表示。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位轄區(qū)代碼以上加密方法需要的publicKeyString公鑰參數(shù)值，由住房和城鄉(xiāng)建設部全國工程質量安全監(jiān)管信息平臺技術支持單獨提供。對接接口標準5.1、建筑起重機械使用登記證書根據(jù)業(yè)務場景提供建筑起重機械使用登記證書調用接口的詳細說明，流程指南詳見附錄1。推送操作類型原證書狀態(tài)推送的證書狀態(tài)賦碼調用接口順序辦理新發(fā)電子證照和既有電子證照后續(xù)業(yè)務場景辦理新發(fā)電子證照/有效是①業(yè)務數(shù)據(jù)校驗接口②業(yè)務數(shù)據(jù)賦碼接口③相關人員信息接收接口④電子證照文件歸集接口辦理注銷有效注銷否①相關人員信息接收接口②證書狀態(tài)變更接口辦理注銷失效注銷否辦理撤銷有效撤銷否①證書狀態(tài)變更接口辦理撤銷失效撤銷否辦理失效有效失效否辦理其他業(yè)務失效有效否5.1.1、業(yè)務數(shù)據(jù)校驗接口使用場景說明：省級電子證照系統(tǒng)進行業(yè)務審批需要上報建筑起重機械使用登記證書業(yè)務數(shù)據(jù)時，提前對數(shù)據(jù)預校驗，可以申請調用業(yè)務數(shù)據(jù)校驗接口。表5-1-1接口信息接口地址http://**/epoint-gateway/zjbzasdzzz/rest/dzzzqzjxsyjdzrest/qzjxsydjz_check請求方式POST返回方式JSON接口說明建筑起重機械使用登記證書業(yè)務數(shù)據(jù)校驗接口；支持多條數(shù)據(jù)上傳，單次上傳上限10條。請求參數(shù)名稱數(shù)據(jù)類型是否必需備注AcceptDataJSON是記錄集合。Json對象AcceptData相關字段名稱數(shù)據(jù)類型是否必需備注businessDataIdC36是業(yè)務數(shù)據(jù)ID，地方電子證照系統(tǒng)業(yè)務主鍵areaCodeC6是所屬省、自治區(qū)、直轄市、市轄區(qū)行政區(qū)劃代碼，按照民政部官網(wǎng)《2020年中華人民共和國行政區(qū)劃代碼》deviceCategoryCodeC1是類別代碼，使用登記證所對應的建筑起重機械的類別的代碼，詳見6.1-建筑起重機械類別代碼表deviceModelC..200是規(guī)格型號,使用登記證所對應的建筑起重機械的規(guī)格型號factoryNumC..200是出廠編號，建筑起重機械所對應的唯一出廠編號manufactureCorpCodeC18是制造單位統(tǒng)一社會信用代碼,建筑起重機械制造單位的統(tǒng)一社會信用代碼operateTypeC2是操作類型，詳見6.1-操作類型代碼表和6.1-證書狀態(tài)與操作類型關系代碼表certNumC20滿足條件必填證照編號，建筑起重機械使用登記證書的唯一編號，按照《全國一體化政務服務平臺電子證照建筑起重機械使用登記證書》附錄A.1編號規(guī)則生成，當操作類型是辦理新發(fā)電子證照時，非必填，其他的操作類型要求必填請求參數(shù)示例{ "AcceptData":[{ "businessDataId":"73faca65c31a484b8f6b719c94******", "areaCode":"110101", "deviceCategoryCode":"T", "deviceModel":"QTZ80(WA6010-6A)", "factoryNum":"1012T002124869", "manufactureCorpCode":"914300007121944054", "operateType":"10", "certNum":"110101T（2023）0000001" }]}返回結果參數(shù)名稱數(shù)據(jù)類型是否必需備注ReturnCodeC1是返回代碼，詳見6.1-返回代碼代碼表ReturnMsgC..500是返回信息ReturnDataJSON是返回數(shù)據(jù)結果集Json對象ReturnData相關字段名稱數(shù)據(jù)類型是否必需備注ErrorDataJSON/錯誤信息集合，返回代碼為0時需要+ErrorGuidC..50/錯誤數(shù)據(jù)標識，返回代碼為0時需要+ErrorCodeC..50/錯誤碼，返回代碼為0時需要+ErrorMsgC..1000/錯誤信息，返回代碼為0時需要SuccessDataJSON/成功數(shù)據(jù)集合，返回代碼為1時需要+businessDataIdC..50/業(yè)務數(shù)據(jù)ID，返回代碼為1時需要+SuccessCodeC..50/成功碼，返回代碼為1時需要+SuccessMsgC..1000/成功信息，返回代碼為1時需要WarnDataJSON/預警信息集合，返回代碼為2時需要+WarnGuidC..50/預警數(shù)據(jù)標識，返回代碼為2時需要+WarnCodeC..50/預警碼，返回代碼為2時需要+WarnMsgC..1000/預警信息，返回代碼為2時需要返回結果示例①返回代碼為1時的結果信息：{ "ReturnCode":"1", "ReturnMsg":"業(yè)務數(shù)據(jù)校驗成功", "ReturnData":{ "SuccessData":[{ "businessDataId":"73faca65c31a484b8f6b719c94******", "SuccessCode":"S-02-LEZ-XX", "SuccessMsg":"該國家標準電子證照業(yè)務數(shù)據(jù)校驗成功" }] }}②返回代碼為0時的結果信息：{ "ReturnCode":"0", "ReturnMsg":"業(yè)務數(shù)據(jù)校驗失敗", "ReturnData":{ "ErrorData":[{ "ErrorGuid":"73faca65c31a484b8f6b719c94******", "ErrorCode":"E-02-LEZ-XX", "ErrorMsg":"該制造單位漢中市金志建筑機械安裝租賃有限責任公司的起重機械設備（出廠編號：1012T002124868），已存在國家標準電子證照，發(fā)證地：北京市，證照編號：110101T（2023）*******！" }] }}③返回代碼為2時的結果信息：{ "ReturnCode":"2", "ReturnMsg":"業(yè)務數(shù)據(jù)校驗成功有預警", "ReturnData":{ "WarnData":[{ "WarnGuid":"73faca65c31a484b8f6b719c94******", "WarnCode":"E-02-LEZ-XX", "WarnMsg":"XXXX" }], "SuccessData":[{ "businessDataId":"73faca65c31a484b8f6b719c94******", "SuccessCode":"S-02-LEZ-XX", "SuccessMsg":"該國家標準電子證照業(yè)務數(shù)據(jù)校驗成功" }] }}5.1.2、業(yè)務數(shù)據(jù)賦碼接口使用場景說明：省級電子證照系統(tǒng)需要上報建筑起重機械使用登記證書業(yè)務數(shù)據(jù)進行歸集并申請二維碼賦碼時，可以申請調用業(yè)務數(shù)據(jù)賦碼接口。補充說明：當操作類型“辦理新發(fā)電子證照”時，需要將設備基本信息作為業(yè)務信息參數(shù)進行上報。表5-1-2接口信息接口地址http://**/epoint-gateway/zjbzasdzzz/rest/dzzzqzjxsyjdzrest/qzjxsydjz_fm請求方式POST返回方式JSON接口說明建筑起重機械使用登記證書業(yè)務數(shù)據(jù)賦碼接口；支持多條數(shù)據(jù)上傳，單次上傳上限10條；操作類型為“辦理新發(fā)電子證照”時會進行二維碼賦碼。請求參數(shù)名稱數(shù)據(jù)類型是否必需備注AcceptDataJSON是記錄集合。Json對象AcceptData相關字段名稱數(shù)據(jù)類型是否必需備注businessDataIdC36是業(yè)務數(shù)據(jù)ID，地方電子證照系統(tǒng)業(yè)務主鍵areaCodeC6是所屬省、自治區(qū)、直轄市、市轄區(qū)行政區(qū)劃代碼，按照民政部官網(wǎng)《2020年中華人民共和國行政區(qū)劃代碼》certNumC20是證照編號，建筑起重機械使用登記證書的唯一編號，按照《全國一體化政務服務平臺電子證照建筑起重機械使用登記證書》附錄A.1編號規(guī)則生成issuAuthNameC..200是發(fā)證機關，負責頒發(fā)和管理該建筑起重機械使用登記證書的縣級及以上人民政府住房城鄉(xiāng)建設主管部門名稱issuAuthCodeC18是發(fā)證機關代碼，證照頒發(fā)機關的統(tǒng)一社會信用代碼issuDateDate是發(fā)證日期，該證照頒發(fā)的日期，按照公元紀年精確至日。用于照面展示時，用阿拉伯數(shù)字將年、月、日標全，月、日不標虛位deviceCategoryCodeC1是類別代碼,使用登記證所對應的建筑起重機械的類別的代碼，詳見6.1-建筑起重機械類別代碼表deviceModelC..200是規(guī)格型號,使用登記證所對應的建筑起重機械的規(guī)格型號factoryNumC..200是出廠編號,建筑起重機械所對應的唯一出廠編號recordNumC16是備案編號,由產(chǎn)權單位在建筑起重機械首次出租或安裝前，向本單位工商注冊所在地縣級及以上地方人民政府建設主管部門辦理的備案證明的編號manufactureCorpNameC..200是制造單位,建筑起重機械制造單位的名稱manufactureCorpCodeC18是制造單位統(tǒng)一社會信用代碼,建筑起重機械制造單位的統(tǒng)一社會信用代碼propertyCorpNameC..200是產(chǎn)權單位,建筑起重機械出租單位或者自購建筑起重機械使用單位propertyCorpCodeC18是產(chǎn)權單位統(tǒng)一社會信用代碼,建筑起重機械產(chǎn)權單位的統(tǒng)一社會信用代碼projectNameC..200是工程名稱,辦理該建筑起重機械使用登記的建設工程的名稱projectLocationC..200是工程項目地址,辦理該建筑起重機械使用登記的建設工程所在的詳細地址applyConstructionPermitC1是是否辦理施工許可證,建筑起重機械使用登記的建設工程是否辦理施工許可證constructionPermitNumC18滿足條件必填建筑工程施工許可證編號,建筑起重機械使用登記的建設工程的施工許可證唯一標識碼，已辦理施工許可證時必填useCorpNameC..200是使用單位,建筑起重機械使用單位名稱useCorpCodeC18是使用單位統(tǒng)一社會信用代碼,建筑起重機械使用單位的統(tǒng)一社會信用代碼maintenanceCorpNameC..200是維保單位,進行建筑起重機械維修保養(yǎng)單位的名稱maintenanceCorpCodeC18是維保單位統(tǒng)一社會信用代碼,建筑起重機械維保單位的統(tǒng)一社會信用代碼useCorpManagerC..50是使用單位項目負責人,建筑施工起重機械使用單位的項目負責人useCorpManagerIdC..18是使用單位項目負責人身份證件號碼,建筑施工起重機械使用單位的負責人有效身份證件號碼installCorpNameC..200是安裝單位,從事建筑起重機械安裝活動的單位，安裝單位應具有相關資質installCorpCodeC18是安裝單位統(tǒng)一社會信用代碼,建筑起重機械的安裝單位的統(tǒng)一社會信用代碼installDateDate是安裝日期，建筑起重機械安裝日期，按照公元紀年精確至日。用于照面展示時，用阿拉伯數(shù)字將年、月、日標全，月、日不標虛位installPositionC..20是安裝位置，建筑起重機械安裝的具體位置信息，用基于2000國家大地坐標系（CGCS2000）的經(jīng)緯度坐標點表示，格式為“經(jīng)度,緯度”,經(jīng)緯度至少精確到小數(shù)點后第四位testCorpNameC..200是檢測單位，進行建筑起重機械檢測的單位名稱testCorpCodeC18是檢測單位統(tǒng)一社會信用代碼，建筑起重機械檢測單位的統(tǒng)一社會信用代碼testDateDate是檢測日期，建筑起重機械安裝檢測合格報告出具日期，按照公元紀年精確至日。用于照面展示時，用阿拉伯數(shù)字將年、月、日標全，月、日不標虛位certStatusC2是證書狀態(tài)代碼，詳見6.1-證書狀態(tài)類型代碼表certStatusDescriptionC..200滿足條件必填證書狀態(tài)描述，證書狀態(tài)為“其他”時進行的補充描述associatedCertIdC73滿足條件必填關聯(lián)證照標識，該證書關聯(lián)的最近一個已失效建筑起重機械使用登記證書的標識，規(guī)則同表5-1-4中的“證照標識”businessInformationJSON是業(yè)務信息，按JSON串方式（第一個參數(shù)為持證主體或證照本身關聯(lián)的業(yè)務類型，第二個參數(shù)為持證主體或證照本身涉及的業(yè)務信息）方式組織的對應業(yè)務類型代碼的具體業(yè)務信息，參數(shù)類型詳見6.1-設備基本信息業(yè)務類型代碼表，需要上報設備基本信息operateTypeC2是操作類型，詳見6.1-操作類型代碼表和6.1-證書狀態(tài)與操作類型關系代碼表請求參數(shù)示例{ "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":"中聯(lián)重科股份有限公司", "manufactureCorpCode":"914300007121944054", "propertyCorpName":"漢中市金志建筑機械安裝租賃有限責任公司", "propertyCorpCode":"9161070056714569XF", "projectName":"北京市建設工程項目", "projectLocation":"北京市北京市朝陽區(qū)建國路18號", "applyConstructionPermit":"1", "constructionPermitNum":, "useCorpName":"漢中市金志建筑機械安裝租賃有限責任公司", "useCorpCode":"9161070056714569XF", "maintenanceCorpName":"中聯(lián)重科股份有限公司", "maintenanceCorpCode":"914300007121944054", "useCorpManager":"張三", "useCorpManagerId":", "installCorpName":"中聯(lián)重科股份有限公司", "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" }]}返回結果參數(shù)名稱數(shù)據(jù)類型是否必需備注ReturnCodeC1是返回代碼，詳見6.1-返回代碼代碼表ReturnMsgC..500是返回信息ReturnDataJSON是返回數(shù)據(jù)結果集Json對象ReturnData相關字段名稱數(shù)據(jù)類型是否必需備注ErrorDataJSON/錯誤信息集合，返回代碼為0時需要+ErrorGuidC..50/錯誤數(shù)據(jù)標識，返回代碼為0時需要+ErrorCodeC..50/錯誤碼，返回代碼為0時需要+ErrorMsgC..1000/錯誤信息，返回代碼為0時需要SuccessDataJSON/成功數(shù)據(jù)集合，返回代碼為1時需要+businessDataIdC..50/業(yè)務數(shù)據(jù)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":"業(yè)務數(shù)據(jù)賦碼成功", "SuccessData":[{ "businessDataId":"73faca65c31a484b8f6b719c94******", "SuccessCode":"S-03-LEZ-XX", "encryCertid":"EDBE76D9217A23212E5546FD5B8F61E4671575AD27******", "encryKey":"Th2MCBlpx2sGE69qphb0dtb3yZo4jIJ4F9nWR4kMR5vXvmQDTPm0LT+GO9V+AFXkD1ZH7vm1oHsD3H7e2b******", "SuccessMsg":"" }]}②返回代碼為0時的結果信息：{ "ReturnCode":"0", "ReturnMsg":"業(yè)務數(shù)據(jù)賦碼失敗", "ReturnData":{ "ErrorData":[{ "ErrorGuid":"73faca65c31a484b8f6b719c94******", "ErrorCode":"E-03-LEZ-XX", "ErrorMsg":

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

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