ICS35.240.01

CCSL70

團體標準

T/CESAXXX.4—202X

基于區(qū)塊鏈的生態(tài)環(huán)境數(shù)據(jù)共享交換

第4部分：接口要求

Blockchain-basedecologicalenvironmentdatasharingandexchange-

Part4：Interfacerequirements

征求意見稿

在提交反饋意見時，請將您知道的相關專利連同支持性文件一并附上。

已授權的專利證明材料為專利證書復印件或扉頁，已公開但尚未授權的專利申請

證明材料為專利公開通知書復印件或扉頁，未公開的專利申請的證明材料為專利申請

號和申請日期。

202X-XX-XX發(fā)布202X-XX-XX實施

中國電子工業(yè)標準化技術協(xié)會發(fā)布

T/CESAXXX.4—202X

目次

前言3

引言4

1范圍5

2規(guī)范性引用文件5

3術語和定義5

4縮略語6

5接口規(guī)則6

5.1身份認證6

5.2API接口6

6接口描述7

6.1生態(tài)環(huán)境數(shù)據(jù)目錄7

6.2內(nèi)部管理7

6.3數(shù)據(jù)共享13

附錄A（規(guī)范性）對象描述16

附錄B（規(guī)范性）返回狀態(tài)碼21

20

T/CESAXXX.4—202X

基于區(qū)塊鏈的生態(tài)環(huán)境數(shù)據(jù)共享交換第4部分：接口要求

1范圍

本文件規(guī)定了用于區(qū)塊鏈的多源生態(tài)環(huán)境數(shù)據(jù)共享交換的數(shù)據(jù)存儲，數(shù)據(jù)目錄上鏈，前置機部署成

為節(jié)點后數(shù)據(jù)庫與節(jié)點的通信形式，節(jié)點間的數(shù)據(jù)通信，數(shù)據(jù)目錄查詢，數(shù)據(jù)申請等智能合約運行的通

信，數(shù)據(jù)審批的流轉，數(shù)據(jù)傳輸，數(shù)據(jù)共享記錄的存證等過程中的數(shù)據(jù)通信接口的功能實現(xiàn)和使用方法，

對各類數(shù)據(jù)和操作情況的處理方式等內(nèi)容。

本文件適用于設計、研發(fā)、實施、應用、評估生態(tài)環(huán)境數(shù)據(jù)共享交換的機構的環(huán)境信息數(shù)據(jù)共享交

換活動。

2規(guī)范性引用文件

下列文件中的內(nèi)容通過文中的規(guī)范性引用而構成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對應的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

文件。

GB/T18391.3—2009信息技術元數(shù)據(jù)注冊系統(tǒng)(MDR)第3部分：注冊系統(tǒng)公共設施元模型

GB/T42752-2023區(qū)塊鏈和分布式記賬技術參考架構

3術語和定義

GB/T18391.3—2009、GB/T42752-2023界定的以及下列術語和定義適用于本文件。

3.1

數(shù)據(jù)共享交換datasharingexchange

公共建立數(shù)據(jù)匯集的通道使不同地方使用不同計算機、不同軟件的用戶能夠讀取他人數(shù)據(jù)并進行各

種操作運算和分析。實現(xiàn)數(shù)據(jù)從一個系統(tǒng)跨授權邊界訪問或傳遞到另一個系統(tǒng)時所需要的協(xié)議平臺，為

訪問或交換數(shù)據(jù)進行許可授權、形式轉換、數(shù)據(jù)傳輸、使用記錄和保證數(shù)據(jù)安全進行系統(tǒng)性設計。

3.2

數(shù)據(jù)接口datainterface

進行數(shù)據(jù)傳輸時向數(shù)據(jù)連接線輸出數(shù)據(jù)的通道。由兩個功能單元的功能特性、物理互聯(lián)特性、信號

交換特性及其它特性定義。

3.3

數(shù)據(jù)目錄datacatalog

以核心元數(shù)據(jù)為主要描述方式，按照資源分類體系對公共數(shù)據(jù)進行有序排列的一組信息，用以描述

公共數(shù)據(jù)的特征,以便對公共數(shù)據(jù)進行檢索、定位與獲取。

[來源：GB／T18391.3—2009,定義3.2.18]

3.4

5

T/CESAXXX.4—202X

前置機front-endprocessor

一種位于數(shù)據(jù)處理鏈路前端的數(shù)據(jù)處理設備，在機構后臺核心處理系統(tǒng)和外部數(shù)據(jù)業(yè)務之間提供各

種接口服務，通過專線或硬件隔離技術將運行這個軟件的計算機連接到外部企業(yè)的外網(wǎng)系統(tǒng)上，用于對

數(shù)據(jù)進行加工、轉換、清洗、聚合等操作，以便于后續(xù)的數(shù)據(jù)處理和分析，運行這個軟件的計算機，從

功能上稱呼為前置機。

3.5

智能合約Smartcontracts

一種基于區(qū)塊鏈技術的自動化合約，可以在不需要第三方干預的情況下自動執(zhí)行合同條款。智能合

約通常使用編程語言編寫，存儲在分布式賬本中并通過區(qū)塊鏈網(wǎng)絡進行驗證和執(zhí)行。

[來源：GB/T42752—2023，3.13，有修改]

4縮略語

下列縮略語適用于本文件

ETL：提取，轉換和加載（Extract,Transform,andLoad）

FTP：文件傳輸協(xié)議（FileTransferProtocol）

HTTP：超文本傳輸協(xié)議（HyperTextTransferProtocol）

HTTPS：超文本傳輸協(xié)議安全版（HyperTransferProtocoloverSecureSocketLayer）

PKI：公鑰基礎設施（publickeyinfrastructure）

SFTP：完全文件傳送協(xié)議（SecretFileTransferProtocol）

SMTP：簡單郵件傳輸協(xié)議（SimpleMailTransferProtocol）

XML：可擴展標記語言（ExtensibleMarkupLanguage）

5接口規(guī)則

5.1身份認證

數(shù)據(jù)需求方應通過身份認證申請后，按照數(shù)據(jù)共享平臺或數(shù)據(jù)提供方定義的數(shù)據(jù)接口獲取數(shù)據(jù)。相

關要求應包括但不限于：

a)數(shù)據(jù)需求方通過用戶名/密碼向數(shù)據(jù)共享平臺請求身份認證；

b)通過認證后，數(shù)據(jù)需求方按照數(shù)據(jù)共享平臺或數(shù)據(jù)提供方提供的接口方式、接口說明等要求來

獲取數(shù)據(jù)，具體接口要求見5.2。

5.2API接口

API接口是數(shù)據(jù)提供方通過數(shù)據(jù)共享平臺提供的數(shù)據(jù)獲取方式，數(shù)據(jù)需求方通過調(diào)用數(shù)據(jù)提供方定

義的API接口獲取數(shù)據(jù)。

API接口說明應包括但不限于：

a)接口名稱：名稱突出數(shù)據(jù)內(nèi)容指向的對象以及對象具有的顯著特征；

b)接口描述：接口給功能性描述；

c)接口地址：接口的調(diào)用地址；

d)請求方式：對數(shù)據(jù)進行操作采用的類型，可采用GET或POST等方式；

e)請求參數(shù)：訪問接口時必要的或可選的參數(shù)，說明參數(shù)名稱、類型、是否必填和描述等；

60

T/CESAXXX.4—202X

f)返回結果：請求數(shù)據(jù)后，系統(tǒng)返回的請求結果。包括但不限于返回狀態(tài)碼、返回消息說明和數(shù)

據(jù)信息等內(nèi)容；

g)返回字段說明：返回結果中數(shù)據(jù)信息的字段說明，包括但不限于字段的名稱、類型和描述等信

息；

h)返回狀態(tài)碼：請求數(shù)據(jù)后，系統(tǒng)返回的狀態(tài)碼及其說明。

6接口描述

6.1生態(tài)環(huán)境數(shù)據(jù)目錄

6.1.1生態(tài)環(huán)境數(shù)據(jù)接口

數(shù)據(jù)類型定義

1）數(shù)據(jù)類型DataCatalogVO為復合類型，描述一條生態(tài)環(huán)境數(shù)據(jù)信息，見表1.

表1

名稱類型是否必填描述

NameString是數(shù)據(jù)目錄名稱

dataItemString是數(shù)據(jù)項

dataAbstractString是數(shù)據(jù)更新周期

CodeString是數(shù)據(jù)目錄編碼

shareTypeString是共享類型

生態(tài)環(huán)境數(shù)據(jù)接口

接口名稱：ResponseData<Page<DataCatalogVO>>getList(pageNo,pageSize)

接口地址：43:10353/server/datacatalog/list

接口描述：分頁獲取所有生態(tài)環(huán)境數(shù)據(jù)

請求方式：GET

請求參數(shù)：分頁參數(shù)

返回結果：生態(tài)環(huán)境分頁數(shù)據(jù)

6.2內(nèi)部管理

6.2.1內(nèi)設機構

數(shù)據(jù)類型定義

1)數(shù)據(jù)類型SysOrgVO為復合類型，描述一條內(nèi)設機構，見表2.

表2

名稱類型是否必填描述

orgTypeInteger是機構類型

nameString是數(shù)據(jù)目錄名稱

codeString是機構編碼

statusInteger是狀態(tài)

7

T/CESAXXX.4—202X

seqInteger是排序

2)數(shù)據(jù)類型SysOrgTreeVO為復合類型，描述一條內(nèi)設機構的樹結構，見表3.

表3

名稱類型是否必填描述

orgLevelInteger是機構所屬級別

nameString是數(shù)據(jù)目錄名稱

codeString是機構編碼

lookupPathString是路徑

nodeLevelInteger是節(jié)點級別

subOrgCountsInteger是是否是葉子節(jié)點

內(nèi)設機構接口

方法1：

接口名稱：ResponseData<SysOrgVO>save(SysOrgVOsysOrgVo)

接口描述：保存一條內(nèi)設機構。

接口地址：43:10353/server/org/save

請求方式：POST

請求參數(shù)：sysOrgVo為內(nèi)設機構信息。

返回參數(shù)：內(nèi)設機構信息

方法2：

接口名稱：ResponseData<SysOrgVO>submitExamine(SysOrgVOsysOrgVo)

接口描述：提交一條內(nèi)設機構

接口地址：43:10353/server/org/submitExamine

請求方式：POST

請求參數(shù)：sysOrgVo為內(nèi)設機構信息。

返回參數(shù)：內(nèi)設機構信息

方法3：

接口名稱：ResponseData<Boolean>delOrg(DelRequestBodyVOdelRequestBodyVO)

接口描述：刪除一條內(nèi)設機構

接口地址：43:10353/server/org/del/one

請求方式：POST

請求參數(shù)：刪除參數(shù)

返回參數(shù)：是否成功的布爾值

方法4：

接口名稱：ResponseData<Page<SysOrgVO>>getAllList(pageNo,pageSize)

接口描述：分頁查詢內(nèi)設機構列表

接口地址：43:10353/server/org/get/pageList

請求方式：GET

請求參數(shù)：分頁參數(shù)

80

T/CESAXXX.4—202X

返回參數(shù)：內(nèi)設機構分頁列表

方法5：

接口名稱：ResponseData<List<SysOrgTreeVO>>getUserTree()

接口描述：查詢機構屬性列表

接口地址：43:10353/server/org/get/userTree

請求方式：GET

請求參數(shù)：無

返回參數(shù)：機構樹形結構

6.2.2業(yè)務目錄

數(shù)據(jù)類型定義

1)數(shù)據(jù)類型DutyCatalogVO為復合類型，描述一條業(yè)務目錄數(shù)據(jù)結構，見表4.

表4

名稱類型是否必填描述

orgIdString是機構id

orgCodeString是機構編碼

orgNameString是機構名稱

resourceNameString是數(shù)據(jù)源名稱

codeColumnString是核心數(shù)據(jù)項

statusInteger是狀態(tài)

2)數(shù)據(jù)類型DutyCatalogUpdateVO為符合類型，描述一條提交或更新的業(yè)務目錄數(shù)據(jù)結構，見表

5.

表5

名稱類型是否必填描述

orgIdString是機構id

codeString是業(yè)務目錄編碼

deptNameString是機構名稱

resourceNameString是數(shù)據(jù)源名稱

codeColumnString是核心數(shù)據(jù)項

statusInteger是狀態(tài)

dutyTypeString是業(yè)務類型

業(yè)務目錄接口

方法1：

接口名稱：ResponseData<DutyCatalogVO>save(DutyCatalogVOdutyCatalogVO)

接口描述：保存一條業(yè)務目錄

接口地址：43:10353/server/dutycatalog/save

請求方式：GET

請求參數(shù)：業(yè)務目錄屬性

9

T/CESAXXX.4—202X

返回參數(shù)：業(yè)務目錄

方法2：

接口名稱：ResponseData<DutyCatalogUpdateVO>submitAudit(DutyCatalogUpdateVO

dutyCatalogUpdateVO)

接口描述：提交或更新一條業(yè)務目錄

接口地址：43:10353/server/dutycatalog/commit

請求方式：POST

請求參數(shù)：業(yè)務目錄更新屬性

返回參數(shù)：業(yè)務目錄

方法3：

接口名稱：ResponseData<Boolean>delete(DelRequestBodyVOdelRequestBodyVO)

接口描述：刪除一條業(yè)務目錄

接口地址：43:10353/server/dutycatalog/del/one

請求方式：POST

請求參數(shù)：刪除參數(shù)

返回參數(shù)：刪除成功的布爾值

方法4：

接口名稱：ResponseData<Page<DutyCatalogVO>>getAllList(pageNo,pageSize)

接口描述：分頁獲取業(yè)務目錄列表

接口地址：43:10353/server/dutycatalog/get/list

請求方式：GET

請求參數(shù)：分頁參數(shù)

返回參數(shù)：業(yè)務目錄的分頁數(shù)據(jù)

方法5：

接口名稱：ResponseData<Map<String,Object>>importData(MultipartFilefile,

HttpServletResponseresponse,LongorgId)

接口描述：業(yè)務目錄數(shù)據(jù)導入

接口地址：43:10353/server/dutycatalog/importData

請求方式：POST

請求參數(shù)：導入文件

返回參數(shù)：導入結果

6.2.3數(shù)據(jù)目錄

數(shù)據(jù)類型定義

1)數(shù)據(jù)類型DataCatalogVO是符合類型，描述一條數(shù)據(jù)目錄的結構，見表6。

表6

名稱類型是否必填描述

dutyIdString是業(yè)務目錄ID

codeString是數(shù)據(jù)目錄編碼

deptIdString是所屬機構ID

deptCodeString是機構code

100

T/CESAXXX.4—202X

orgIdString是所屬內(nèi)設機構ID

itemVOListString是數(shù)據(jù)項列表

NameString是數(shù)據(jù)目錄名稱

timeUnitString是數(shù)據(jù)更新周期

dataVersionString是數(shù)據(jù)版本號

sysNameString是信息系統(tǒng)ID

2)數(shù)據(jù)類型DataCatalogDelVO是復合類型，描述刪除數(shù)據(jù)目錄的參數(shù)結構，見表7。

表7

名稱類型是否必填描述

idString是數(shù)據(jù)目錄ID

versionString是版本號

deleteReasonString是刪除原因

數(shù)據(jù)目錄接口

方法1：

接口名稱：ResponseData<Boolean>save(DataCatalogVOvo)

接口描述：保存一條數(shù)據(jù)目錄

接口地址：43:10353/server/datacatalog/save

請求方式：POST

請求參數(shù)：數(shù)據(jù)目錄屬性

返回參數(shù)：是否保存成功

方法2：

接口名稱：ResponseData<Boolean>submit(DataCatalogVOvo)

接口描述：提交一條數(shù)據(jù)目錄

接口地址：43:10353/server/datacatalog/submit

請求方式：POST

請求參數(shù)：數(shù)據(jù)目錄屬性

返回參數(shù)：是否提交成功

方法3：

接口名稱：ResponseData<Page<DataCatalogVO>>getAllList(pageNo,pageSize)

接口描述：分頁獲取數(shù)據(jù)目錄列表

接口地址：43:10353/server/datacatalog/list

請求方式：GET

請求參數(shù)：分頁參數(shù)

返回參數(shù)：數(shù)據(jù)目錄分頁列表

方法4：

接口名稱：ResponseData<DataCatalogVO>details(Longid)

接口描述：獲取數(shù)據(jù)目錄詳情

接口地址：43:10353/server/datacatalog/details

請求方式：GET

11

T/CESAXXX.4—202X

請求參數(shù)：數(shù)據(jù)目錄ID

返回參數(shù)：數(shù)據(jù)目錄詳情

方法5：

接口名稱：ResponseData<Boolean>delete(DataCatalogDelVOdelVO)

接口描述：刪除數(shù)據(jù)目錄

接口地址：43:10353/server/datacatalog/del/one

請求方式：POST

請求參數(shù)：刪除屬性

返回參數(shù)：是否刪除成功

6.2.4信息系統(tǒng)

數(shù)據(jù)類型定義

1)數(shù)據(jù)類型InfoSysVO是復合類型，描述一條信息系統(tǒng)的結構，見表8。

表8

名稱類型是否必填描述

netenvString是網(wǎng)絡環(huán)境

ContactsString是聯(lián)系人

contactTypeString是聯(lián)系方式

dutyCatalogStrListString是對應的業(yè)務目錄

nameString是信息系統(tǒng)名稱

2)數(shù)據(jù)類型InfoSysDelVO是復合類型，描述刪除參數(shù)的結構，見表9。

表9

名稱類型是否必填描述

idString是信息系統(tǒng)ID

versionString是版本號

reasonString是刪除理由

信息系統(tǒng)接口

方法1：

接口名稱：ResponseData<InfoSysVO>save(InfoSysVOvo)

接口描述：保存信息系統(tǒng)

接口地址：43:10353/server/sys/save

請求方式：POST

請求參數(shù)：信息系統(tǒng)屬性

返回參數(shù)：信息系統(tǒng)

方法2：

接口名稱：ResponseData<InfoSysVO>commit(InfoSysVOvo)

接口描述：提交信息系統(tǒng)

接口地址：43:10353/server/sys/commit

120

T/CESAXXX.4—202X

請求方式：POST

請求參數(shù)：信息系統(tǒng)屬性

返回參數(shù)：信息系統(tǒng)

方法3：

接口名稱：ResponseData<Boolean>delete(InfoSysDelVOdelVO)

接口描述：刪除信息系統(tǒng)

接口地址：43:10353/server/sys/del/one

請求方式：POST

請求參數(shù)：刪除信息系統(tǒng)參數(shù)

返回參數(shù)：刪除是否成功的布爾值

方法4：

接口名稱：ResponseData<InfoSysVO>details(Longid)

接口描述：獲取信息系統(tǒng)詳情

接口地址：43:10353/server/sys/details

請求方式：GET

請求參數(shù)：信息系統(tǒng)ID

返回參數(shù)：信息系統(tǒng)詳情

方法5：

接口名稱：ResponseData<Page<InfoSysVO>>getAllList(pageNo,pageSize)

接口描述：分頁獲取信息系統(tǒng)列表

接口地址：43:10353/server/sys/get/list

請求方式：GET

請求參數(shù)：分頁參數(shù)

返回參數(shù)：分頁信息系統(tǒng)列表

6.3數(shù)據(jù)共享

6.3.1數(shù)據(jù)共享申請

數(shù)據(jù)類型定義

1)數(shù)據(jù)類型ShareApplyConfirmPageVO是復合類型，標識一條已申請的數(shù)據(jù)信息，見表10。

表10

名稱類型是否必填描述

rIdString是數(shù)據(jù)資源ID

orgIdString是提供機構ID

orgNameString是提供機構名稱

applyOrgIdString是申請機構ID

applyOrgNameString是申請機構名稱

resourceNameString是數(shù)據(jù)資源名稱

dataItemString是數(shù)據(jù)項

modeString是交換方式

13

T/CESAXXX.4—202X

2)數(shù)據(jù)類型ShareApplyPageVO是復合類型，標識一條申請的數(shù)據(jù)信息，見表11。

表11

名稱類型是否必填描述

orgIdString是機構ID

orgNameString是機構名稱

resourceNameString是數(shù)據(jù)資源名稱

dataItemString是數(shù)據(jù)項

modeString是交換方式

sysIdString是信息系統(tǒng)ID

resourceTypeInteger是資源類型

codeString是編碼

數(shù)據(jù)共享申請接口

方法1：

接口名稱：ResponseData<Page<ShareApplyConfirmPageVO>>

findAlreadyShareApplyPage(pageNo,pageSize)

接口描述：分頁獲取數(shù)據(jù)共享申請-已申請列表

接口地址：43:10353/server/shareApply/get/page

請求方式：GET

請求參數(shù)：分頁信息

返回參數(shù)：已申請的數(shù)據(jù)分頁列表

方法2：

接口名稱：ResponseData<Page<ShareApplyPageVO>>findShareApplyPage(pageNo,pageSize)

接口描述：分頁獲取數(shù)據(jù)共享申請列表

接口地址：43:10353/server/shareApply/get/alreadyPage

請求方式：GET

請求參數(shù)：分頁信息

返回參數(shù)：申請數(shù)據(jù)分頁列表

6.3.2數(shù)據(jù)共享審批

數(shù)據(jù)類型定義

1)數(shù)據(jù)類型ShareApplyPageVO是復合類型，描述了一條數(shù)據(jù)共享審批的信息結構，見表12。

表12

名稱類型是否必填描述

orgIdString是機構ID

orgNameString是機構名稱

resourceNameString是數(shù)據(jù)資源名稱

dataItemString是數(shù)據(jù)項

modeString是交換方式

140

T/CESAXXX.4—202X

sysIdString是信息系統(tǒng)ID

resourceTypeInteger是資源類型

codeString是編碼

statusString是申請狀態(tài)

數(shù)據(jù)共享審批接口

方法1：

接口名稱：ResponseData<Page<ShareApplyPageVO>>findShareApplyPageByApproval(pageNo,

pageSize)

接口描述：分頁獲取數(shù)據(jù)共享審批列表

接口地址：43:10353/server/shareApply/findShareApplyPageByApproval

請求方式：GET

請求參數(shù)：分頁信息

返回參數(shù)：數(shù)據(jù)共享審批列表

6.3.3共享情況

數(shù)據(jù)類型定義

1)數(shù)據(jù)類型ShareApplyPageVO是復合類型，描述一條共享情況的數(shù)據(jù)結構，見表13。

表13

名稱類型是否必填描述

orgNameString是機構名稱

resourceNameString是數(shù)據(jù)資源名稱

dataItemString是數(shù)據(jù)項

resourceTypeDescString是資源類型

codeString是編碼

共享情況接口

方法1：

接口名稱：ResponseData<Page<ShareApplyPageVO>>findShareApplyCitySharePage(pageNo,

pageSize)

接口描述：分頁獲取共享情況列表

接口地址：43:10353/server/shareApply/get/cityShare

請求方式：GET

請求參數(shù)：分頁信息

返回參數(shù)：共享情況列表

15

T/CESAXXX.4—202X

附錄A

（規(guī)范性）

對象描述

A.1機構名稱對象描述

{

"custom":{

"officename":["

機構名稱1",

"機構名稱2",

"機構名稱3"

]

},

"start":{

"code":1,

"text":"查詢成功"

}

}

機構名稱對象參數(shù)說明見表A.1：

表A.1機構名稱對象參數(shù)說明

序號名稱字段名備注

1返回的結果集custom

2機構名稱officename

3狀態(tài)start

4成功1；失敗0code

5接口調(diào)用說明text

A.2職責目錄對象描述

{

"custom":{

"dutylist":[

{

"officeduty":"業(yè)務機構職責",

"officename":"業(yè)務機構名稱",

"corecolumn":"核心數(shù)據(jù)項名稱",

"dutycode":"職責目錄編碼",

"resourcename":"數(shù)據(jù)資源名"

}

]

160

T/CESAXXX.4—202X

},

"start":{

"code":1,

"text":"查詢成功"

}

}

職責目錄對象參數(shù)說明見表A.2：

表A.2職責目錄對象參數(shù)說明

序號名稱字段名備注

1返回的結果集custom

2結果list集合dutylist

3業(yè)務機構職責officeduty

4業(yè)務機構名稱officename

5核心數(shù)據(jù)項名稱corecolumn

6職責目錄編碼dutycode

7數(shù)據(jù)資源名稱resourcename

A.3數(shù)據(jù)目錄對象描述

{

"custom":{

"orgcatalog":[

{"summary":"數(shù)據(jù)資源摘要","updatecycle":"更新周期","systemguid":"是否源自新

建信息系統(tǒng)","total":"數(shù)據(jù)量",

"format":"數(shù)據(jù)格式（數(shù)據(jù)項，見Format說明）","resourcename":"

數(shù)據(jù)資源名稱",

"dutyname":"所屬職責目錄",

"startdate":"數(shù)據(jù)起始時間","fieldlist":

[

{"fieldname":"字段名稱","valuerange":"取值范圍","isnull":"是否為空",

"iskey":"是否主鍵",

"description":"字段描述",

"fieldlength":"字段長度",

"sharetype":"共享類型",

"fieldtype":"字段類型",

"structguid":"對應字段",

"opentype":"開放屬性",

"example":"數(shù)據(jù)樣例"

}

17

T/CESAXXX.4—202X

],

"version":"版本"8

}

]

},

"start":{

"code":1,

"text":"查詢成功"

}

}

數(shù)據(jù)目錄對象參數(shù)說明見表A.3：

表A.3數(shù)據(jù)目錄對象參數(shù)說明

序號名稱字段名備注

1返回的結果集custom

2數(shù)據(jù)目錄集合orgacatalog

3數(shù)據(jù)資源摘要summary

4更新周期updatecycle

5是否源自新建信息系統(tǒng)systemguid

6數(shù)據(jù)量total

7數(shù)據(jù)格式format

8數(shù)據(jù)資源名稱resourcename

9所屬職責目錄dutyname

10數(shù)據(jù)起始時間startdate

11版本version

12數(shù)據(jù)項集合fieldlist

13字段名稱fieldname

14取值范圍valuerange

15是否為空isnull1：是，0：否

16是否主鍵iskey1：是，0：否

17字段描述description

18字段長度fieldlength

0：無條件共享，1：有

19共享類型sharetype

條件共享，2：不予共享

20字段類型fieldtype

21對應字段structguid

22開放屬性opentype

23數(shù)據(jù)樣例example

24查詢狀態(tài)start

180

T/CESAXXX.4—202X

25成功1；失敗0code

26接口調(diào)用說明text

A.4信息系統(tǒng)對象描述

{

"status":"0",

"count":"0",

"data":[

{

"id":"信息系統(tǒng)id",

"appname":"信息系統(tǒng)名稱",

"oucode":"單位編碼",

"ouname":"單位名稱",

"list":"是否完成目錄編制",

"listemark":"未編制備注說明",

"listexplain":"未編制具體情況說明",

"contacter":"聯(lián)系人姓名",

"phone":"聯(lián)系人電話"

}

]

}

信息系統(tǒng)對象參數(shù)說明見表A.4：

表A.4信息系統(tǒng)對象參數(shù)說明

序號名稱字段名備注

1執(zhí)行結果代碼status

2執(zhí)行結果數(shù)量count

3數(shù)據(jù)data

4信息系統(tǒng)idid

5信息系統(tǒng)名稱appname

6單位編碼oucode

7單位名稱ouname

8是否編制目錄List0：未編制，1：已編制，2：計劃編制

9未入云備注說明listremark

10未入云具體情況說明listexplain

11聯(lián)系人姓名contacter

12聯(lián)系人電話phone

表A.5數(shù)據(jù)目錄上傳示例

數(shù)據(jù)目數(shù)據(jù)數(shù)據(jù)格數(shù)據(jù)日數(shù)據(jù)資數(shù)數(shù)長字取樣共享共開

19

T/CESAXXX.4—202X

錄名稱更新式期量源據(jù)據(jù)度段值例類型享放

周期摘項類描范條屬

要名型述圍件性

稱

數(shù)據(jù)目1月ORACLE2023/3/100G案數(shù)字100無條開

錄XX9B例據(jù)符件共放

項1型享

數(shù)據(jù)目1月ORACLE2023/3/101G案數(shù)整100無條開

錄XX9B例據(jù)型件共放

項2享

數(shù)據(jù)目1月ORACLE2023/3/102G案數(shù)時100無條開

錄XX9B例據(jù)間件共放

項3型享

200

T/CESAXXX.4—202X

附錄B

（規(guī)范性）

返回狀態(tài)碼

返回狀態(tài)碼說明

200成功

1001無效token

1003沒有訪問權限

1599登錄失敗

1707Sql錯誤

4000調(diào)用智能合約失敗

5002數(shù)據(jù)項名稱重復

5004業(yè)務目錄不存在

5011數(shù)據(jù)目錄不存在

5013數(shù)據(jù)