DB1304∕T 496-2024 社会治安基础管控平台接口协议规范_第1页
DB1304∕T 496-2024 社会治安基础管控平台接口协议规范_第2页
DB1304∕T 496-2024 社会治安基础管控平台接口协议规范_第3页
DB1304∕T 496-2024 社会治安基础管控平台接口协议规范_第4页
DB1304∕T 496-2024 社会治安基础管控平台接口协议规范_第5页
已阅读5页,还剩2页未读, 继续免费阅读

下载本文档

版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领

文档简介

ICS35.020

CCSA90

DB1304

邯郸市地方标准

DB1304/T496—2024

社会治安基础管控平台接口协议规范

SocialSecurityBasicControlPlatformInterfaceProtocolSpecification

2024-11-10发布2024-12-01实施

邯郸市市场监督管理局发布

1

DB1304/T496—2024

前言

本文件按照GB/T1.1-2020《标准化工作导则第1部分:标准化文件的结构和起草规则》的规定起

草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。

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

本文件主要起草人:王健、黄玉凯、贾志光、钱磊、暴学金、刘林、史晓波、毕严先、张瑞、闫付

龙、王煜、李叶。

I

DB1304/T496—2024

社会治安基础管控平台接口协议规范

1范围

本文件规定了社会治安基础管控平台的术语、定义、接口分类与协议结构、接口功能、接口资源描

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

本文件适用于社会治安基础管控平台的规划设计、软件开发及接口协议的符合性测试。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,

仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本

文件。

GB4943.1-2011信息技术设备安全第1部分:通用要求

GB17859计算机信息系统安全保护等级划分准则

GB/T20271-2006信息安全技术信息系统通用安全技术要求

GB50348-2018安全防范工程技术标准

3术语、定义

下列术语和定义适用于本文件。

基础管控平台

指利用现代信息技术手段,针对基层社会治理提供数据采集、分析研判、预警提示、任务流转、绩

效考核等功能的信息系统。

4接口分类与协议结构

4.1接口分类

治安要素采集管理应用系统的接口包括公共接口、数据服务接口。

4.2协议结构

4.2.1接口协议架构遵循REST架构协议模型、JSON树状层级结构组织。

4.2.2接口交互连接方式应支持HTTP长连接和短连接,实现机制应符合IETFRFC2616中的相关规

定。

4.3执行方法

执行方法:POST。

5接口功能

1

5.1公共功能

5.1.1用户验证接口

各消息应首先带用户验证消息。

5.1.2校时接口

各接入端应同服务器校对当前时间。

5.2数据接口

应支持各数据使用端查新增、删除、查询、更新等功能。操作接口后如果5s内未收到响应,则视为

操作失败,应重新操作。见表1

表1数据接口

序号功能对应接口消息章节执行方法

1新增数据项7.2.3POST

2查询数据项7.2.4POST

3删除数据项7.2.5POST

4更新数据项7.2.6POST

6接口资源描述

见表2

表2接口资源描述

序号资源URI说明

1/USR/YANZHENG用户验证

2/USR/JIAOSHI校对时间

3/DATA/XIN新增数据项

4/DATA/CHA查询数据项

5/DATA/GAI更改数据项

6/DATA/SHAN删除数据项

7接口消息

7.1接口说明

接口应支持POST和BODY共同传输参数。

7.1.1响应状态说明(ResponseStatus)

ResponseStatus为操作响应体,包括以下字段:

——code:操作码,200为成功。

——Xinxi:对应操作码的错误信息。

——Shuju:如果返回数据则为数据项的响应体。

见表3

表3操作码说明

序号操作码说明

1200操作成功

2300操作数据已存在

3400权限不足

2

DB1304/T496—2024

4500系统错误

5700保留字段

7.2消息说明

7.2.1用户验证

见表4

表4用户验证

URI/USR/YANZHENG

功能校验用户信息

方法查询子串消息体返回结果

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

SHIJIANCHUO、JIAOYANMA

注1:查询子串中:

ZIYUNA-ID:要访问的资源ID,如果要访问自然人,则为自然任的资源标识

CAOZUOREN-ID:每一个操作人被分配的操作系统的账号标识

SHIJIANCHUO:当前系统时间戳

JIAOYANMA:SM3(Str(RequestBody)+用户秘钥-每一个操作人ID对应一个操作秘钥)

注2:RequestBody:为对应资源对象的序列化

注3:RequestStatus:为操作响应体

7.2.2校对时间

见表5

表5校对时间

URI/USR/JIAOSHI

功能校对时间

方法查询子串消息体返回结果

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

SHIJIANCHUO、JIAOYANMA

注1:查询子串中:

ZIYUNA-ID:要访问的资源ID,如果要访问自然人,则为自然任的资源标识

CAOZUOREN-ID:每一个操作人被分配的操作系统的账号标识

SHIJIANCHUO:当前系统时间戳

JIAOYANMA:SM3(Str(RequestBody)+用户秘钥-每一个操作人ID对应一个操作秘钥)

注2:RequestBody为对应资源对象的序列化

注3:RequestStatus为操作响应体,包括以下字段。

code:操作码,200为成功。

xinxi:对应操作码的错误信息

shuju:如果返回数据则为数据项的响应体

7.2.3新增数据

3

见表6

表6新增数据

URI/DATA/XIN

功能新增数据

方法查询子串消息体返回结果

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

SHIJIANCHUO、JIAOYANMA

注1:查询子串中:

ZIYUNA-ID:要访问的资源ID,如果要访问自然人,则为自然任的资源标识

CAOZUOREN-ID:每一个操作人被分配的操作系统的账号标识

SHIJIANCHUO:当前系统时间戳

JIAOYANMA:SM3(Str(RequestBody)+用户秘钥-每一个操作人ID对应一个操作秘钥)

注2:RequestBody为对应资源对象的序列化

注3:RequestStatus为操作响应体,包括以下字段。

code:操作码,200为成功。

xinxi:对应操作码的错误信息

shuju:如果返回数据则为数据项的响应体

7.2.4查询数据

见表7

表7查询数据

URI/DATA/CHA

功能查询数据

方法查询子串消息体返回结果

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

SHIJIANCHUO、JIAOYANMA

注1:查询子串中:

ZIYUNA-ID:要访问的资源ID,如果要访问自然人,则为自然任的资源标识

CAOZUOREN-ID:每一个操作人被分配的操作系统的账号标识

SHIJIANCHUO:当前系统时间戳

JIAOYANMA:SM3(Str(RequestBody)+用户秘钥-每一个操作人ID对应一个操作秘钥)

注2:RequestBody为对应资源对象的序列化

注3:RequestStatus为操作响应体,包括以下字段。

code:操作码,200为成功。

xinxi:对应操作码的错误信息

shuju:如果返回数据则为数据项的响应体

7.2.5更改数据

见表8

表8更改数据

URI/DATA/GAI

功能更改数据

方法查询子串消息体返回结果

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

SHIJIANCHUO、JIAOYANMA

4

DB1304/T496—2024

注1:查询子串中:

ZIYUNA-ID:要访问的资源ID,如果要访问自然人,则为自然任的资源标识

CAOZUOREN-ID:每一个操作人被分配的操作系统的账号标识

SHIJIANCHUO:当前系统时间戳

JIAOYANMA:SM3(Str(RequestBody)+用户秘钥-每一个操作人ID对应一个操作秘钥)

注2:RequestBody为对应资源对象的序列化

注3:RequestStatus为操作响应体,包括以下字段。

code:操作码,200为成功。

xinxi:对应操作码的错误信息

shuju:如果返回数据则为数据项的响应体

7.2.6删除数据

见表9

表9删除数据

URI/DATA/SHAN

功能删除数据

方法查询子串

温馨提示

  • 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
  • 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
  • 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
  • 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
  • 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
  • 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
  • 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。

评论

0/150

提交评论