DB52∕T 1541.4-2021 政务数据平台 第4部分:接口规范(贵州省).pdf
《DB52∕T 1541.4-2021 政务数据平台 第4部分:接口规范(贵州省).pdf》由会员分享,可在线阅读,更多相关《DB52∕T 1541.4-2021 政务数据平台 第4部分:接口规范(贵州省).pdf(28页珍藏版)》请在咨信网上搜索。
1、ICS 01.040.03A 12DB52贵州省地方标准DB52/T 1541.42021政务数据平台 第 4 部分:接口规范Government data platform Part4:Interface specification2021 - 05 - 17 发布2021 - 09 - 01 实施贵州省市场监督管理局发 布DB52/T 1541.42021I目次前言.II1范围.12规范性引用文件.13术语和定义.14缩略语.25基本要求.26接口组成.27接口要求.38接口安全.9附录 A(资料性)认证授权服务接口 JSONSchema 示例.10附录 B(资料性)组织新增接口 JSON
2、Schema 示例.11附录 C(资料性)用户新增接口 JSONSchema 示例.12附录 D(资料性)数据资源目录接口的接口信息 JSONSchema 示例.13附录 E(资料性)数据资源目录接口信息描述对象参数表.15附录 F(资料性)数据资源目录接口的目录信息 JSONSchema 描述示例.16附录 G(资料性)数据资源目录描述对象参数表.18附录 H(资料性)政务数据平台接口返回 JSONSchema 示例.19附录 I(资料性)政务数据平台接口返回参数表.21 DB52/T 1541.42021 II 前 言 本文件按照GB/T 1.1-2020标准化工作导则 第1部分:标准化文
3、件的结构和起草规则的规定起草。 本文件是DB52/T 1541的第4部分。DB52/T 1541已经发布一下部分: 第2部分:数据归集规范; 第3部分:数据存储规范; 第4部分:接口规范; 第6部分:面向全网搜索应用的数据处理规范。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本文件由贵州省大数据发展管理局提出并归口。 本文件起草单位:贵州省机械电子产品质量检验检测院、贵州中软云上数据技术服务有限公司、贵州省信息中心、贵州省量子信息和大数据应用技术研究院。 本文件主要起草人:朱小洪、宿睿智、刘彦嘉、王嘉卉、徐凯琳、田野、秦晓东、邵建平、 潘伟杰、韩朱旸、冯丹
4、妮、尚志刚、杨昶、李怡然、吴明娅、石睿、曾映菊、唐昶、张洋、姚茂峰、陆莹、孙瑾。 DB52/T 1541.42021 1 政务数据平台 第 4 部分:接口规范 1 范围 本文件规定了政务数据平台数据接口的术语和定义、缩略语、基本要求、接口组成、接口要求和接口安全。 本文件适用于政务数据平台接口的设计和应用。 2 规范性引用文件 本文件没有规范性引用文件。 3 术语和定义 下列术语和定义适用于本文件。 3.1 接口 interface 基于应用程序的服务能力封装成接口,并通过API网关开放给客户端调用。 3.2 数据 data 对事实、概念或指令的一种形式化表示,适用于以人工或自动方式进行通信、
5、解释或处理。 来源:DB52/T 1239.1-2017,3.1 3.3 政务数据资源目录 directory of government data resources 通过对政务数据资源依据规范的元数据描述,按照一定的分类方法进行排序和编码的一组信息,用以描述各个政务数据资源的特征,以便于对政务数据资源的检索、定位与获取。 3.4 政务数据提供方 government data provider 基于统一数据共享交换平台,利用各种技术向其他政务部门、事业单位、企业或公众提供政务数据的实体。 DB52/T 1541.4202123.5访问令牌access token访问控制操作主体的系统对象。
6、4缩略语下列缩略语适用于本文件。API:应用程序编程接口(Application Programming Interface)HTTP:超文本传输协议(Hyper Text Transfer Protocol)HTTPS:超文本传输安全协议(Hyper Text Transfer Protocol over SecureSocket Layer)JSON:轻量级的数据交换格式(Javascript Object Notation)REST:一种网络应用程序的设计风格和开发方式(Repersentational State Transfer)5基本要求5.1应采用 HTTP/HTTPS 作为传输
7、协议。5.2应采用 JSON 作为消息的封装格式。5.3应提供服务请求成功、失败等各种情况的接口返回状态码。5.4应支持跨语言、跨操作系统调用。6接口组成政务数据平台接口主要包括:认证授权服务接口、组织接口、用户接口、数据资源目录接口。政务数据平台接口组成见图1。图 1政务数据平台接口组成图DB52/T 1541.4202137接口要求7.1认证授权服务接口接口描述: 政务数据提供方接入政务数据平台应调用认证授权服务接口。 通过平台认证授权服务接口进行身份验证, 验证成功后接口返回的授权访问令牌, 政务数据提供方操作政务数据平台接口应携带访问令牌,进行正常会话交互。接口地址:/api/auth
8、_service。接口类型:post。请求参数:认证授权服务接口请求参数见表1。请求示例:见附录A。返回参数:见附录I 表I.1。返回示例:见附录H。表 1认证授权服务接口请求参数表参数名称类型是否必填说明access_keystring是政务数据平台分配给政务数据提供方的唯一标识access_secretstring是政务数据平台分配给政务数据提供方的密钥usernamestring是政务数据平台分配给政务数提供方的用户账户名称passwordstring是政务数据平台分配给政务数据提供方的用户账户密码7.2组织接口7.2.1组织新增接口接口描述:政务数据提供方调用政务数据平台组织新增接口,
9、获取政务数据平台返回的组织ID,根据组织ID进行政务数据提供方系统和政务数据平台交互。接口地址:/api/add/organization。接口类型:post。请求参数:同步组织机构请求参数见表2。请求示例:见附录B。返回参数:见附录I 表I.1。返回示例:见附录H。表 2同步组织机构请求参数表参数名称类型是否必填说明addTypeint是操作类型:1 表示新增trustNoint是统一社会信用代码groupShortNamestring是组织简称groupNamestring是组织名称regionNamestring是组织所属地区orgPostNoint是组织区划编号group_leveli
10、nt是级别:401 省直,402 市州super_orgint是父级组织编号DB52/T 1541.4202147.2.2组织编辑接口接口描述:编辑组织机构信息。接口地址:/api/add/organization。接口类型:post。请求参数:组织机构编辑请求参数见表3。请求示例:见附录B。返回参数:见附录I 表I.1。返回示例:见附录H。表 3组织机构编辑请求参数表参数名称类型是否必填说明addTypeint是操作类型:2 表示编辑trustNoint是统一社会信用代码groupShortNamestring是组织简称groupNamestring是组织名称regionNamestring
11、是组织所属地区orgPostNoint是组织区划编号group_levelint是级别:401 省直,402 市州super_orgint是父级组织编号7.2.3组织查询接口接口描述:政务数据提供方查询政务组织机构信息。接口地址:/api/organization/query。接口类型:get。请求参数:组织机构查询接口请求参数见表4。请求示例:http:/ip+port/api/organization/query?org_name=组织名称&org_id=z6lqTzG3PTPpQIE92Bs0pA3PSyVJmlWM。返回参数:见附录I 表I.1。返回示例:见附录H。表 4组织机构查询接
12、口请求参数表参数名称类型是否必填说明org_idstring是组织 idorg_namestring是组织名称7.3用户接口7.3.1用户新增接口接口描述:政务数据提供方调用用户新增接口,同步组织机构用户信息到政务数据平台。接口地址:/api/add/user。接口类型:post。请求参数:组织机构用户新增请求参数见表5。DB52/T 1541.420215请求示例:见附录C。返回参数:见附录I 表I.1。返回示例:见附录H。表 5组织机构用户新增请求参数表参数名称类型是否必填说明org_idstring是组织 idaddTypeint是操作类型:1 表示新增userNamestring是用户
13、名trueNamestring是用户真实姓名roIdsstring否用户角色mobilestring是联系电话7.3.2用户编辑接口接口描述:政务数据提供方编辑政务组织机构用户信息。接口地址:/api/add/user。接口类型:post。请求参数:组织机构用户编辑请求参数见表6。请求示例:见附录C。返回参数:见附录I 表I.1。返回示例:见附录H。表 6组织机构用户编辑请求参数表参数名称类型是否必填说明org_idstring是组织 idaddTypeint是操作类型:1 表示新增userNamestring是用户名trueNamestring是用户真实姓名roIdsstring是用户角色7
14、.3.3用户查询接口接口描述:政务数据提供方查询政务数据平台组织机构用户信息。接口地址:/api/query/user。接口类型:get。请求参数:用户查询见请求参数表7。请求示例:http:/ip+port/api/user/query?userId=z6lqTzG3PTPpQIE92Bs0pA3PSyVJmlWM。返回参数:见附录I 表I.1。返回示例:见附录H。表 7用户查询请求参数表参数名称类型是否必填说明userIdstring是用户 idDB52/T 1541.4202167.4数据资源目录接口7.4.1数据资源目录新增接口接口描述:政务数据提供方同步政务组织机构的数据资源目录信息
15、到政务数据平台。接口地址:/api/add/resource。接口类型:post请求参数:数据资源目录新增请求参数见表8。请求示例:见附录D。返回参数:见附录I 表I.1。返回示例:见附录H。表 8数据资源目录新增请求参数表参数名称类型是否必填说明idstring是数据资源目录 idindustryIdstring是行业 idorgIdstring是组织 idtopicIdstring是主题 iduserIdstring是用户 idaddTypeint是操作类型:1 表示新增apiDatajsonObject是接口信息描述见图 2,数据结构见附录 D、附录 EdirectoryjsonObje
16、ct是目录信息描述见图 3数据结构见附录 F、附录 Gindustrystring是行业openAttributeint是开放属性:1 有条件开放;2无条件开放;3不予开放serviceNamestring是服务名称shareAttributeint是共享属性:1有条件共享;2无条件共享;3不予共享topicstring是主题uniscidstring是统一社会信用代码DB52/T 1541.420217图 2接口信息描述组成结构图一町提到一一,翻_. 甜尴l曲阜-F叫时-剑.r圃票制.咀品ffl,.一一1一一.畸罔幅脑H血叫町.岛,-凰J町帽帽._.111喃喃阴晴电mg,制剧自-川P,u.睛
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB52T 1541.4-2021 政务数据平台 第4部分:接口规范贵州省 DB52 1541.4 2021 政务 数据 平台 部分 接口 规范 贵州省
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【曲****】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【曲****】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。