SL/T816.1-2025IIISL/T816.1-2025水利電子證照第1部分：基本技術(shù)要求目 次1范圍 12規(guī)范性引用文件 13術(shù)語(yǔ)和定義 14水利電子證照系統(tǒng) 15水利電子證照服務(wù) 15.1服務(wù)概述 15.2電子證照對(duì)接核驗(yàn)服務(wù) 25.3電子證照新辦服務(wù) 25.4電子證照延續(xù)服務(wù) 35.5電子證照變更服務(wù) 35.6電子證照注銷(xiāo)服務(wù) 45.7電子證照下載服務(wù) 46電子印章對(duì)接 47網(wǎng)絡(luò)要求 58安全防護(hù)技術(shù)要求 58.1授權(quán)認(rèn)證 58.2數(shù)據(jù)安全管理 58.3安全審計(jì)與監(jiān)控 58.4安全等級(jí)保護(hù)要求 59模板管理要求 59.1水利電子證照基本要素 59.2OFD電子模板管理要求 6附錄A（資料性）電子證照服務(wù)對(duì)接示例 7附錄B（資料性）電子證照特殊說(shuō)明 16附錄C（資料性）簽名算法代碼參考（JAVA） 17SL/T816.1-20251水利電子證照第1部分：基本技術(shù)要求1范圍本標(biāo)準(zhǔn)規(guī)定了水利電子證照系統(tǒng)、水利電子證照服務(wù)、電子印章對(duì)接、網(wǎng)絡(luò)要求、安全防護(hù)技術(shù)要求和模板管理要求。本標(biāo)準(zhǔn)適用于水利部（含部本級(jí)和流域管理機(jī)構(gòu)）及省級(jí)水行政主管部門(mén)建設(shè)、維護(hù)和使用水利電子證照系統(tǒng)，發(fā)放和應(yīng)用水利電子證照。2規(guī)范性引用文件下列文件中的內(nèi)容通過(guò)文中的規(guī)范性引用而構(gòu)成本標(biāo)準(zhǔn)必不可少的條款。其中，注日期的引用文件，僅該日期對(duì)應(yīng)的版本適用于本標(biāo)準(zhǔn)；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本標(biāo)準(zhǔn)。GB/T7408數(shù)據(jù)元和交換格式信息交換日期和時(shí)間表示法GB/T33190電子文件存儲(chǔ)與交換格式版式文檔GB/T33481黨政機(jī)關(guān)電子印章應(yīng)用規(guī)范GB/T36901電子證照總體技術(shù)架構(gòu)GB/T36902電子證照目錄信息規(guī)范GB/T36903電子證照元數(shù)據(jù)規(guī)范GB/T36904電子證照標(biāo)識(shí)規(guī)范GB/T36905電子證照文件技術(shù)要求GB/T36906電子證照共享服務(wù)接口規(guī)范GB/T38540信息安全技術(shù)安全電子簽章密碼技術(shù)規(guī)范3術(shù)語(yǔ)和定義下列術(shù)語(yǔ)和定義適用于本標(biāo)準(zhǔn)。3.1水利電子證照electroniclicensesinwateradministration由各級(jí)水行政主管部門(mén)依據(jù)國(guó)家有關(guān)法律法規(guī)和標(biāo)準(zhǔn)規(guī)范，統(tǒng)一制作、核發(fā)的電子數(shù)據(jù)文件。4水利電子證照系統(tǒng)水利電子證照系統(tǒng)是水利部政務(wù)服務(wù)平臺(tái)的支撐系統(tǒng)，實(shí)現(xiàn)了涉水政務(wù)服務(wù)事項(xiàng)的水利電子證照制發(fā)，通過(guò)接口對(duì)接形式，與全國(guó)一體化政務(wù)服務(wù)平臺(tái)和國(guó)家電子證照系統(tǒng)對(duì)接，為水利部（含部本級(jí)和流域管理機(jī)構(gòu)）和省級(jí)水行政主管部門(mén)提供對(duì)接核驗(yàn)、證照新辦、證照延續(xù)、證照變更、證照注銷(xiāo)、證照下載等服務(wù)，生成的涉水電子證照數(shù)據(jù)存儲(chǔ)于全國(guó)水利電子證照庫(kù)，水利電子證照系統(tǒng)架構(gòu)圖見(jiàn)圖1。5水利電子證照服務(wù)5.1服務(wù)概述水利部（含部本級(jí)和流域管理機(jī)構(gòu)）和省級(jí)政務(wù)服務(wù)平臺(tái)應(yīng)與水利電子證照系統(tǒng)進(jìn)行對(duì)接，實(shí)現(xiàn)電子證照系統(tǒng)對(duì)接核驗(yàn)、證照新辦、證照延續(xù)、證照變更、證照注銷(xiāo)、證照下載等服務(wù)（見(jiàn)表1)，SL/T816.1-20252電子證照服務(wù)對(duì)接示例見(jiàn)附錄A，返回狀態(tài)碼和問(wèn)題描述見(jiàn)附錄B，簽名算法代碼見(jiàn)附錄C。圖1水利電子證照系統(tǒng)架構(gòu)圖表1電子證照共享服務(wù)列表序號(hào)服務(wù)服務(wù)提供方服務(wù)使用方1電子證照對(duì)接核驗(yàn)服務(wù)水利電子證照系統(tǒng)審批系統(tǒng)2電子證照新辦服務(wù)3電子證照延續(xù)服務(wù)4電子證照變更服務(wù)5電子證照注銷(xiāo)服務(wù)6電子證照下載服務(wù)5.2電子證照對(duì)接核驗(yàn)服務(wù)電子證照對(duì)接核驗(yàn)服務(wù)用于獲取token令牌，如果token過(guò)期應(yīng)重新申請(qǐng)，電子證照對(duì)接核驗(yàn)服務(wù)參數(shù)見(jiàn)表2。表2電子證照對(duì)接核驗(yàn)服務(wù)參數(shù)參數(shù)類(lèi)型參數(shù)名類(lèi)型說(shuō)明是否必填輸人參數(shù)datajson系統(tǒng)對(duì)接核驗(yàn)密鑰信息：appKey、appSecret是輸出參數(shù)successbool狀態(tài)true為token獲取成功，狀態(tài)false為token獲取失敗否dataobjecttoken宇符串msgstring提示信息statusint狀態(tài)碼timestampslong時(shí)間戳5.3電子證照新辦服務(wù)電子證照新辦服務(wù)用于首次生成電子證照，電子證照新辦服務(wù)參數(shù)見(jiàn)表3。SL/T816.1-20253表3電子證照新辦服務(wù)參數(shù)參數(shù)類(lèi)型參數(shù)名類(lèi)型說(shuō)明是否必填輸入?yún)?shù)datajson新辦證照屬性字段（證照名稱、編號(hào)、發(fā)證機(jī)關(guān)、發(fā)證日期、單位名稱或個(gè)人姓名、統(tǒng)一社會(huì)信用代碼或身份證件號(hào)碼、有效期限等字段）是輸出參數(shù)successbool狀態(tài)true為新辦服務(wù)調(diào)用成功，狀態(tài)false為新辦服務(wù)調(diào)用失敗否dataobject服務(wù)返回信息msgstring提示信息statusint狀態(tài)碼timestampslong時(shí)間戳5.4電子證照延續(xù)服務(wù)電子證照延續(xù)服務(wù)參數(shù)見(jiàn)表4。表4電子證照延續(xù)服務(wù)參數(shù)參數(shù)類(lèi)型參數(shù)名類(lèi)型說(shuō)明是否必填輸入?yún)?shù)datajson延續(xù)證照屬性字段（證照名稱、編號(hào)、發(fā)證機(jī)關(guān)、發(fā)證日期、單位名稱或個(gè)人姓名、統(tǒng)一社會(huì)信用代碼或身份證件號(hào)碼、有效期限等字段）是輸出參數(shù)successbool狀態(tài)true為延續(xù)服務(wù)調(diào)用成功。狀態(tài)false為延續(xù)服務(wù)調(diào)用失敗否dataobject服務(wù)返回信息msgstring提示信息statusint狀態(tài)碼timestampslong時(shí)間戳5.5電子證照變更服務(wù)電子證照變更服務(wù)參數(shù)見(jiàn)表5。表5電子證照變更服務(wù)參數(shù)參數(shù)類(lèi)型參數(shù)名類(lèi)型說(shuō)明是否必填輸人參數(shù)datajson變更證照屬性字段（證照名稱、編號(hào)、發(fā)證機(jī)關(guān)、發(fā)證日期、單位名稱或個(gè)人姓名、統(tǒng)一社會(huì)信用代碼或身份證件號(hào)碼、有效期限等字段）是SL/T816.1-20254表5電子證照變更服務(wù)參數(shù)（續(xù)）參數(shù)類(lèi)型參數(shù)名類(lèi)型說(shuō)明是否必填輸出參數(shù)successbool狀態(tài)true為變更服務(wù)調(diào)用成功，狀態(tài)false為變更服務(wù)調(diào)用失敗否dataobject服務(wù)返回信息msgstring提示信息statusint狀態(tài)碼timestampslong時(shí)間戳5.6電子證照注銷(xiāo)服務(wù)電子證照注銷(xiāo)服務(wù)參數(shù)見(jiàn)表6。表6電子證照注銷(xiāo)服務(wù)參數(shù)參數(shù)類(lèi)型參數(shù)名類(lèi)型說(shuō)明是否必填輸入?yún)?shù)datajson注銷(xiāo)證照屬性字段（證照唯一ID）是輸出參數(shù)successbool狀態(tài)true為注銷(xiāo)服務(wù)調(diào)用成功。狀態(tài)false為注銷(xiāo)服務(wù)調(diào)用失敗否dataobject服務(wù)返回信息msgstring提示信息statusint狀態(tài)碼timestampslong時(shí)間戳5.7電子證照下載服務(wù)電子證照下載服務(wù)參數(shù)見(jiàn)表7。表7電子證照下載服務(wù)參數(shù)參數(shù)類(lèi)型參數(shù)名類(lèi)型說(shuō)明是否必填輸入?yún)?shù)appTokenstring取登錄服務(wù)返回值是appKeystring系統(tǒng)key是idstring文件ID，新辦、延續(xù)、變更返回值中的id是輸出參數(shù)fileDatafileOFD文件否6電子印章對(duì)接水利部（含部本級(jí)和流域管理機(jī)構(gòu)）和省級(jí)水行政主管部門(mén)應(yīng)使用本級(jí)政務(wù)服務(wù)平臺(tái)電子印章系統(tǒng)，遵照本級(jí)電子印章管理辦法使用電子印章，不具備使用條件的應(yīng)按照GB/T33481、GB/T38540及全國(guó)一體化政務(wù)服務(wù)平臺(tái)電子印章技術(shù)要求完成電子印章系統(tǒng)建設(shè)，實(shí)現(xiàn)與國(guó)家政務(wù)服務(wù)平臺(tái)電子印章系統(tǒng)對(duì)接，同時(shí)應(yīng)對(duì)本級(jí)政務(wù)服務(wù)平臺(tái)電子印章系統(tǒng)進(jìn)行兼容性測(cè)試，建立應(yīng)急處理機(jī)制，確保系統(tǒng)穩(wěn)定運(yùn)行。提供電子印章CA支撐的機(jī)構(gòu)應(yīng)納入國(guó)家密碼管理局發(fā)布的《電子政務(wù)電子認(rèn)證服務(wù)SL/T816.1--20255機(jī)構(gòu)目錄》，電子印章應(yīng)在國(guó)家政務(wù)服務(wù)平臺(tái)完成備案，在本級(jí)范圍內(nèi)提供電子印章申請(qǐng)、制作、備案、變更、注銷(xiāo)等服務(wù)，實(shí)現(xiàn)數(shù)據(jù)互通共享。電子印章系統(tǒng)對(duì)接應(yīng)滿足下列要求：a）支持對(duì)OFD文件簽章。b）電子證照元數(shù)據(jù)等信息在簽章時(shí)不應(yīng)被篡改。c）簽章方式支持UKEY簽章或云簽章，UKEY簽章應(yīng)提供簽章集成頁(yè)面，云簽章應(yīng)提供簽章服務(wù)。d）部署在國(guó)家電子政務(wù)外網(wǎng)，支持與水利電子證照系統(tǒng)雙向訪問(wèn)。7網(wǎng)絡(luò)要求應(yīng)與國(guó)家電子政務(wù)外網(wǎng)互聯(lián)互通，網(wǎng)絡(luò)數(shù)據(jù)傳輸、接入控制等應(yīng)遵照國(guó)家電子政務(wù)外網(wǎng)建設(shè)要求執(zhí)行。8安全防護(hù)技術(shù)要求8.1授權(quán)認(rèn)證與水利電子證照系統(tǒng)對(duì)接的系統(tǒng)，應(yīng)通過(guò)對(duì)接核驗(yàn)服務(wù)獲取授權(quán)后實(shí)現(xiàn)對(duì)接。8.2數(shù)據(jù)安全管理水利電子證照系統(tǒng)及與其對(duì)接的系統(tǒng)，應(yīng)對(duì)電子證照數(shù)據(jù)信息建立可靠的存儲(chǔ)、備份、恢復(fù)等機(jī)制，采用數(shù)據(jù)分類(lèi)分級(jí)、加密等措施，對(duì)服務(wù)傳輸及存儲(chǔ)過(guò)程中個(gè)人信息和重要數(shù)據(jù)進(jìn)行安全防護(hù)，防止數(shù)據(jù)丟失或損壞，確保數(shù)據(jù)的安全性、完整性、保密性。8.3安全審計(jì)與監(jiān)控水利電子證照系統(tǒng)及與其對(duì)接的系統(tǒng)，應(yīng)建立安全審計(jì)機(jī)制，記錄服務(wù)的訪問(wèn)日志和操作記錄，以便進(jìn)行安全審計(jì)和追溯，并對(duì)服務(wù)運(yùn)行狀態(tài)實(shí)時(shí)監(jiān)控，及時(shí)發(fā)現(xiàn)、處理安全隱患。8.4安全等級(jí)保護(hù)要求水利電子證照系統(tǒng)及與其對(duì)接的系統(tǒng)，應(yīng)具備完善的網(wǎng)絡(luò)安全防護(hù)措施，符合計(jì)算機(jī)信息系統(tǒng)安全等級(jí)保護(hù)三級(jí)要求。9模板管理要求9.1水利電子證照基本要素水利電子證照包含但不限于下列基本要素信息：a）證照名稱：依據(jù)國(guó)家或行業(yè)相關(guān)規(guī)定而確定的證照命名，宜與所屬證照類(lèi)型的類(lèi)型名稱相同。b）證照編碼：電子證照唯一編號(hào)，應(yīng)顯示在照面上，取值應(yīng)由發(fā)證機(jī)關(guān)級(jí)別代碼、項(xiàng)目所在行政區(qū)劃代碼、發(fā)證年度號(hào)、首次發(fā)證年份、順序號(hào)等組成。c）發(fā)證機(jī)關(guān)：頒發(fā)并管理水利電子證照的水行政主管部門(mén)，數(shù)據(jù)類(lèi)型及格式為字符串，長(zhǎng)度不大于100個(gè)字符。d）持證主體：持證主體為法人或其他組織的，單位名稱應(yīng)與注冊(cè)登記的信息一致，持證主體為公民的，公民姓名應(yīng)與有效身份證件的信息一致。e）所在地（行政區(qū)劃）：取證工程（單位或個(gè)人）所在行政區(qū)劃。f）地理信息：有地理位置的證照（如取水工程的地理位置），應(yīng)包括坐標(biāo)系、經(jīng)緯度坐標(biāo)或經(jīng)緯SL/T816.1-20256度坐標(biāo)范圍，值域?yàn)?000國(guó)家大地坐標(biāo)系、1985國(guó)家高程基準(zhǔn)。g）證照有效期起始日期：數(shù)據(jù)類(lèi)型為日期，格式為yyyy（年）mm（月）dd（日），按公元紀(jì)年精確至日；采用阿拉伯?dāng)?shù)字，將年、月、日標(biāo)全，月、日不標(biāo)虛位，應(yīng)符合GB/T7408的要求。h）證照有效期終止日期：數(shù)據(jù)類(lèi)型為日期，格式為yyyy（年）mm（月）dd（日），按公元紀(jì)年精確至日；采用阿拉伯?dāng)?shù)字，將年、月、日標(biāo)全，月、日不標(biāo)虛位，應(yīng)符合GB/T7408的要求。9.2OFD電子模板管理要求水利部（含部本級(jí)和流域管理機(jī)構(gòu)）及地方水行政主管部門(mén)批準(zhǔn)的水利電子證照應(yīng)使用水利部統(tǒng)一監(jiān)制的OFD電子模板生成電子證照，OFD電子模板由水利電子證照系統(tǒng)的發(fā)證服務(wù)統(tǒng)一提供。水利電子證照許可登記的信息全部確定后，由申請(qǐng)制證部門(mén)的制證系統(tǒng)向部本級(jí)發(fā)證服務(wù)推送數(shù)據(jù)制證申請(qǐng)，經(jīng)形式核驗(yàn)通過(guò)后實(shí)時(shí)生成包含電子證照編號(hào)的OFD電子模板。各申請(qǐng)制證部門(mén)取得證照模板后，將水利電子證照信息填充到模板中形成證照版式文件，同時(shí)加蓋發(fā)證單位審批專(zhuān)用章。SL/T816.1-20257附錄A（資料性）電子證照服務(wù)對(duì)接示例A.1服務(wù)使用說(shuō)明A.1.1返回值統(tǒng)一格式返回值統(tǒng)一格式見(jiàn)表A.1。表A.1返回值統(tǒng)一格式參數(shù)名類(lèi)型說(shuō)明successbool狀態(tài)true或falsedataobject{〕msgstring提示信息statusint狀態(tài)碼timestampslong時(shí)間戳A.1.2請(qǐng)求參數(shù)對(duì)于POST請(qǐng)求且contentType=application/json;charset=UTF-8的服務(wù)，系統(tǒng)通過(guò)使用ap-pKey/appSecret對(duì)稱加密的方式來(lái)驗(yàn)證某個(gè)請(qǐng)求的發(fā)送者身份。appKey用于標(biāo)識(shí)調(diào)用者身份（每個(gè)發(fā)證機(jī)關(guān)對(duì)應(yīng)不同的appKey),appSecret是調(diào)用者用于加密請(qǐng)求BODY和電子證照系統(tǒng)用來(lái)驗(yàn)證簽名字符串的密鑰，其中appSecret必須保密。當(dāng)項(xiàng)目需要向電子證照系統(tǒng)發(fā)送請(qǐng)求時(shí)，應(yīng)以請(qǐng)求的byte流作為簽名字符串，使用appSecret進(jìn)行加密產(chǎn)生簽名結(jié)果，并將請(qǐng)求byte流設(shè)置到HTTP-BODY中。A.1.3返回參數(shù)系統(tǒng)對(duì)返回值中的data對(duì)象進(jìn)行整體加密處理，用appSecret作為密鑰來(lái)解密后使用。A.1.4加密說(shuō)明簽名算法：國(guó)密SM4算法。密鑰：項(xiàng)目的appSecret。簽名方式：整體簽名方式，對(duì)請(qǐng)求的HTTP-BODY進(jìn)行整體簽名。編碼方式：UTF-8。適用服務(wù)類(lèi)型：附錄A中所有的服務(wù)。A.2對(duì)接核驗(yàn)服務(wù)A.2.1簡(jiǎn)要說(shuō)明與水利電子證照系統(tǒng)對(duì)接的系統(tǒng)應(yīng)先通過(guò)電子證照對(duì)接核驗(yàn)服務(wù)，獲取token令牌。A.2.2請(qǐng)求URL/sys/token/signupSL/T816.1-20258A.2.3請(qǐng)求方式POSTcontentType:application/json;charssecA.2.4頭部參數(shù)對(duì)接核驗(yàn)服務(wù)頭部參數(shù)格式見(jiàn)表A.2。表A.2對(duì)接核驗(yàn)服務(wù)頭部參數(shù)格式參數(shù)名類(lèi)型說(shuō)明是否必填appKeystring分配的appKey是A.2.5請(qǐng)求體對(duì)接核驗(yàn)服務(wù)請(qǐng)求體格式見(jiàn)表A.3。表A.3對(duì)接核驗(yàn)服務(wù)請(qǐng)求體格式參數(shù)名類(lèi)型說(shuō)明是否必填appKeystring注冊(cè)時(shí)應(yīng)用的key是appSecretstring密鑰是A.2.6返回值對(duì)接核驗(yàn)服務(wù)返回值格式見(jiàn)表A.4。表A.4對(duì)接核驗(yàn)服務(wù)返回值格式參數(shù)名類(lèi)型說(shuō)明successbool狀態(tài)true或falsedataobject(“token”:“"}msgstring提示信息statusint狀態(tài)碼timestampslong時(shí)間戳A.3新辦服務(wù)A.3.1簡(jiǎn)要說(shuō)明發(fā)證時(shí)調(diào)用此方法。A.3.2請(qǐng)求URL／jsec/interface/v25/newEC僅生成文件（前端UKEY蓋章時(shí)調(diào)用）／jsec/interface/v25/newECSeal生成文件并調(diào)用簽章系統(tǒng)蓋章，未對(duì)接簽章系統(tǒng)應(yīng)先調(diào)用／jsec/interface/v25/newEC否則會(huì)報(bào)錯(cuò)SL/T816.1-20259A.3.3請(qǐng)求方式POSTcontentType:'application/json;charsSset=UTF-A.3.4頭部參數(shù)新辦服務(wù)頭部參數(shù)格式見(jiàn)表A.5。表A.5新辦服務(wù)頭部參數(shù)格式參數(shù)名類(lèi)型說(shuō)明是否必填appTokenstring取登錄服務(wù)返回值是appKeystring系統(tǒng)key是A.3.5請(qǐng)求體新辦服務(wù)請(qǐng)求體格式見(jiàn)表A.6。表A.6新辦服務(wù)請(qǐng)求體格式參數(shù)名類(lèi)型說(shuō)明datajson發(fā)證機(jī)關(guān)代碼、辦理機(jī)關(guān)名稱、辦理機(jī)關(guān)統(tǒng)一社會(huì)信用代碼、代碼類(lèi)別、單位名稱或個(gè)人姓名、住所（住址）注冊(cè)地址、郵編、法定代表人、聯(lián)系人、行業(yè)類(lèi)別代碼、用水管理部門(mén)、取水地址、取水地址行政編碼、取水工程名稱、水源類(lèi)型代碼等A.3.6返回值新辦服務(wù)返回值格式見(jiàn)表A.7。表A.7新辦服務(wù)返回值格式參數(shù)名類(lèi)型說(shuō)明successbool狀態(tài)true或falsedataobject1“file”：“文件名”，”id”：“文件id"，“type”：“文件類(lèi)型”，“fileExt”：“文件擴(kuò)展名”，“certId”：“電子證照唯一標(biāo)識(shí)”，“certNum”：“證照編號(hào)”，＂message”：＂提示信息”，“url”：“參數(shù)申”，＂engCodeInfoList”：[{/／取水工程信息“engld”：“取水工程ID，與提交的ID一致”，“engCode”：“系統(tǒng)生成的取水工程編碼”}]}msgstring提示信息statusint狀態(tài)碼timestampslong時(shí)間截SL/T816.1-202510certId”:"005.2.1115555000001332XW002.11321123002624095J.20210015.100.0”,certId”:"005.2.1115555000001332XW002.11321123002624095J.20210015.100.0”,A.3.7返回示例示例：新辦服務(wù)返回值json文件內(nèi)容。イ"status”:200,"da"file":"1","id”:"a101ff12345640b7ad7f91ba0laaaaaa","type":"1","fileExt":"ofd",、"certNum”:"A110000S2019-0001”,＂message”：“生成ofd文件成功”，"url”:“type=1&.fileExt=pdf&-id=a101ffd5000000b7ad7f91ba01123456”,“engCodelnfoList”:[{“engld”:“abef56175515-47c987faeada5e123456”,“engCode”:“A199900S2021-0001-001”}]},＂msg"：”操作成功”，"success”:true,"timestamps";1566777574102}A.4變更服務(wù)A.4.1簡(jiǎn)要說(shuō)明變更時(shí)調(diào)用此方法。A.4.2請(qǐng)求URL／jsec/interface/v25/changeEC僅生成文件（前端UKEY蓋章）／jsec/interface/v25/changeECSeal生成文件并調(diào)用簽章系統(tǒng)蓋章（未對(duì)接簽章系統(tǒng)調(diào)用此接口會(huì)報(bào)錯(cuò)，可先調(diào)用第一個(gè)接口）A.4.3請(qǐng)求方式POSTcontentType:'application/json;chars=et=UTF-A.4.4頭部參數(shù)變更服務(wù)頭部參數(shù)格式見(jiàn)表A.8。表A.8變更服務(wù)頭部參數(shù)格式參數(shù)名類(lèi)型說(shuō)明是否必填appTokenstring取登錄服務(wù)返回值是appKeystring系統(tǒng)key是SL/T816.1-202511A.4.5請(qǐng)求體變更服務(wù)請(qǐng)求體格式見(jiàn)表A.9。表A.9變更服務(wù)請(qǐng)求體格式參數(shù)名類(lèi)型說(shuō)明datajson原證照編碼、取水權(quán)人名稱、證明材料、發(fā)證機(jī)關(guān)代碼、辦理機(jī)關(guān)名稱、辦理機(jī)關(guān)統(tǒng)一社會(huì)信用代碼、代碼類(lèi)別、單位名稱或個(gè)人姓名、住所（住址）注冊(cè)地址、郵編、法定代表人、聯(lián)系人、行業(yè)類(lèi)別代碼、用水管理部門(mén)、取水地址、取水地址行政編碼、取水工程名稱、水源類(lèi)型代碼等A.4.6返回值變更服務(wù)返回值格式見(jiàn)表A.10。表A.10變更服務(wù)返回值格式參數(shù)名類(lèi)型說(shuō)明successbool狀態(tài)true或falsedataobjectく“file”：“文件名”，“id”：“文件id”，＂type”；“文件類(lèi)型”，＂fileExt”：“文件擴(kuò)展名”，＂certld”：“電子證照唯一標(biāo)識(shí)”.“certNum”：“證照編號(hào)”，＂message”；“提示信息”，“url”：“參數(shù)串”>msgstring提示信息statusint狀態(tài)碼timestampslong時(shí)間戳A.4.7返回示例變更服務(wù)返回示例同新辦服務(wù)返回示例。A.5延續(xù)服務(wù)A.5.1簡(jiǎn)要說(shuō)明延續(xù)時(shí)調(diào)用此方法。A.5.2請(qǐng)求URL／jsec/interface/v25/continueEC僅生成文件（前端UKEY蓋章）／jsec/interface/v25/continueECSeal生成文件并調(diào)用簽章系統(tǒng)蓋章（未對(duì)接簽章系統(tǒng)調(diào)用此接口會(huì)報(bào)錯(cuò)，可先調(diào)用第一個(gè)接口）SL/T816.1-202512A.5.3請(qǐng)求方式POSTcontentType:'application/json;charssecA.5.4頭部參數(shù)延續(xù)服務(wù)頭部參數(shù)格式見(jiàn)表A.11。表A.11延續(xù)服務(wù)頭部參數(shù)格式參數(shù)名類(lèi)型說(shuō)明是否必填appTokenstring取登錄服務(wù)返回值是appKeystring系統(tǒng)key是A.5.5請(qǐng)求體延續(xù)服務(wù)請(qǐng)求體格式見(jiàn)表A.12。表A.12延續(xù)服務(wù)請(qǐng)求體格式參數(shù)名類(lèi)型說(shuō)明datajson原證照編碼、主要生產(chǎn)用水技術(shù)等變化情況、取水源等變化情況、證明文件、發(fā)證機(jī)關(guān)代碼、辦理機(jī)關(guān)名稱、辦理機(jī)關(guān)統(tǒng)一社會(huì)信用代碼、代碼類(lèi)別、單位名稱或個(gè)人姓名、住所（住址）注冊(cè)地址、郵編、法定代表人、聯(lián)系人、行業(yè)類(lèi)別代碼、用水管理部門(mén)、取水地址、取水地址行政編碼、取水工程名稱、水源類(lèi)型代碼等A.5.6返回值延續(xù)服務(wù)返回值格式見(jiàn)表A.13。表A.13延續(xù)服務(wù)返回值格式參數(shù)名類(lèi)型說(shuō)明successbool狀態(tài)true或falsedataobject{“file”：“文件名”，“id”：“文件id”，“type”：“文件類(lèi)型”，“fileExt”：“文件擴(kuò)展名”，＂certId”：“電子證照唯一標(biāo)識(shí)”，＂certNum”：＂證照編號(hào)”，＂message”：“提示信息”，＂url"：“參數(shù)申”msgstring提示信息statusint狀態(tài)碼timestampslong時(shí)間戳SL/T816.1-202513A.5.7返回示例延續(xù)服務(wù)返回示例同新辦服務(wù)返回示例。A.6注銷(xiāo)服務(wù)A.6.1簡(jiǎn)要說(shuō)明需要注銷(xiāo)證照時(shí)調(diào)用此方法。A.6.2請(qǐng)求URL/jsec/interface/v25/rmECA.6.3請(qǐng)求方式POSTcontentType:'application/json;char:A.6.4頭部參數(shù)注銷(xiāo)服務(wù)頭部參數(shù)格式見(jiàn)表A.14。表A.14注銷(xiāo)服務(wù)頭部參數(shù)格式參數(shù)名類(lèi)型說(shuō)明是否必填appTokenstring取登錄服務(wù)返回值是appKeystring系統(tǒng)key是A.6.5請(qǐng)求體注銷(xiāo)服務(wù)請(qǐng)求體格式見(jiàn)表A.15表A.15注銷(xiāo)服務(wù)請(qǐng)求體格式參數(shù)名類(lèi)型說(shuō)明是否必填certNumstring證照編碼是reasonstring注銷(xiāo)原因否A.6.6返回值注銷(xiāo)服務(wù)返回值格式見(jiàn)表A.16。表A.16注銷(xiāo)服務(wù)返回值格式參數(shù)名類(lèi)型說(shuō)明succcssbool狀態(tài)true或falsedataobjectmsgstring提示信息statusint狀態(tài)碼timestampslong時(shí)間戳SL/T816.1-202514A.6.7返回示例示例：注銷(xiāo)服務(wù)返回值json文件內(nèi)容。("status":200,"data":{},＂msg"：“操作成功”，''"timestamps":1566444574102ーA.7下載服務(wù)A.7.1簡(jiǎn)要說(shuō)明新辦、延續(xù)、變更服務(wù)調(diào)用成功后，可調(diào)用下載證照文件方法，下載未蓋章或已蓋章（如果已經(jīng)蓋章成功）的文件。A.7.2請(qǐng)求URL/jsec/interface/v25/getBase64A.7.3請(qǐng)求方式POSTcontentType:'application/json;charset=UTF-A.7.4頭部參數(shù)下載服務(wù)頭部參數(shù)格式見(jiàn)表A.17。表A.17下載服務(wù)頭部參數(shù)格式參數(shù)名類(lèi)型說(shuō)明是否必填appTokenstring取登錄服務(wù)返回值是appKeystring系統(tǒng)key是A.7.5請(qǐng)求參數(shù)下載服務(wù)請(qǐng)求參數(shù)格式見(jiàn)表A.18。表A.18下載服務(wù)請(qǐng)求參數(shù)格式參數(shù)名類(lèi)型說(shuō)明是否必填idstring文件ID，新辦、延續(xù)、變更返回值中的id是A.7.6返回示例示例：下載服務(wù)返回值json文件內(nèi)容。SL/T816.1-202515ー"status":200,"data":fileData:”。0＂msg"：“操作成功”，"Suc"timestamps":1566444574102A.8獲取UKEY簽章頁(yè)面A.8.1簡(jiǎn)要說(shuō)明此服務(wù)供需要前端UKEY蓋章方式調(diào)用（各地方案不同，沒(méi)有對(duì)接簽章無(wú)法調(diào)?。?。A.8.2請(qǐng)求URL/jsec/zj/interface/sealPageA.8.3請(qǐng)求方式GETA.8.4請(qǐng)求參數(shù)請(qǐng)求參數(shù)格式見(jiàn)表A.19。表A.19請(qǐng)求參數(shù)格式參數(shù)名類(lèi)型說(shuō)明是否必填idstring取生成證照服務(wù)返回id值是typestring取生成證照服務(wù)返回type值是appTokenstring取登錄服務(wù)返回值是appKeystring系統(tǒng)key是callBackUrlstring回調(diào)地址，僅限get類(lèi)型的http服務(wù)，簽章上傳成功后會(huì)異步調(diào)用這個(gè)參數(shù)的地址（回調(diào)需要水利部先申請(qǐng)?jiān)L問(wèn)地方服務(wù)器權(quán)限）否A.8.5返回值直接跳轉(zhuǎn)蓋章頁(yè)面。SL/T816.1-202516附錄B（資料性）電子證照特殊說(shuō)明B.1返回狀態(tài)碼表證照系統(tǒng)常見(jiàn)的返回值狀態(tài)碼及含義見(jiàn)表B.1，可結(jié)合狀態(tài)字段判斷請(qǐng)求結(jié)果。表B.1證照系統(tǒng)常見(jiàn)的返回值狀態(tài)碼及含義表狀態(tài)碼狀態(tài)類(lèi)型說(shuō)明200true成功請(qǐng)求成功500false服務(wù)器異常服務(wù)器內(nèi)部錯(cuò)誤50001false業(yè)務(wù)參數(shù)不正確參數(shù)業(yè)務(wù)校驗(yàn)不通過(guò)，詳細(xì)信息查看msg40001false參數(shù)不正確參數(shù)合法性有誤，詳細(xì)信息查看msg20202false缺少必要參數(shù)20201false參數(shù)類(lèi)型不匹配20203false請(qǐng)求路徑不存在請(qǐng)求url錯(cuò)誤20204false服務(wù)器運(yùn)行時(shí)異常20200false未指定的錯(cuò)誤類(lèi)型詳細(xì)信息查看msg100001false業(yè)務(wù)邏輯錯(cuò)誤詳細(xì)信息查看msgB.2問(wèn)題描述系統(tǒng)對(duì)接過(guò)程中常見(jiàn)問(wèn)題見(jiàn)表B.2。表B.2系統(tǒng)對(duì)接過(guò)程中常見(jiàn)問(wèn)題返回消息可能原因此持證人有未到期的證書(shū)此人名下已有有效的證書(shū)用戶沒(méi)有此發(fā)證機(jī)關(guān)權(quán)限發(fā)證機(jī)關(guān)代碼與使用的appkey不對(duì)應(yīng)沒(méi)有找到此發(fā)證機(jī)關(guān)信息此發(fā)證機(jī)關(guān)信息沒(méi)有注冊(cè)或已失效沒(méi)有找到此證照或此證照狀態(tài)不正確沒(méi)有找到原證件數(shù)據(jù)要操作的證照未蓋章或者不存在SL/T816.1-202517附錄C（資料性）簽名算法代碼參考（JAVA）示例：簽名算法JAVA參考代碼。importcn.hutool.crypto.SmUtil;importcn.hutool.crypto.symm