版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领
文档简介
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. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。
最新文档
- 2026年互联网+教育行业融合报告及未来五年前景
- 2026年化妆品行业热点借势与品牌塑造报告
- 2026年汽车电子配件行业报告:车联网技术对内饰设计的影响
- 2026年5G行业线上应用消费报告及线下体验创新
- 2026年电子商务行业支付工具安全评估报告
- 2026年行业便民服务平台服务创新与用户需求匹配报告
- 2026年电商直播助力农产品上行渠道拓展报告
- 2026年SEOSEM行业市场分析报告
- 2026年人工智能行业投资热点与分红分析报告
- 2026年房地产行业优胜劣汰与市场结构优化报告
- 雨课堂学堂在线学堂云《园艺植物研究法( 宁夏)》单元测试考核答案
- 企业文化建设咨询服务合同
- 雨课堂在线学堂《医学实验技术与方法新进展》单元考核测试答案
- 2025年陕西省公务员行测(A类)真题及答案
- 项目经理带班记录
- 国家基本公共卫生服务项目培训课件
- 2025年ISO90012015内审员培训测试卷含答案
- (正式版)DB32∕T 5139-2025 《滑坡崩塌地面塌陷精细调查与风险评价规范》
- 实验五金属有机框架MOF纳米材料的合成与制备87课件
- 滑翔伞教学课件
- 2025年中考数学总复习《二次函数压轴题(角度问题)》专项测试卷(附参考答案)
评论
0/150
提交评论