DB61T1499-2021紀(jì)檢監(jiān)察信息化監(jiān)督平臺(tái)數(shù)據(jù)接入規(guī)范

ICS35.100.70

CCSL79

DB61

陜西省地方標(biāo)準(zhǔn)

DB61/T1488—2021

紀(jì)檢監(jiān)察信息化監(jiān)督平臺(tái)數(shù)據(jù)接入規(guī)范

Dataaccessspecificationforinformatizationsupervisionplatformofdiscipline

inspectionandsupervision

2021-12-17發(fā)布2022-01-17實(shí)施

陜西省市場(chǎng)監(jiān)督管理局發(fā)布

DB61/T1499—2021

目次

前言II

引言III

1范圍1

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

3術(shù)語和定義1

4縮略語2

5數(shù)據(jù)接入方式2

6數(shù)據(jù)接入流程2

7認(rèn)證與鑒權(quán)6

8數(shù)據(jù)安全管理6

附錄A（規(guī)范性）接口響應(yīng)狀態(tài)碼7

附錄B（資料性）接口請(qǐng)求格式8

參考文獻(xiàn)10

I

DB61/T1499—2021

前言

本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定

起草。

本文件由中共陜西省紀(jì)律檢查委員會(huì)、陜西省監(jiān)察委員會(huì)提出并歸口。

本文件起草單位：中共陜西省紀(jì)律檢查委員會(huì)、陜西省監(jiān)察委員會(huì)、中共陜西省委網(wǎng)絡(luò)安全和信息

化委員會(huì)、陜西省發(fā)展和改革委員會(huì)、陜西省財(cái)政廳、陜西省住房和城鄉(xiāng)建設(shè)廳、陜西省審計(jì)廳、陜西

省人民政府國有資產(chǎn)監(jiān)督管理委員會(huì)、陜西省市場(chǎng)監(jiān)督管理局、咸陽市大數(shù)據(jù)管理局。

本文件主要起草人：霍曉峰、段小剛、侯勃峰、張永、常玉蘭、韓宇東、劉愛云、劉強(qiáng)、柴明、楊

朝軍、張冬、趙軍、崔鵬飛、羅杰、馮欣。

本文件由中共陜西省紀(jì)律檢查委員會(huì)、陜西省監(jiān)察委員會(huì)負(fù)責(zé)解釋。

本文件首次發(fā)布。

聯(lián)系信息如下：

聯(lián)系單位：中共陜西省紀(jì)律檢查委員會(huì)、陜西省監(jiān)察委員會(huì)

聯(lián)系電話/p>

聯(lián)系地址：西安市雁塔區(qū)雁塔路10號(hào)

郵政編碼：710054

II

DB61/T1499—2021

引言

為貫徹黨的十九大和十九屆二中、三中、四中、五中、六中全會(huì)精神，堅(jiān)持和完善黨和國家監(jiān)督體

系、強(qiáng)化對(duì)權(quán)力運(yùn)行的制約監(jiān)督，落實(shí)中央紀(jì)委國家監(jiān)委部署的“建立權(quán)力運(yùn)行可查詢、可追溯的反饋

機(jī)制，加強(qiáng)紀(jì)檢監(jiān)察信息化監(jiān)督平臺(tái)建設(shè)，以公開促公正、以透明保廉潔”的任務(wù)，需加快建設(shè)陜西省

紀(jì)檢監(jiān)察信息化監(jiān)督平臺(tái)。用信息化手段助力紀(jì)檢監(jiān)察機(jī)關(guān)更好履行監(jiān)督專責(zé)，變被動(dòng)的事后監(jiān)督為積

極的事前防范，強(qiáng)化不敢腐的震懾，扎牢不能腐的籠子，增強(qiáng)不想腐的自覺。通過接入外部數(shù)據(jù)、貫通

內(nèi)部數(shù)據(jù)、強(qiáng)化數(shù)據(jù)利用，實(shí)現(xiàn)廉政風(fēng)險(xiǎn)動(dòng)態(tài)監(jiān)測(cè)與實(shí)時(shí)預(yù)警，著力讓數(shù)據(jù)“開口說話”，幫助監(jiān)督對(duì)

象所在單位預(yù)防和發(fā)現(xiàn)廉政問題，做到懲前毖后、治病救人、抓早抓小、防微杜漸。

制定統(tǒng)一的數(shù)據(jù)接入標(biāo)準(zhǔn)，旨在規(guī)范監(jiān)督對(duì)象單位在陜西省紀(jì)檢監(jiān)察信息化監(jiān)督平臺(tái)中建立、維護(hù)

數(shù)據(jù)目錄和服務(wù)接口，發(fā)揮大數(shù)據(jù)在監(jiān)督檢查工作中的重要作用，促進(jìn)黨內(nèi)監(jiān)督和其他各類監(jiān)督貫通協(xié)

同，助力新時(shí)代紀(jì)檢監(jiān)察工作高質(zhì)量發(fā)展。

III

DB61/T1499—2021

紀(jì)檢監(jiān)察信息化監(jiān)督平臺(tái)數(shù)據(jù)接入規(guī)范

1范圍

本文件規(guī)定了監(jiān)督對(duì)象單位信息系統(tǒng)數(shù)據(jù)接入紀(jì)檢監(jiān)察信息化監(jiān)督平臺(tái)的數(shù)據(jù)接入方法、數(shù)據(jù)接入

流程、認(rèn)證與鑒權(quán)以及數(shù)據(jù)安全管理等要求。

本文件適用于監(jiān)督對(duì)象單位信息系統(tǒng)數(shù)據(jù)接入紀(jì)檢監(jiān)察信息化監(jiān)督平臺(tái)工作。

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

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

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

文件。

GB/T4754國民經(jīng)濟(jì)行業(yè)分類

GB/T7408數(shù)據(jù)元和交換格式信息交換日期和時(shí)間表示法

GB/T20271信息安全技術(shù)信息系統(tǒng)通用安全技術(shù)要求

GB/T21063.4政務(wù)信息資源目錄體系第4部分：政務(wù)信息資源分類

RFC2616超文本傳輸協(xié)議-HTTP/1.1（HypertextTransferProtocol-HTTP/1.1）

3術(shù)語和定義

下列術(shù)語和定義適用于本文件。

3.1

紀(jì)檢監(jiān)察信息化監(jiān)督平臺(tái)informatizationsupervisionplatformofdisciplineinspection

andsupervision

在各類監(jiān)督貫通協(xié)同機(jī)制逐步建立完善基礎(chǔ)上建設(shè)的、支撐紀(jì)委監(jiān)委履行監(jiān)督專責(zé)的多個(gè)信息系統(tǒng)

的統(tǒng)稱。

注：通過平臺(tái)建設(shè)，可實(shí)現(xiàn)監(jiān)督對(duì)象履職情況記載、黨員干部黨風(fēng)廉政意見回復(fù)、各類監(jiān)督數(shù)據(jù)共享、紀(jì)委監(jiān)委內(nèi)

部權(quán)力運(yùn)行監(jiān)控，并接受社會(huì)監(jiān)督等。

3.2

監(jiān)督對(duì)象單位信息系統(tǒng)supervisionorganizationinformationsystem

監(jiān)督對(duì)象單位在履行職能過程中所建設(shè)和使用的信息系統(tǒng)。

3.3

數(shù)據(jù)提供方dataprovider

提供監(jiān)督數(shù)據(jù)的監(jiān)督對(duì)象單位。

1

DB61/T1499—2021

3.4

統(tǒng)一數(shù)據(jù)接入系統(tǒng)uniformdataaccesssystem

紀(jì)檢監(jiān)察信息化監(jiān)督平臺(tái)中實(shí)現(xiàn)數(shù)據(jù)接入過程管理的子系統(tǒng)。包含數(shù)據(jù)提供方賬號(hào)注冊(cè)、數(shù)據(jù)項(xiàng)、

數(shù)據(jù)目錄、審核、發(fā)布等功能。

3.5

前置機(jī)系統(tǒng)front-endprocessingsystem

是統(tǒng)一數(shù)據(jù)接入系統(tǒng)的組成部分，部署在監(jiān)督對(duì)象單位信息系統(tǒng)所在網(wǎng)絡(luò)環(huán)境里的軟件系統(tǒng)。負(fù)責(zé)

讀取接入數(shù)據(jù)，并向統(tǒng)一數(shù)據(jù)接入系統(tǒng)中發(fā)送數(shù)據(jù)。

4縮略語

下列縮略語適用于本文件。

JSON：JavaScript對(duì)象標(biāo)記（JavaScriptObjectNotation）

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

5數(shù)據(jù)接入方式

5.1概述

數(shù)據(jù)提供方通過紀(jì)檢監(jiān)察信息化監(jiān)督平臺(tái)實(shí)現(xiàn)數(shù)據(jù)規(guī)范接入。數(shù)據(jù)接入方式包括且不限于：

a)文件接入方式；

b)服務(wù)接口接入方式；

c)數(shù)據(jù)庫表接入方式。

5.2文件接入方式

數(shù)據(jù)提供方通過統(tǒng)一數(shù)據(jù)接入系統(tǒng)實(shí)現(xiàn)文件接入，將文件上傳并發(fā)布到統(tǒng)一數(shù)據(jù)接入系統(tǒng)。適用于

非結(jié)構(gòu)化數(shù)據(jù)或更新緩慢的結(jié)構(gòu)化數(shù)據(jù)。

5.3服務(wù)接口接入方式

由數(shù)據(jù)提供方通過服務(wù)接口的方式提供信息資源。根據(jù)本單位信息資源目錄，將單位信息系統(tǒng)的業(yè)

務(wù)數(shù)據(jù)整理并開發(fā)服務(wù)接口，設(shè)立專用的服務(wù)接口服務(wù)器部署運(yùn)行，確保服務(wù)接口的可用性，并將接口

注冊(cè)至統(tǒng)一數(shù)據(jù)接入系統(tǒng)。適用于實(shí)時(shí)性和靈活性要求高、數(shù)據(jù)量較小的數(shù)據(jù)。

5.4數(shù)據(jù)庫表接入方式

由數(shù)據(jù)提供方在統(tǒng)一數(shù)據(jù)接入系統(tǒng)中注冊(cè)庫表接入所需的數(shù)據(jù)源信息。統(tǒng)一數(shù)據(jù)接入系統(tǒng)通過前置

機(jī)系統(tǒng)從監(jiān)督對(duì)象單位信息系統(tǒng)的業(yè)務(wù)數(shù)據(jù)庫中抽取數(shù)據(jù)。適用于更新頻度較高的結(jié)構(gòu)化數(shù)據(jù)。

6數(shù)據(jù)接入流程

6.1總流程

紀(jì)檢監(jiān)察信息化監(jiān)督平臺(tái)實(shí)現(xiàn)數(shù)據(jù)接入的總體流程見圖1。相關(guān)要求包括且不限于：

2

DB61/T1499—2021

a)數(shù)據(jù)提供方在統(tǒng)一數(shù)據(jù)接入系統(tǒng)中完成元數(shù)據(jù)、數(shù)據(jù)目錄的創(chuàng)建、發(fā)布和更新；

b)數(shù)據(jù)提供方在統(tǒng)一數(shù)據(jù)接入系統(tǒng)中提供文件資源、接口資源或者數(shù)據(jù)庫表資源。

圖1統(tǒng)一數(shù)據(jù)接入系統(tǒng)功能組成和數(shù)據(jù)接入總流程

6.2元數(shù)據(jù)管理

6.2.1概述

由數(shù)據(jù)提供方對(duì)數(shù)據(jù)項(xiàng)進(jìn)行描述、發(fā)布，并對(duì)數(shù)據(jù)項(xiàng)進(jìn)行維護(hù)管理。

6.2.2數(shù)據(jù)項(xiàng)創(chuàng)建

數(shù)據(jù)提供方在統(tǒng)一數(shù)據(jù)接入系統(tǒng)中填寫數(shù)據(jù)字段，對(duì)其業(yè)務(wù)含義與技術(shù)含義進(jìn)行描述說明。

6.2.3數(shù)據(jù)項(xiàng)發(fā)布

數(shù)據(jù)提供方將統(tǒng)一數(shù)據(jù)接入系統(tǒng)中填寫的數(shù)據(jù)項(xiàng)進(jìn)行發(fā)布。

6.2.4數(shù)據(jù)項(xiàng)更新

數(shù)據(jù)提供方負(fù)責(zé)數(shù)據(jù)項(xiàng)的更新與管理，數(shù)據(jù)項(xiàng)管理要求包括且不限于：

a)統(tǒng)一數(shù)據(jù)項(xiàng)管理過程，保證數(shù)據(jù)項(xiàng)的完整性和實(shí)效性；

d)統(tǒng)一數(shù)據(jù)類型和格式（見表1）。

表1數(shù)據(jù)類型可能的取值列表

數(shù)據(jù)類型說明

字符型（string）通過字符形式表達(dá)的值的類型

浮點(diǎn)型（double）通過從“0”到“9”數(shù)字和小數(shù)點(diǎn)形式表達(dá)的值的類型

數(shù)字型(number)通過從“0”到“9”數(shù)字形式表達(dá)的值的類型

日期型(date)通過YYYYMMDD的形式表達(dá)的值的類型，符合GB/T7408規(guī)定

日期時(shí)間型(datetime)通過YYYYMMDDhhmmss的形式表達(dá)的值的類型，符合GB/T7408規(guī)定

布爾型(boolean)兩個(gè)且只有兩個(gè)表明條件的值，如On/Off、True/False等

二進(jìn)制塊(blob)上述無法表示的其他數(shù)據(jù)類型，比如圖像、音頻等

3

DB61/T1499—2021

6.2.5數(shù)據(jù)項(xiàng)訪問

在統(tǒng)一數(shù)據(jù)接入系統(tǒng)中可以訪問查看已發(fā)布的數(shù)據(jù)項(xiàng)信息。

6.3數(shù)據(jù)目錄管理

6.3.1概述

由數(shù)據(jù)提供方對(duì)數(shù)據(jù)進(jìn)行標(biāo)準(zhǔn)化處理后創(chuàng)建數(shù)據(jù)目錄、描述數(shù)據(jù)概要、發(fā)布數(shù)據(jù)文件等，并對(duì)數(shù)據(jù)

目錄進(jìn)行維護(hù)管理。數(shù)據(jù)目錄為樹形層級(jí)結(jié)構(gòu)，葉子層級(jí)的數(shù)據(jù)目錄需要關(guān)聯(lián)數(shù)據(jù)項(xiàng)信息。

6.3.2數(shù)據(jù)目錄創(chuàng)建

數(shù)據(jù)目錄創(chuàng)建的相關(guān)要求包括：

a)數(shù)據(jù)提供方在統(tǒng)一數(shù)據(jù)接入系統(tǒng)中填寫數(shù)據(jù)目錄信息，包括且不限于表2規(guī)定的內(nèi)容；

b)數(shù)據(jù)目錄主題分類應(yīng)符合GB/T21063.4的規(guī)定；

c)數(shù)據(jù)目錄行業(yè)分類應(yīng)符合GB/T4754的規(guī)定。

表2數(shù)據(jù)目錄內(nèi)容

編號(hào)數(shù)據(jù)項(xiàng)說明

1數(shù)據(jù)目錄編碼數(shù)據(jù)目錄的編碼

2名稱數(shù)據(jù)的名稱

3摘要對(duì)數(shù)據(jù)內(nèi)容的整體描述或說明

4主題分類數(shù)據(jù)所屬主題

5關(guān)鍵字對(duì)數(shù)據(jù)內(nèi)容的簡(jiǎn)要概括

6數(shù)據(jù)提供部門數(shù)據(jù)來源部門

7行業(yè)分類數(shù)據(jù)對(duì)應(yīng)的行業(yè)分類

8發(fā)布時(shí)間數(shù)據(jù)目錄發(fā)布的具體時(shí)間

9更新時(shí)間數(shù)據(jù)目錄更新的具體時(shí)間

10更新頻率數(shù)據(jù)目錄更新頻率，如年、月、周、日等

11所屬行政區(qū)域生成數(shù)據(jù)目錄的部門所屬行政區(qū)域

12支持格式數(shù)據(jù)格式，如CSV、XLS（或XLSX）、JSON等格式

13資源狀態(tài)數(shù)據(jù)目錄的狀態(tài)，如激活、廢棄等

14記錄數(shù)量目錄中數(shù)據(jù)的數(shù)量

15來源系統(tǒng)提供數(shù)據(jù)源的業(yè)務(wù)系統(tǒng)

16時(shí)間范圍數(shù)據(jù)內(nèi)容屬于的時(shí)間范圍

17接入方式選擇接入數(shù)據(jù)的方式，文件接入方式、服務(wù)接口接入方式、數(shù)據(jù)庫表接入方式

18數(shù)據(jù)項(xiàng)信息關(guān)聯(lián)多個(gè)數(shù)據(jù)項(xiàng)

6.3.3數(shù)據(jù)目錄發(fā)布

數(shù)據(jù)提供方在統(tǒng)一數(shù)據(jù)接入系統(tǒng)中將填寫的數(shù)據(jù)目錄進(jìn)行發(fā)布。

6.3.4數(shù)據(jù)目錄更新

數(shù)據(jù)提供方應(yīng)對(duì)數(shù)據(jù)目錄進(jìn)行更新,數(shù)據(jù)目錄維護(hù)要求包括且不限于：

a)數(shù)據(jù)目錄內(nèi)容與數(shù)據(jù)資源保持一致；

4

DB61/T1499—2021

b)數(shù)據(jù)目錄內(nèi)容在統(tǒng)一數(shù)據(jù)接入系統(tǒng)中變更后應(yīng)及時(shí)發(fā)布。

6.3.5數(shù)據(jù)目錄訪問

在統(tǒng)一數(shù)據(jù)接入系統(tǒng)中可以訪問查看已發(fā)布的數(shù)據(jù)目錄信息。

6.4數(shù)據(jù)文件管理

6.4.1概述

數(shù)據(jù)提供方應(yīng)將數(shù)據(jù)整理后導(dǎo)出為數(shù)據(jù)文件，并將數(shù)據(jù)文件上傳到對(duì)應(yīng)的數(shù)據(jù)目錄，對(duì)文件進(jìn)行發(fā)

布、更新等。

6.4.2數(shù)據(jù)文件發(fā)布

數(shù)據(jù)提供方將文件發(fā)布到統(tǒng)一數(shù)據(jù)接入系統(tǒng)，并指定對(duì)應(yīng)的數(shù)據(jù)目錄。數(shù)據(jù)提供方應(yīng)保證數(shù)據(jù)的完

整性、準(zhǔn)確性。文件應(yīng)滿足：

a)文件類型可為XML、CSV、JSON、xls(xlsx)格式文件；

b)文件壓縮格式為rar、zip壓縮文件類型。

6.4.3數(shù)據(jù)文件更新

數(shù)據(jù)提供方應(yīng)對(duì)數(shù)據(jù)資源文件進(jìn)行更新，確保數(shù)據(jù)的準(zhǔn)確性和鮮活性。

6.5服務(wù)接口管理

6.5.1概述

數(shù)據(jù)提供方應(yīng)提供數(shù)據(jù)資源訪問接口，并提供接口描述及調(diào)用方法。

6.5.2服務(wù)接口準(zhǔn)備

數(shù)據(jù)提供方根據(jù)需求設(shè)計(jì)接口。接口設(shè)計(jì)要求包括且不限于：

a)服務(wù)接口地址遵循HTTPS協(xié)議；

b)接口響應(yīng)時(shí)應(yīng)返回相應(yīng)的狀態(tài)碼，狀態(tài)碼參見附錄A；

c)接口編碼方式統(tǒng)一采用UTF-8編碼；

d)接口支持同步請(qǐng)求響應(yīng)調(diào)用模式。

6.5.3服務(wù)接口發(fā)布

服務(wù)接口發(fā)布要求包括且不限于：

a)接口生成后，數(shù)據(jù)提供方在統(tǒng)一數(shù)據(jù)接入系統(tǒng)中發(fā)布接口信息；

b)接口發(fā)布內(nèi)容應(yīng)包括且不限于以下信息：

1)接口說明（調(diào)用說明、請(qǐng)求參數(shù)、返回參數(shù)、功能說明），參見附錄B；

2)狀態(tài)碼參照表,狀態(tài)碼參見附錄A；

3)接口調(diào)用示例文檔。

6.5.4服務(wù)接口更新

數(shù)據(jù)提供方應(yīng)對(duì)服務(wù)接口進(jìn)行更新，確保服務(wù)接口準(zhǔn)確性。

在統(tǒng)一數(shù)據(jù)接入系統(tǒng)中變更接口后應(yīng)及時(shí)發(fā)布該接口。

5

DB61/T1499—2021

6.6數(shù)據(jù)庫表管理

6.6.1概述

數(shù)據(jù)提供方應(yīng)對(duì)所發(fā)布的數(shù)據(jù)源信息、庫表信息進(jìn)行配置與更新，確保數(shù)據(jù)的準(zhǔn)確性和鮮活性。

6.6.2數(shù)據(jù)庫表準(zhǔn)備

數(shù)據(jù)提供方在統(tǒng)一數(shù)據(jù)接入系統(tǒng)中注冊(cè)數(shù)據(jù)源信息，包含數(shù)據(jù)庫IP地址、端口號(hào)、數(shù)據(jù)庫產(chǎn)品、用

戶名和密碼、表名、所屬前置機(jī)系統(tǒng)。

6.6.3數(shù)據(jù)庫表發(fā)布與更新

數(shù)據(jù)庫表發(fā)布與更新要求包括且不限于：

a)數(shù)據(jù)提供方在統(tǒng)一數(shù)據(jù)接入系統(tǒng)中配置所發(fā)布數(shù)據(jù)庫表的數(shù)據(jù)項(xiàng)信息，如數(shù)據(jù)更新標(biāo)識(shí)、數(shù)據(jù)

唯一標(biāo)識(shí)；

b)數(shù)據(jù)庫表數(shù)據(jù)項(xiàng)更新時(shí)，應(yīng)在統(tǒng)一數(shù)據(jù)接入系統(tǒng)中同步修改相應(yīng)的庫表配置。

7認(rèn)證與鑒權(quán)

數(shù)據(jù)提供方需要在紀(jì)檢監(jiān)察信息化監(jiān)督平臺(tái)注冊(cè)登錄后才可填寫相應(yīng)資源信息并發(fā)布。

8數(shù)據(jù)安全管理

8.1基本要求

紀(jì)檢監(jiān)察信息化監(jiān)督平臺(tái)在數(shù)據(jù)產(chǎn)生、存儲(chǔ)、傳輸、應(yīng)用過程中，對(duì)數(shù)據(jù)制定安全策略，保障數(shù)據(jù)

安全。

8.2數(shù)據(jù)存儲(chǔ)安全

紀(jì)檢監(jiān)察信息化監(jiān)督平臺(tái)對(duì)數(shù)據(jù)存儲(chǔ)安全應(yīng)從物理安全、運(yùn)行安全、數(shù)據(jù)安全等多方面進(jìn)行保障，

具體可參考GB/T20271相關(guān)規(guī)定。

8.3數(shù)據(jù)傳輸安全

紀(jì)檢監(jiān)察信息化監(jiān)督平臺(tái)在數(shù)據(jù)接入過程中，使用國家認(rèn)可的加密算法對(duì)傳輸數(shù)據(jù)進(jìn)行加密，數(shù)據(jù)

傳輸過程中，所承載的網(wǎng)絡(luò)應(yīng)具有安全保障。

8.4數(shù)據(jù)防篡改

紀(jì)檢監(jiān)察信息化監(jiān)督平臺(tái)應(yīng)加強(qiáng)數(shù)據(jù)安全保障體系建設(shè)，防止數(shù)據(jù)造假、篡改、竊取等事件發(fā)生。

6

DB61/T1499—2021

AA

附錄A

（規(guī)范性）

接口響應(yīng)狀態(tài)碼

狀態(tài)碼的定義遵循RFC2616規(guī)范，接口響應(yīng)狀態(tài)碼包括且不限于表A.1：

表A.1接口返回狀態(tài)碼

狀態(tài)碼含義

200請(qǐng)求已成功

400請(qǐng)求信息不完整或無法解析

401訪問令牌沒有提供，或者無效

403訪問令牌有效，但沒有權(quán)限

404資源不存在

409資源沖突

422請(qǐng)求信息完整，但無效

500服務(wù)器內(nèi)部拋出錯(cuò)誤

7

DB61/T1499—2021

BB

附錄B

（資料性）

接口請(qǐng)求格式

B.1GET接口請(qǐng)求格式

接口請(qǐng)求格式示例見表B.1。

表B.1GET接口請(qǐng)求格式示例

請(qǐng)求URLhttps://ip:port/服務(wù)名稱

請(qǐng)求方法GET

請(qǐng)求參數(shù)是否必傳數(shù)據(jù)類型說明

page否數(shù)字型頁碼

size否數(shù)字型分頁大小

***否根據(jù)具體情況確定業(yè)務(wù)參數(shù)

返回參數(shù)

參數(shù)名是否必傳數(shù)據(jù)類型說明

code是數(shù)字型狀態(tài)碼(200表示請(qǐng)求正常，其它值異常)

消息提示，n為消息長度，其取值根據(jù)具體情況確

message否字符型(n)

定

接口的主數(shù)據(jù)，即業(yè)務(wù)數(shù)據(jù)?？梢愿鶕?jù)實(shí)際返回?cái)?shù)

data否根據(jù)具體情況確定

組或者特定格式數(shù)據(jù)對(duì)象（如JSON格式等）

total否數(shù)字型記錄總數(shù)，列表查詢返回

page否數(shù)字型當(dāng)前頁，列表查詢返回

size否數(shù)字型分頁大小，列表查詢返回

pages否數(shù)字型總頁數(shù)，列表查詢返回

8

DB61/T1499—2021

B.2POST接口請(qǐng)求格式

POST接口請(qǐng)求格式示例見表B.2。

表B.2POST接口請(qǐng)求格式示例

請(qǐng)求URLhttps://ip:port/服務(wù)名稱

請(qǐng)求方法POST

請(qǐng)求參數(shù)是否必傳數(shù)據(jù)類型說明

name否字符型名字

sex否數(shù)字型性別0表示男1表示女

age否數(shù)字型年齡

{

"name":"張某某",

請(qǐng)求參數(shù)JSON示例"sex":1,

"age":30

}

返回參數(shù)

參數(shù)名是否必傳數(shù)據(jù)類型說明

code是數(shù)字型狀態(tài)碼(200表示請(qǐng)求正常，其它值異常)

消息提示，n為消息長度，其取值根據(jù)具體情況確

message否字符型(n)

定

9

DB61/T1499—2021

參考文獻(xiàn)

[1]GB/T10113—2003分類與編碼通用術(shù)語

[2]GB/T18787.3—2015信息技術(shù)電子書第3部分：元數(shù)據(jù)

[3]GB/T37932—2019信息安全技術(shù)數(shù)據(jù)交易服務(wù)安全要求

10

DB61/T1499—2021

目次

前言II

引言III

1范圍1

2