DB34-T 4085-2021 政府網(wǎng)站信息資源庫(kù)數(shù)據(jù)交換規(guī)范-高清現(xiàn)行

ICS35.240.9934CCSL7034安 徽 省 地 方 標(biāo) 準(zhǔn)DB34/T4085—2021政府網(wǎng)站信息資源庫(kù)數(shù)據(jù)交換規(guī)范Dataexchangespecificationsforthegovernmentwebsiteinformationresourcesrepository2021-12-282021-12-282022-01-28安徽省市場(chǎng)監(jiān)督管理局發(fā)布DB34/T4085DB34/T4085—2021前 言GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1起草。請(qǐng)注意本文件的某些內(nèi)容可能涉及專(zhuān)利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識(shí)別專(zhuān)利的責(zé)任。本文件由安徽省人民政府網(wǎng)管理中心提出。本文件由安徽省信息技術(shù)標(biāo)準(zhǔn)化技術(shù)委員會(huì)（AH/TC25）歸口。量和標(biāo)準(zhǔn)化研究院、北京開(kāi)普云信息科技有限公司。凱、季靜、王靜、徐多響。IIDB34/T4085DB34/T4085—2021DB34/T4085DB34/T4085—2021政府網(wǎng)站信息資源庫(kù)數(shù)據(jù)交換規(guī)范范圍要求。等系統(tǒng)的數(shù)據(jù)交換。規(guī)范性引用文件（包括所有的修改單適用于本文件。GB/T21062.3政務(wù)信息資源交換體系第3部分：數(shù)據(jù)接口規(guī)范3術(shù)語(yǔ)和定義下列術(shù)語(yǔ)和定義適用于本文件。GB/T21062.3政務(wù)信息資源交換體系第3部分：數(shù)據(jù)接口規(guī)范3術(shù)語(yǔ)和定義下列術(shù)語(yǔ)和定義適用于本文件。3.1接口使用方userofdataexchangeinterface使用數(shù)據(jù)交換接口的組織。3.2接口提供方supplierofdataexchangeinterfaces提供數(shù)據(jù)交換接口服務(wù)的組織。3.3平臺(tái)運(yùn)營(yíng)方operatorofdataexchangeplatform為數(shù)據(jù)交換平臺(tái)提供技術(shù)服務(wù)支撐的組織。4基本要求包括資源服務(wù)、資源管理、資源同步等接口。GB/T21062.3GB/T7408Http/HttpsXMLSchemaGB/T1527815數(shù)據(jù)交換流程開(kāi)始結(jié)束授權(quán)憑證反饋開(kāi)始結(jié)束授權(quán)憑證反饋申請(qǐng)審核申請(qǐng)?zhí)峤黄脚_(tái)運(yùn)營(yíng)方接口提供方接口使用方驗(yàn)證開(kāi)通授權(quán)功能評(píng)估安全評(píng)估數(shù)據(jù)交換流程6交換接口資源服務(wù)接口資源服務(wù)接口內(nèi)容資源服務(wù)接口包括但不限于以下類(lèi)型。查詢(xún)資源分類(lèi)：通過(guò)接口可查詢(xún)當(dāng)前資源庫(kù)的分類(lèi)設(shè)定情況。分頁(yè)查詢(xún)?cè)獢?shù)據(jù)集：通過(guò)接口可分頁(yè)查詢(xún)當(dāng)前資源庫(kù)的元數(shù)據(jù)集設(shè)定情況。分頁(yè)查詢(xún)?cè)獢?shù)據(jù)：通過(guò)接口可分頁(yè)查詢(xún)當(dāng)前資源庫(kù)的元數(shù)據(jù)設(shè)定情況。IDID分頁(yè)查詢(xún)字典信息：通過(guò)接口可查詢(xún)當(dāng)前資源庫(kù)字典信息設(shè)定情況。獲取資源標(biāo)簽：通過(guò)接口可獲取當(dāng)前資源庫(kù)標(biāo)簽設(shè)定情況。查詢(xún)資源分類(lèi)查詢(xún)資源分類(lèi)接口見(jiàn)表1。2表1查詢(xún)資源分類(lèi)接口請(qǐng)求方式POSTURLhttp(s)://[ip]:[port]/zuul/repo-api/api/res/other/getClassifysById請(qǐng)求參數(shù)參數(shù)名稱(chēng)類(lèi)型是否必須描述appIdappIdString是服務(wù)ID，明文傳輸，如:appId=defaultdataidString是id=“0”，獲取資源全部基礎(chǔ)分類(lèi)；id=“-1”，獲取資源一級(jí)拓展分類(lèi)；id=拓展分類(lèi)ID，獲取下一級(jí)拓展分類(lèi)；成功：{返回?cái)?shù)據(jù)"code":0,格式（id="msg":"操作成功",“0”，獲取"data":{ 略資源全部基},礎(chǔ)分類(lèi)；）}失敗：請(qǐng)參照接口返回錯(cuò)誤狀態(tài)碼表（見(jiàn)附錄A）。成功：{返回?cái)?shù)據(jù)"code":0,格式（id="msg":"操作成功",“-1”，獲取"data":{ 略資源一級(jí)拓},展分類(lèi)；）}失?。赫?qǐng)參照接口返回錯(cuò)誤狀態(tài)碼表（見(jiàn)附錄A）。返回?cái)?shù)據(jù)（id=展分類(lèi)ID取下一級(jí)拓展分類(lèi)；）成功：{"code":0,"msg":"操作成功","data":{ 略},}失?。赫?qǐng)參照接口返回錯(cuò)誤狀態(tài)碼表（見(jiàn)附錄A）。6.1.3分頁(yè)查詢(xún)?cè)獢?shù)據(jù)集6.1.3分頁(yè)查詢(xún)?cè)獢?shù)據(jù)集分頁(yè)查詢(xún)?cè)獢?shù)據(jù)集接口見(jiàn)表2。3表2分頁(yè)查詢(xún)?cè)獢?shù)據(jù)集接口請(qǐng)求方式POSTURLhttp(s)://[ip]:[port]/zuul/repo-api/api/res/other/getAllMetadataList請(qǐng)求參數(shù)參數(shù)名稱(chēng)類(lèi)型是否必須描述appIdappIdString是服務(wù)ID，明文傳輸，如:appId=defaultdatapageIndexString是當(dāng)前頁(yè)pageSizeString是每頁(yè)顯示記錄數(shù)成功：{"code":0,返回?cái)?shù)據(jù)格式"msg":"操作成功"data":{ }}失?。赫?qǐng)參照接口返回錯(cuò)誤狀態(tài)碼表（見(jiàn)附錄A）。分頁(yè)查詢(xún)?cè)獢?shù)據(jù)接口見(jiàn)表3。表3分頁(yè)查詢(xún)?cè)獢?shù)據(jù)接口6.1.5根據(jù)元數(shù)據(jù)集ID獲取所有的元數(shù)據(jù)分頁(yè)查詢(xún)?cè)獢?shù)據(jù)接口見(jiàn)表3。表3分頁(yè)查詢(xún)?cè)獢?shù)據(jù)接口6.1.5根據(jù)元數(shù)據(jù)集ID獲取所有的元數(shù)據(jù)根據(jù)元數(shù)據(jù)集ID獲取所有元數(shù)據(jù)接口見(jiàn)表4。4請(qǐng)求方式POSTURLhttp(s)://[ip]:[port]/zuul/repo-api/api/res/other/getAllMetadatas請(qǐng)求參數(shù)參數(shù)名稱(chēng)類(lèi)型是否必須描述appIdappIdString是服務(wù)ID，明文傳輸，如:appId=defaultdatapageIndexString是當(dāng)前頁(yè)pageSizeString是每頁(yè)顯示記錄數(shù)成功：{"code":0,返回?cái)?shù)據(jù)格式"msg":"操作成功"data":{ 略}}失敗：請(qǐng)參照接口返回錯(cuò)誤狀態(tài)碼表（見(jiàn)附錄A）。表4根據(jù)元數(shù)據(jù)集ID獲取所有元數(shù)據(jù)接口請(qǐng)求方式POSTURLhttp(s)://[ip]:[port]/zuul/repo-api/api/res/other/getMetadatasByDmId請(qǐng)求參數(shù)參數(shù)名稱(chēng)類(lèi)型是否必須描述appIdappIdString是服務(wù)ID，明文傳輸，如:appId=defaultdatadmIdString是元數(shù)據(jù)集ID成功：{"code":0,返回?cái)?shù)據(jù)格式"msg":"操作成功"data":{ }}失?。赫?qǐng)參照接口返回錯(cuò)誤狀態(tài)碼表（見(jiàn)附錄A）。6.1.6分頁(yè)查詢(xún)字典信息表5分頁(yè)查詢(xún)字典信息接口6.1.7獲取資源標(biāo)簽5表5分頁(yè)查詢(xún)字典信息接口6.1.7獲取資源標(biāo)簽5請(qǐng)求方式POSTURLhttp(s)://[ip]:[port]/zuul/repo-api/api/res/other/getDictionaryDataByParentId請(qǐng)求參數(shù)參數(shù)名稱(chēng)類(lèi)型是否必須描述appIdappIdString是服務(wù)ID，明文傳輸，如:appId=defaultdatadicTypeString是字典類(lèi)型:0為查詢(xún)系統(tǒng)字典；1為查詢(xún)用戶(hù)字典；parentIdString否字典父節(jié)點(diǎn)IDdicDataNameString否字典名稱(chēng)（可模糊匹配）pageIndexString是當(dāng)前頁(yè)pageSizeString是每頁(yè)顯示記錄數(shù)成功：{"code":0,"msg":"操作成功",返回?cái)?shù)據(jù)格式"data":{ 略}}失?。赫?qǐng)參照接口返回錯(cuò)誤狀態(tài)碼表（見(jiàn)附錄A）。獲取資源標(biāo)簽接口見(jiàn)表6。表6獲取資源標(biāo)簽接口請(qǐng)求方式POSTURLhttp(s)://[ip]:[port]/zuul/repo-api/api/res/other/selectLabelManagement請(qǐng)求參數(shù)參數(shù)名稱(chēng)類(lèi)型是否必須描述appIdappIdString是服務(wù)ID，明文傳輸，如:appId=defaultdatasearchWordString否名稱(chēng)模糊匹配返回?cái)?shù)據(jù)格式成功：{"code":0,"msg":""data":{略}}失?。赫?qǐng)參照接口返回錯(cuò)誤狀態(tài)碼表（見(jiàn)附錄A）。資源管理接口內(nèi)容資源管理接口包括但不限于以下類(lèi)型。新增資源：通過(guò)接口可在指定資源庫(kù)新增一條信息資源，并設(shè)定其相關(guān)屬性。資源管理接口內(nèi)容資源管理接口包括但不限于以下類(lèi)型。新增資源：通過(guò)接口可在指定資源庫(kù)新增一條信息資源，并設(shè)定其相關(guān)屬性。IDIDIDID上傳文件：通過(guò)接口可上傳本地已有的信息資源。下載文件：通過(guò)接口可下載指定地址的信息資源。新增資源新增資源接口見(jiàn)表7。表7新增資源接口6請(qǐng)求方式POSTURLhttp(s)://[ip]:[port]/zuul/repo-api/api/res/resource/createRes請(qǐng)求參數(shù)參數(shù)名稱(chēng)類(lèi)型是否必須描述appIdappIdString是服務(wù)ID，明文傳輸，如:appId=defaultdatalibFlagString否libFlag=1時(shí)，為原始資源庫(kù)資源libFlag為空或其他時(shí)，為主題庫(kù)資源origLibIdString否當(dāng)libFlag=1時(shí)，origLibId為必填為原始庫(kù)庫(kù)ID請(qǐng)求方式POSTURLhttp(s)://[ip]:[port]/zuul/repo-api/api/res/resource/createRes請(qǐng)求參數(shù)參數(shù)名稱(chēng)類(lèi)型是否必須描述isOrigString是isOrig=0時(shí)，dirId為資源庫(kù)的目錄IDisOrig=1時(shí)，dirId為原始對(duì)象目錄IDdirIdString是origIdString否原始資源IDnameString是名稱(chēng)resClassifyString否擴(kuò)展分類(lèi)IDbasicClassificationString是基礎(chǔ)分類(lèi)IDdomainLabelString否標(biāo)簽IDdeptIdString否部門(mén)ID如果為空獲取當(dāng)前綁定目錄部門(mén)；目錄部門(mén)為空則獲取庫(kù)所屬機(jī)構(gòu)都查詢(xún)不到，則為空sharedStatusString否共享資源標(biāo)識(shí)0:不共享 1:共享statusString否資源狀態(tài):狀態(tài)1:草稿；2:待審核(保留字段)；3:正式；4:已刪除；5:徹底刪除；6:已撤銷(xiāo)；7:已駁回(保留字段)；8:已否決(保留字段)；9:已歸檔(保留字段)默認(rèn)為草稿子表元數(shù)據(jù)1String否Value：場(chǎng)景1、List<Map<String,String>>場(chǎng)景2、字符串UUID，對(duì)應(yīng)子表的一個(gè)List注意：有子表時(shí)，該字段為必傳子表元數(shù)據(jù)2String否Value：場(chǎng)景1、List<Map<String,String>>場(chǎng)景2、字符串UUID，對(duì)應(yīng)子表的一個(gè)List注意：有子表時(shí)，該字段為必傳附件/圖片/音視頻等多種類(lèi)型String否//附件/圖片/視頻/音頻類(lèi)數(shù)組方式url可以傳絕對(duì)路的文件類(lèi)型pic:為定義的元數(shù)據(jù)短名或第三方數(shù)據(jù)轉(zhuǎn)換后的屬性名稱(chēng)，根據(jù)情況填寫(xiě)path：路徑必傳為固定傳參，附件/圖片/視頻/音頻等路徑,相對(duì)路徑/絕對(duì)路徑均可，絕對(duì)路徑接口內(nèi)部下載name：名稱(chēng)必傳，默認(rèn)為資源名稱(chēng)加后綴為固定傳參，附件/圖片/視頻/音頻等自定義名稱(chēng)mimeType：上傳文件類(lèi)型，非必傳，默認(rèn)為接口內(nèi)部自動(dòng)解析的文件類(lèi)型，可參考網(wǎng)址：/commons為固定傳參，附件/圖片/視頻/音頻等文件類(lèi)型標(biāo)注，如jpg類(lèi)型可以定義mimeType為application/x-jpg776.2.3批量刪除資源批量刪除資源接口見(jiàn)表8。6.2.3批量刪除資源批量刪除資源接口見(jiàn)表8。表8批量刪除資源接口8請(qǐng)求方式POSTURLhttp(s)://[ip]:[port]/zuul/repo-api/api/res/resource/createRes請(qǐng)求參數(shù)參數(shù)名稱(chēng)類(lèi)型是否必須描述"pic":[{"path":"group1/M00/0D/49/wKgBxF2AT26AFG7XAABR3qJw6x8118.jpg","name":"圖片名稱(chēng)1.jpg","mimeType":"application/x-jpg"}]屬性1…NString否自定義屬性,按需擴(kuò)展；可傳自定義元數(shù)據(jù)屬性以及第三方需要保存到資源庫(kù)字段例如：已知在資源庫(kù)定義元數(shù)據(jù)短名為title：json.put("tilte","元數(shù)據(jù)短名");第三方所屬字段：json.put("ext_title","第三方自定義數(shù)據(jù)");字典類(lèi)型String否例如：?jiǎn)芜x按鈕/多返回?cái)?shù)據(jù)格式成功：{"code":0,"msg":"操作成功","data":"5bfbab21d2e8822813dd5e79"}失敗：請(qǐng)參照接口返回錯(cuò)誤狀態(tài)碼表（見(jiàn)附錄A）。請(qǐng)求方式POSTURLhttp(s)://[ip]:[port]/zuul/repo-api/api/res/resource/delRes請(qǐng)求參數(shù)參數(shù)名稱(chēng)類(lèi)型是否必須描述appIdappIdString是服務(wù)ID，明文傳輸，如:appId=defaultdataisOrigString是isOrig=0時(shí)，resIds為資源庫(kù)的資源IDisOrig=1時(shí)，resIds為原始對(duì)象IDresIdsString是libFlagString否libFlag=1時(shí)，為原始資源庫(kù)資源libFlag為空或其他時(shí)，為主題庫(kù)資源6.2.5根據(jù)資源id查詢(xún)6.2.5根據(jù)資源id查詢(xún)根據(jù)資源id查詢(xún)接口見(jiàn)表10。10根據(jù)資源id9libIdString是庫(kù)ID成功：{返回?cái)?shù)據(jù)格式"code":0,"msg":"操作成功"}失?。赫?qǐng)參照接口返回錯(cuò)誤狀態(tài)碼表（見(jiàn)附錄A）。6.2.4批量移動(dòng)資源批量移動(dòng)資源接口見(jiàn)表9。表9批量移動(dòng)資源接口請(qǐng)求方式POSTURLhttp(s)://[ip]:[port]/zuul/repo-api/api/res/resource/moveRes請(qǐng)求參數(shù)參數(shù)名稱(chēng)類(lèi)型是否必須描述appIdappIdString是服務(wù)ID，明文傳輸，如:appId=defaultdataisOrigString是isOrig=0時(shí)，toDirId為目錄ID，resIds為資源IDisOrig=1時(shí)，toDirId和resIds必須全部為原始對(duì)象IDtoDirIdString是resIdsString是libIdString否庫(kù)ID返回?cái)?shù)據(jù)格式成功：{"code":0,"msg":"操作成功"}失?。赫?qǐng)參照接口返回錯(cuò)誤狀態(tài)碼表（見(jiàn)附錄A）。請(qǐng)求方式POSTURLhttp(s)://[ip]:[port]/zuul/repo-api/api/res/resource/getResById請(qǐng)求參數(shù)參數(shù)名稱(chēng)類(lèi)型是否必須描述appIdappIdString是服務(wù)ID，明文傳輸，如:appId=defaultdataisOrigString是isOrig=0時(shí)，resId為資源庫(kù)的資源IDisOrig=1時(shí)，resId為原始對(duì)象IDresIdString是libFlagString否libFlag=1時(shí)，為原始資源庫(kù)資源libFlag為空或其他時(shí)，為主題庫(kù)資源6.2.7下載文件6.2.7下載文件下載文件接口見(jiàn)表12。表12下載文件接口10libIdString否庫(kù)ID返回?cái)?shù)據(jù)格式成功：{"code":0,"msg":""data":{"isConvert":true}失敗：請(qǐng)參照接口返回錯(cuò)誤狀態(tài)碼表（見(jiàn)附錄A）。6.2.6上傳文件上傳文件接口見(jiàn)表11。表11上傳文件接口請(qǐng)求方式POSTURLhttp(s)://[ip]:[port]/zuul/repo-api/api/res/resource/uploadFile請(qǐng)求參數(shù)參數(shù)名稱(chēng)類(lèi)型是否必須描述appIdappIdString是服務(wù)ID，明文傳輸，如:appId=defaultdatafileInputStreamFileInputStream是文件流成功：{"code":0,"msg":"上傳文件成功",返回?cái)?shù)據(jù)"data":{格式"fileURL":"略",}}失?。赫?qǐng)參照接口返回錯(cuò)誤狀態(tài)碼表（見(jiàn)附錄A）。請(qǐng)求方式POSTURLhttp(s)://[ip]:[port]/zuul/repo-api/api/res/resource/downloadFile請(qǐng)求參數(shù)參數(shù)名稱(chēng)類(lèi)型是否必須描述appIdappIdString是服務(wù)ID，明文傳輸，如:appId=defaultdatafileURLString是文件地址返回?cái)?shù)據(jù)格式成功：文件流失?。何募魇。赫?qǐng)參照接口返回錯(cuò)誤狀態(tài)碼表（見(jiàn)附錄A）。資源同步接口資源同步接口內(nèi)容資源同步接口包括但不限于以下類(lèi)型。創(chuàng)建資源同步策略：通過(guò)接口可創(chuàng)建一條用于不同資源庫(kù)間進(jìn)行資源同步的同步策略，可對(duì)同步時(shí)間、頻次、對(duì)應(yīng)站點(diǎn)/欄目等參數(shù)進(jìn)行設(shè)定。修改資源同步策略：通過(guò)接口可修改已創(chuàng)建的資源同步策略。啟動(dòng)/停止資源同步策略：通過(guò)接口可啟動(dòng)/IDID創(chuàng)建資源同步策略創(chuàng)建資源同步策略接口見(jiàn)表13。表13創(chuàng)建資源同步策略接口請(qǐng)求方式POSTURLhttp(s)://[ip]:[port]/zuul/repo-api/api/res/pushConfig/createPushStrategy驗(yàn)證級(jí)別user請(qǐng)求參數(shù)參數(shù)名稱(chēng)類(lèi)型是否必須描述appIdappIdString是服務(wù)ID，明文傳輸，如:appId=defaultdatastrategyNameString是策略名稱(chēng)syncStartTimeString是格式（HH:mm:ss）同步開(kāi)始時(shí)間pushToChannelsString是需要同步到的欄目信息集合參數(shù)名類(lèi)型是否必須描述applyCodeString是適配器編碼websiteIdString是應(yīng)用站點(diǎn)idchannelIdString是欄目idchannelPathIdsString是欄目全路徑idchannelPathStrString是欄目全路徑字符串isOpenSynchroString是是否開(kāi)啟同步0:否1:是；默認(rèn)1synStatusString是1按天按小時(shí)按分鐘synDateString是具體時(shí)間(具體數(shù)字，比如：synStatus選擇天，取值范圍1-31synStatus選擇小時(shí)，取值范圍0-24synStatus選擇分，取值范圍0-5911116.3.3修改資源同步策略修改資源同步策略接口見(jiàn)表14。6.3.3修改資源同步策略修改資源同步策略接口見(jiàn)表14。表14修改資源同步策略接口12請(qǐng)求方式POSTURLhttp(s)://[ip]:[port]/zuul/repo-api/api/res/pushConfig/createPushStrategy驗(yàn)證級(jí)別user請(qǐng)求參數(shù)參數(shù)名稱(chēng)類(lèi)型是否必須描述)libIdString是（兩個(gè)參數(shù)必須有一個(gè)必填）庫(kù)ID，多個(gè)英文逗號(hào)分割dirId目錄ID，多個(gè)英文逗號(hào)分割searchModelJSONObject否精確查詢(xún)：accurate模糊查詢(xún)：like返回?cái)?shù)據(jù)格式成功：{"code":0,"data":"12dfe7bbf64b4829b9f1f2a6497ad8c0",//返回保存成功后的策略"msg":"操作成功"}失?。赫?qǐng)參照接口返回錯(cuò)誤狀態(tài)碼表（見(jiàn)附錄A）。請(qǐng)求方式POSTURLhttp(s)://[ip]:[port]/zuul/repo-api/api/res/pushConfig/updatePushStrategy驗(yàn)證級(jí)別user請(qǐng)求參數(shù)參數(shù)名稱(chēng)類(lèi)型是否必須描述appIdappIdString是服務(wù)ID，明文傳輸，如:appId=defaultstrategyIdString是策略ID（新增策略時(shí)返回的ID）datastrategyNameString是策略名稱(chēng)syncStartTimeString是格式（HH:mm:ss）同步開(kāi)始時(shí)間pushToChannelsString是需要同步到的欄目信息集合參數(shù)名類(lèi)型是否必須描述applyCodeString是適配器編碼websiteIdString是應(yīng)用站點(diǎn)idchannelIdString是欄目idchannelPathIdsString是欄目全路徑idchannelPathStrString是欄目全路徑字符串isOpenSynchroString是是否開(kāi)啟同步0:否1:是；默認(rèn)16.3.4啟動(dòng)/停止資源同步策略啟動(dòng)/停止資源同步策略接口見(jiàn)表15。6.3.4啟動(dòng)/停止資源同步策略啟動(dòng)/停止資源同步策略接口見(jiàn)表15。表15啟動(dòng)/停止資源同步策略接口6.3.5刪除資源同步策略13synStatusString是按天按小時(shí)按分鐘synDateString是具體時(shí)間(具體數(shù)字，比如：synStatus選擇天，取值范圍1-31synStatus選擇小時(shí)，取值范圍synStatus選擇分鐘，取值范圍0-59libIdString是（兩個(gè)參數(shù)必須有一個(gè)必填）庫(kù)ID，多個(gè)英文逗號(hào)分割dirId/r