- 1、本文档共7页,可阅读全部内容。
- 2、原创力文档(book118)网站文档一经付费(服务费),不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
- 3、本站所有内容均由合作方或网友上传,本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺!文档内容仅供研究参考,付费前请自行鉴别。如您付费,意味着您自己接受本站规则且自行承担风险,本站不退款、不进行额外附加服务;查看《如何避免下载的几个坑》。如果您已付费下载过本站文档,您可以点击 这里二次下载。
- 4、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“版权申诉”(推荐),也可以打举报电话:400-050-0827(电话支持时间:9:00-18:30)。
ICS35.240CCSL67
41
河南省地方标准
DB41/T2735—2024
综合法人库数据服务和应用接口规范
2024-08-26发布2024-11-25实施
河南省市场监督管理局发布
DB41/T2735—2024
I
目次
前言 II
1范围 1
2规范性引用文件 1
3术语和定义 1
4缩略语 1
5设计原则 1
6技术要求 2
7开发要求 2
8发布要求 2
9安全和审计要求 2
附录A(规范性)接口调用返回码 4
DB41/T2735—2024
II
前言
本文件按照GB/T1.1—2020《标准化工作导则第1部分:标准化文件的结构和起草规则》的规定
起草。
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本文件由河南省行政审批和政务信息管理局提出。
本文件由河南省大数据标准化技术委员会(HN/TC26)归口。
本文件起草单位:正数网络技术有限公司、河南省政务大数据中心、河南省平台经济发展指导中心。
本文件主要起草人:郭强、张震、杨帆、申光宇、岳正飞、周旭阳、张祥、贾吴帆、时洪飞、孟祥宾、张夏雯。
DB41/T2735—2024
1
综合法人库数据服务和应用接口规范
1范围
本文件规定了综合法人库数据服务和应用接口的设计原则、技术要求、开发要求、发布要求、安全和审计要求。
本文件适用于省、市综合法人库服务和应用接口的设计、开发和实施。
2规范性引用文件
下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。
GB/T22239—2019信息安全技术网络安全等级保护基本要求
GB/T35273—2020信息安全技术个人信息安全规范
3术语和定义
下列术语和定义适用于本文件。3.1
接口
信息系统为开放特定业务功能而发布的可供其他系统调用的应用编程函数。
[来源:GB/T42877—2023,3.2]3.2
服务
提供给用户并满足其应用需求的有形或无形的活动。[来源:GB/T34077.5—2020,3.1]
4缩略语
下列缩略语适用于本文件。
JSON:JavaScript对象简谱(JavaScriptObjectNotation)REST:表述性状态传递(RepresentationalStateTransfer)
UTF-8:针对Unicode的可变长度字符编码(8-bitUnicodeTransformationFormat)XML:可扩展标记语言(ExtensibleMarkupLanguage)
5设计原则
设计原则包括但不限于以下原则:
a)安全性原则:应提供多种安全可靠的技术手段,保证接口数据的安全;
b)开放性原则:应采用通用的接口设计标准,保证与其他系统的互联互通;
DB41/T2735—2024
2
c)稳定性原则:应保证接口稳定,避免频繁的修改和不必要的改动;
d)松耦合原则:应避免提供方的业务系统对接口服务实现的依赖性;
e)可审计原则:应提供支持多种规则,实现对服务接口使用情况形成全面准确的日志审计功能。
6技术要求
接口技术要求包括但不限于:
a)应采用HTTP/HTTPS作为传输协议;
b)应采用JSON或XML作为消息的封装格式;
c)应提供服务请求成功、失败等各种情况的调用返回码;
d)应支持对请求的合法性和数据进行验证。
7开发要求
开发的接口应由需求方提出申请,提供方提供接口地址、用户名、密码、接口功能名称等信息,并由接口开发人员编写需求文档。
接口开发要求包括但不限于:
a)接口命名:应采用大小写混合的形式,以小写字母开头,名称中其他单词的首字母以大写字母开头,不宜使用下划线分割单词;
b)接口方式:一般包括WebService和REST两种方式。若为REST方式,应标明REST操作;
c)接口测试:接口应提供开放测试权限,并提供测试用例;
d)接口参数:REST类型的服务接口,应在Header里传入授权验证相关的参数;WebService类型的服务接口,应在HTTP的Body中进行传递。传递参数为中文字符时,应以UTF-8编码;
e)返回数据:应
您可能关注的文档
- DB41_T 611-2024 高速公路收费服务.docx
- DB41_T 2737-2024 核医学131I治疗职业人员内照射剂量体外监测规范.docx
- DB41_T 2747-2024 公路桥梁支座检测与安装技术规程.docx
- DB45_T 2850-2024 科技企业孵化器建设与培育服务规范.docx
- DB45_T 2851-2024 众创空间建设与培育服务规范.docx
- DB45_T 2855-2024 建设用地时空数据库规范.docx
- DB45_T 2857-2024 农产品质量安全追溯信息编码和标识.docx
- DB5108_T 57-2024 营商环境供水服务规范.docx
- DB5111_T 48-2024 乐山市餐饮食品中异物防控指南.docx
- DB5115_T 129-2024 油樟优树选择技术规程.docx
文档评论(0)