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

1社会治安基础管控平台接口协议规范社会治安基础管控平台接口协议规范2024-11-10发布邯郸市市场监督管理局发布I本文件按照GB/T1.1-2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本文件由邯郸市公安局提出并起草。本文件主要起草人：王健、黄玉凯、贾志光、钱磊、暴学金、刘林、史晓波、毕严先、张瑞、闫付龙、王煜、李叶。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接口功能25.1公共功能5.1.1用户验证接口各消息应首先带用户验证消息。5.1.2校时接口各接入端应同服务器校对当前时间。5.2数据接口应支持各数据使用端查新增、删除、查询、更新等功能。操作接口后如果5s内未收到响应，则视为操作失败，应重新操作。见表1表1数据接口1新增数据项2查询数据项3删除数据项4更新数据项6接口资源描述见表2资源URI说明12校对时间3新增数据项4查询数据项5更改数据项6删除数据项7接口消息7.1接口说明7.1.1响应状态说明(ResponseStatus)ResponseStatus为操作响应体，包括以下字段：——code:操作码，200为成功。——Xinxi:对应操作码的错误信息。——Shuju:如果返回数据则为数据项的响应体。见表3表3操作码说明说明1操作成功2334系统错误5见表4校验用户信息查询子串注1:查询子串中：CAOZUOREN-ID:每一个操作人被分配的操作系统的账号标识JIAOYANMA:SM3(Str(RequestBody)+用户秘钥-每一个操作人ID对应一个操作秘钥)注2:RequestBody:为对应资源对象的序列化表5校对时间校对时间查询子串注1:查询子串中：CAOZUOREN-ID:每一个操作人被分配的操作系统的账号标识JIAOYANMA:SM3(Str(RequestBody)+用户秘钥-每一个操作人ID对应一个操作秘钥)注2:RequestBody为对应资源对象的序列化注3:RequestStatus为操作响应体，包括以下字段。xinxi:对应操作码的错误信息4见表6新增数据查询子串CAOZUOREN-ID:每一个操作人被分配的操作系统的账号标识SHIJIANCHUO:当前系统时间戳JIAOYANMA:SM3(Str(RequestBody)+用户秘钥-每一个操作人ID对应一个操作秘钥)注2:RequestBody为对应资源对象的序列化注3:RequestStatus为操作响应体，包括以下字段。xinxi:对应操作码的错误信息查询数据查询子串CAOZUOREN-ID:每一个操作人被分配的操作系统的账号标识SHIJIANCHUO:当前系统时间戳JIAOYANMA:SM3(Str(RequestBody)+用户秘钥-每一个操作人ID对应一个操作秘钥)注2:RequestBody为对应资源对象的序列化注3:RequestStatus为操作响应体，包括以下字段。xinxi:对应操作码的错误信息见表8更改数据查询子串5注1:查询子串中：ZIYUNA-ID:要访问的资源ID,如果要访问自然人，则为自然任的资源标识CAOZUOREN-ID:每一个操作人被分配的操JIAOYANMA:SM3(Str(RequestBody)+用户秘钥-每一个操作人ID对应一个操作秘钥)注3:RequestStatus为操作响应体，包括以下字段。code:操作码，200为成功。xinxi:对应操作码的错误信息shuju:如果返回数据则为数据项的响应体见表9删除数据查询子串注1:查询子串中：CAOZUOREN-ID:每一个操作人被分配的操作系统的账号标识JIAOYANMA:SM3(Str(R