ICS35.020

CCSA90

DB1304

邯鄲市地方標(biāo)準(zhǔn)

DB1304/T496—2024

社會治安基礎(chǔ)管控平臺接口協(xié)議規(guī)范

SocialSecurityBasicControlPlatformInterfaceProtocolSpecification

2024-11-10發(fā)布2024-12-01實施

邯鄲市市場監(jiān)督管理局發(fā)布

1

DB1304/T496—2024

前言

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

草。

請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識別這些專利的責(zé)任。

本文件由邯鄲市公安局提出并起草。

本文件主要起草人：王健、黃玉凱、賈志光、錢磊、暴學(xué)金、劉林、史曉波、畢嚴(yán)先、張瑞、閆付

龍、王煜、李葉。

I

DB1304/T496—2024

社會治安基礎(chǔ)管控平臺接口協(xié)議規(guī)范

1范圍

本文件規(guī)定了社會治安基礎(chǔ)管控平臺的術(shù)語、定義、接口分類與協(xié)議結(jié)構(gòu)、接口功能、接口資源描

述、接口消息、消息交互流程和消息交互安全性。

本文件適用于社會治安基礎(chǔ)管控平臺的規(guī)劃設(shè)計、軟件開發(fā)及接口協(xié)議的符合性測試。

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

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

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

文件。

GB4943.1-2011信息技術(shù)設(shè)備安全第1部分：通用要求

GB17859計算機(jī)信息系統(tǒng)安全保護(hù)等級劃分準(zhǔn)則

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

GB50348-2018安全防范工程技術(shù)標(biāo)準(zhǔn)

3術(shù)語、定義

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

基礎(chǔ)管控平臺

指利用現(xiàn)代信息技術(shù)手段，針對基層社會治理提供數(shù)據(jù)采集、分析研判、預(yù)警提示、任務(wù)流轉(zhuǎn)、績

效考核等功能的信息系統(tǒng)。

4接口分類與協(xié)議結(jié)構(gòu)

4.1接口分類

治安要素采集管理應(yīng)用系統(tǒng)的接口包括公共接口、數(shù)據(jù)服務(wù)接口。

4.2協(xié)議結(jié)構(gòu)

4.2.1接口協(xié)議架構(gòu)遵循REST架構(gòu)協(xié)議模型、JSON樹狀層級結(jié)構(gòu)組織。

4.2.2接口交互連接方式應(yīng)支持HTTP長連接和短連接，實現(xiàn)機(jī)制應(yīng)符合IETFRFC2616中的相關(guān)規(guī)

定。

4.3執(zhí)行方法

執(zhí)行方法：POST。

5接口功能

1

5.1公共功能

5.1.1用戶驗證接口

各消息應(yīng)首先帶用戶驗證消息。

5.1.2校時接口

各接入端應(yīng)同服務(wù)器校對當(dāng)前時間。

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

應(yīng)支持各數(shù)據(jù)使用端查新增、刪除、查詢、更新等功能。操作接口后如果5s內(nèi)未收到響應(yīng)，則視為

操作失敗，應(yīng)重新操作。見表1

表1數(shù)據(jù)接口

序號功能對應(yīng)接口消息章節(jié)執(zhí)行方法

1新增數(shù)據(jù)項7.2.3POST

2查詢數(shù)據(jù)項7.2.4POST

3刪除數(shù)據(jù)項7.2.5POST

4更新數(shù)據(jù)項7.2.6POST

6接口資源描述

見表2

表2接口資源描述

序號資源URI說明

1/USR/YANZHENG用戶驗證

2/USR/JIAOSHI校對時間

3/DATA/XIN新增數(shù)據(jù)項

4/DATA/CHA查詢數(shù)據(jù)項

5/DATA/GAI更改數(shù)據(jù)項

6/DATA/SHAN刪除數(shù)據(jù)項

7接口消息

7.1接口說明

接口應(yīng)支持POST和BODY共同傳輸參數(shù)。

7.1.1響應(yīng)狀態(tài)說明（ResponseStatus）

ResponseStatus為操作響應(yīng)體，包括以下字段:

——code：操作碼，200為成功。

——Xinxi：對應(yīng)操作碼的錯誤信息。

——Shuju：如果返回數(shù)據(jù)則為數(shù)據(jù)項的響應(yīng)體。

見表3

表3操作碼說明

序號操作碼說明

1200操作成功

2300操作數(shù)據(jù)已存在

3400權(quán)限不足

2

DB1304/T496—2024

4500系統(tǒng)錯誤

5700保留字段

7.2消息說明

7.2.1用戶驗證

見表4

表4用戶驗證

URI/USR/YANZHENG

功能校驗用戶信息

方法查詢子串消息體返回結(jié)果

POSTZIYUAN-ID、CAOZUOREN-ID、<RequestBody><ResponseStatus>

SHIJIANCHUO、JIAOYANMA

注1：查詢子串中：

ZIYUNA-ID：要訪問的資源ID，如果要訪問自然人，則為自然任的資源標(biāo)識

CAOZUOREN-ID：每一個操作人被分配的操作系統(tǒng)的賬號標(biāo)識

SHIJIANCHUO：當(dāng)前系統(tǒng)時間戳

JIAOYANMA：SM3（Str（RequestBody）+用戶秘鑰-每一個操作人ID對應(yīng)一個操作秘鑰）

注2：RequestBody：為對應(yīng)資源對象的序列化

注3：RequestStatus：為操作響應(yīng)體

7.2.2校對時間

見表5

表5校對時間

URI/USR/JIAOSHI

功能校對時間

方法查詢子串消息體返回結(jié)果

POSTZIYUAN-ID、CAOZUOREN-ID、<RequestBody><ResponseStatus>

SHIJIANCHUO、JIAOYANMA

注1：查詢子串中：

ZIYUNA-ID：要訪問的資源ID，如果要訪問自然人，則為自然任的資源標(biāo)識

CAOZUOREN-ID：每一個操作人被分配的操作系統(tǒng)的賬號標(biāo)識

SHIJIANCHUO：當(dāng)前系統(tǒng)時間戳

JIAOYANMA：SM3（Str（RequestBody）+用戶秘鑰-每一個操作人ID對應(yīng)一個操作秘鑰）

注2：RequestBody為對應(yīng)資源對象的序列化

注3：RequestStatus為操作響應(yīng)體，包括以下字段。

code：操作碼，200為成功。

xinxi:對應(yīng)操作碼的錯誤信息

shuju:如果返回數(shù)據(jù)則為數(shù)據(jù)項的響應(yīng)體

7.2.3新增數(shù)據(jù)

3

見表6

表6新增數(shù)據(jù)

URI/DATA/XIN

功能新增數(shù)據(jù)

方法查詢子串消息體返回結(jié)果

POSTZIYUAN-ID、CAOZUOREN-ID、<RequestBody><ResponseStatus>

SHIJIANCHUO、JIAOYANMA

注1：查詢子串中：

ZIYUNA-ID：要訪問的資源ID，如果要訪問自然人，則為自然任的資源標(biāo)識

CAOZUOREN-ID：每一個操作人被分配的操作系統(tǒng)的賬號標(biāo)識

SHIJIANCHUO：當(dāng)前系統(tǒng)時間戳

JIAOYANMA：SM3（Str（RequestBody）+用戶秘鑰-每一個操作人ID對應(yīng)一個操作秘鑰）

注2：RequestBody為對應(yīng)資源對象的序列化

注3：RequestStatus為操作響應(yīng)體，包括以下字段。

code：操作碼，200為成功。

xinxi:對應(yīng)操作碼的錯誤信息

shuju:如果返回數(shù)據(jù)則為數(shù)據(jù)項的響應(yīng)體

7.2.4查詢數(shù)據(jù)

見表7

表7查詢數(shù)據(jù)

URI/DATA/CHA

功能查詢數(shù)據(jù)

方法查詢子串消息體返回結(jié)果

POSTZIYUAN-ID、CAOZUOREN-ID、<RequestBody><ResponseStatus>

SHIJIANCHUO、JIAOYANMA

注1：查詢子串中：

ZIYUNA-ID：要訪問的資源ID，如果要訪問自然人，則為自然任的資源標(biāo)識

CAOZUOREN-ID：每一個操作人被分配的操作系統(tǒng)的賬號標(biāo)識

SHIJIANCHUO：當(dāng)前系統(tǒng)時間戳

JIAOYANMA：SM3（Str（RequestBody）+用戶秘鑰-每一個操作人ID對應(yīng)一個操作秘鑰）

注2：RequestBody為對應(yīng)資源對象的序列化

注3：RequestStatus為操作響應(yīng)體，包括以下字段。

code：操作碼，200為成功。

xinxi:對應(yīng)操作碼的錯誤信息

shuju:如果返回數(shù)據(jù)則為數(shù)據(jù)項的響應(yīng)體

7.2.5更改數(shù)據(jù)

見表8

表8更改數(shù)據(jù)

URI/DATA/GAI

功能更改數(shù)據(jù)

方法查詢子串消息體返回結(jié)果

POSTZIYUAN-ID、CAOZUOREN-ID、<RequestBody><ResponseStatus>

SHIJIANCHUO、JIAOYANMA

4

DB1304/T496—2024

注1：查詢子串中：

ZIYUNA-ID：要訪問的資源ID，如果要訪問自然人，則為自然任的資源標(biāo)識

CAOZUOREN-ID：每一個操作人被分配的操作系統(tǒng)的賬號標(biāo)識

SHIJIANCHUO：當(dāng)前系統(tǒng)時間戳

JIAOYANMA：SM3（Str（RequestBody）+用戶秘鑰-每一個操作人ID對應(yīng)一個操作秘鑰）

注2：RequestBody為對應(yīng)資源對象的序列化

注3：RequestStatus為操作響應(yīng)體，包括以下字段。

code：操作碼，200為成功。

xinxi:對應(yīng)操作碼的錯誤信息

shuju:如果返回數(shù)據(jù)則為數(shù)據(jù)項的響應(yīng)體

7.2.6刪除數(shù)據(jù)

見表9

表9刪除數(shù)據(jù)

URI/DATA/SHAN

功能刪除數(shù)據(jù)

方法查詢子串