DB34_T 4083-2021 政府网站集约化平台应用接口规范-(高清现行).pdf
《DB34_T 4083-2021 政府网站集约化平台应用接口规范-(高清现行).pdf》由会员分享,可在线阅读,更多相关《DB34_T 4083-2021 政府网站集约化平台应用接口规范-(高清现行).pdf(46页珍藏版)》请在咨信网上搜索。
1、 ICS 35.240.99 CCS L 70 34 安徽省地方标准 DB34/T 40832021 政府网站集约化平台应用接口规范 Application interface specifications for the government website intensive platform 2021-12-28 发布 2022-01-28 实施安徽省市场监督管理局 发 布DB34/T 40832021 I 目次 前言.II 1 范围.1 2 规范性引用文件.1 3 术语、定义和缩略语.1 3.1 术语和定义.1 3.2 缩略语.1 4 基本要求.1 4.1 应用接入方.2 4.2 接口
2、提供方.2 4.3 平台运营方.2 5 接入流程.2 6 接口.2 6.1 应用场景.3 6.2 技术要求.3 6.3 API 接口说明.3 6.4 API 接口访问.3 6.5 清单.3 附录 A(资料性)应用接入申请表.34 附录 B(资料性)接入认证.35 B.1 认证说明.35 B.2 获取 Token.35 附录 C(资料性)返回状态码定义.37 附录 D(资料性)接口示例.38 D.1 信息新增接口.38 D.2 信息报送采用情况分页查询接口.38 D.3 信息详情查询接口.39 D.4 信息删除接口.39 附录 E(规范性)数据格式的字符定义.41 参考文献.42 DB34/T
3、40832021 II 前言 本文件按照 GB/T 1.12020标准化工作导则 第1部分:标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由安徽省人民政府网管理中心提出。本文件由安徽省信息技术标准化技术委员会(AH/TC 25)归口。本文件起草单位:安徽省人民政府网管理中心、合肥工业大学、六安市政府网站和新媒体中心、安徽省质量和标准化研究院、安徽龙讯信息科技有限公司。本文件主要起草人:陶松、郭亚光、寿志勤、贺良震、宋小娟、王玮、季静、姜东林、许君、朱守勇。DB34/T 40832021 1 政府网站集约化平台应用接口规范
4、1 范围 本文件规定了政府网站集约化平台应用接口的基本要求、接入流程、接口要求。本文件适用于政府网站集约化平台之间、政府网站集约平台与政府网站信息资源库及其他业务应用系统之间的数据共享交换。2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T 21062.3 政务信息资源交换体系 第3部分:数据接口规范 GB/T 40094.3 电子商务数据交易 第3部分:数据接口规范 DB34/T 3686 电子政务外网数据交换级联接口规范 3 术语
5、、定义和缩略语 3.1 术语和定义 下列术语和定义适用于本文件。3.1.1 应用接入方 application access unit 需要调用政府网站集约化平台应用接口的组织。3.1.2 接口提供方 supplier of interfaces 提供政府网站集约化平台应用接口的组织。3.1.3 平台运营方 operator of integrated platform forgovernment websites 为政府网站集约化平台应用接入提供技术服务支撑的组织。3.2 缩略语 下列缩略语适用于本文件。API:应用程序接口(Application Programming Interface
6、)URL:统一资源定位符(Uniform Resource Locator)JSON:JS 对象简谱/对象标记(JavaScriptObject Notation)4 基本要求 DB34/T 40832021 2 4.1 应用接入方 应满足以下要求:按需申请接入;按照本文件要求使用接口服务;协调所选取的业务应用系统及服务提供方与政府网站集约化平台运营方的对接工作。4.2 接口提供方 应满足以下要求:确保开放的接口不影响平台的正常运转;对业务应用系统及服务的接入制定相应的安全策略,并确保正常执行;对业务应用系统及服务的接入进行审批和管理;协调政府网站集约化平台运营方安排专人负责接入应用的日常管理
7、。4.3 平台运营方 应满足以下要求:按照 GB/T 21062.3、GB/T 40094.3、DB34/T 3686 等的要求定义及开发接口;负责应用接口的维护更新与缺陷修正,并为应用接入方提供技术支持。5 接入流程 应用接入流程见图1。应用接入方接口提供方平台运营方对接需求及安全评估接入申请接入审核接入认证开始结束授权凭证反馈接口开通授权 图1 接入流程 注1:应用接入方在提交申请表前应开展对接需求及安全评估,并按照附录A 中的表A.1 要求提交接入申请。注2:接口提供方对应用接入方提交的申请进行审核。审核通过后,通知平台运营方开通授权。注3:平台运营方负责开通授权,将授权凭证(用户名、密
8、码)返回至接入方并配合完成认证工作。注4:应用接入方根据授权凭证,完成接入认证,接入认证的详细说明见附录B。6 接口 DB34/T 40832021 3 6.1 应用场景 集约化平台应用接口应包括但不限于以下应用场景:省级、市级政府网站集约化平台之间的数据共享交换业务,包括重要转载、信息报送、网站工作年报、网站监管年报、绩效考核等。集约化平台与政府网站信息资源库及其他业务应用系统之间的数据共享交换业务,包括政府网站信息发布、留言办理回复、栏目及目录查询、单点登录等。6.2 技术要求 应采用基于 HTTP(超文本传输协议)/HTTPS(超文本传输安全协议)的 API 接口方式进行数据共享交换。6
9、.3 API 接口说明 API接口说明应包含但不限于:a)接口名称:接口功能的简要和概况性描述。示例1:获取 Token。b)功能描述:接口的功能性描述。示例2:用于获取 Token,每次调用集约化平台应用接口时都要先获取 Token。c)接口地址:接口的调用地址。示例3:http:/ip:port/oauth/token。d)请求方式:对数据进行操作采用的类型,可采用 GET 或 POST 等方式。示例4:http GET。e)请求参数(请求消息字段说明):访问接口时必要的或可选的参数,说明字段名称、类型、约束、描述说明;其中,必要参数应给出调用 API 所需的唯一身份令牌(Token)。示
10、例5:见附录 B 表 B.2 的“请求参数”。f)请求示例:请求数据的接口地址示例说明。示例6:http:/ip:port/oauth/token?client_id=分配给您的用户名&client_secret=分配给您的密码。g)返回结果:请求数据后,系统返回的请求结果。返回结果采用 JSON 格式。示例7:见附录 B 表 B.2 的“返回结果示例”。h)返回结果字段说明(返回消息字段说明):返回结果中数据信息的字段说明,包括但不限于字段名称、类型、描述说明等。示例8:见附录 B 表 B.2 的“返回结果字段”。i)返回状态码:请求数据后,返回的状态代码。示例9:见附录 C 表 C.1。6
11、.4 API 接口访问 应用接入方应通过政府网站集约化平台运营方分配的用户名和密码获取身份令牌(Token)后,利用身份令牌(Token)和应用接口请求参数进行业务接口访问。Token 获取方式见附录B 中的表B.2。6.5 清单 6.5.1 重要转载 DB34/T 40832021 4 6.5.1.1 重要转载信息 功能描述:用于转载上级政府网站的重要信息。请求消息字段见表1。返回消息字段见表2。表1 重要转载信息请求消息字段 字段名 类型 约束 说明 type String 选填 转载类型 表2 重要转载信息返回消息字段 字段名 类型 说明 status Integer 返回状态码,见附录
12、 C 中表 C.1 的定义 id Long 文章 id title String 标题 imageLink String 缩略图地址 resources String 来源 url String 访问地址 publishDate String 发布时间 content String 文章内容 remark String 简介 desc String 描述信息 6.5.1.2 重要转载信息点击量上报 功能描述:用于下级政府网站上报转载信息的点击量。请求消息字段见表3。返回消息字段见表4。表3 重要转载信息点击量上报请求消息字段 字段名 类型 约束 说明 id Long 必填 信息 ID hit
13、Long 必填 点击量 表4 重要转载信息点击量上报返回消息字段 字段名 类型 说明 status Integer 返回状态码,见附录 C 中表 C.1 的定义 desc String 描述信息 6.5.2 信息报送 6.5.2.1 信息报送 功能描述:用于市级平台向省级平台报送信息。DB34/T 40832021 5 请求消息字段见表5。返回消息字段见表6。表5 信息报送接口请求消息字段 字段名 类型 约束 说明 uid String 必填 信息报送系统用户名,数据格式要求:A1.20(字符含义见附录 E中表 E.1 的定义)title String 必填 标题,数据格式要求:A1.100(
14、字符含义见附录 E 中表 E.1 的定义)author String 必填 作者,数据格式要求:A1.30(字符含义见附录 E 中表 E.1 的定义)addDate Date 可选 添加日期,默认当前日期,数据格式要求:D8+T6(字符含义见附录E 中表 E.1 的定义)classify Integer 可选 报送分类(0:网站信息,1:解读材料,默认网站信息)infoModel Integer 可选 信息分类(0:中文信息,1:英文信息,默认中文信息)reporterName String 必填 报送人姓名,数据格式要求:A1.30(字符含义见附录 E 中表 E.1的定义)reporterP
15、hone String 必填 报送人手机号,N11(字符含义见附录 E 中表 E.1 的定义)content String 必填 信息内容 表6 信息报送接口返回消息字段 字段名 类型 说明 status Integer 返回状态码,见附录 C 中表 C.1 的定义 id Integer 信息主键 id desc String 描述信息 注:信息新增的接口示例参见附录D 中 D.1。6.5.2.2 信息报送采用情况分页查询 功能描述:用于市级平台查询报送信息的采用情况。请求消息字段见表7。返回消息字段见表8。表7 信息报送采用情况分页查询接口请求消息字段 字段名 类型 约束 说明 uid St
16、ring 必填 信息报送系统用户名,数据格式要求:A1.20(字符含义见附录 E中表 E.1 的定义)id Integer 可选 信息报送返回的主键 id,数据格式要求:A.20(字符含义见附录 E中表 E.1 的定义)name String 可选 标题,数据格式要求:A.100(字符含义见附录 E 中表 E.1 的定义)submitUserName String 必填 报送人姓名,数据格式要求:A1.30(字符含义见附录 E 中表 E.1的定义)startDate Date 可选 报送日期的开始时间,数据格式要求:D8+T6(字符含义见附录 E 中表 E.1 的定义)DB34/T 40832
17、021 6 endDate Date 可选 报送日期的结束时间,数据格式要求:D8+T6(字符含义见附录 E 中表 E.1 的定义)useStatus Integer 可选 采用状态(0:未采用,1:已采用,3:已退回)pageIndex Integer 可选 页码开始,默认从 0 开始 pageSize Integer 可选 一页数据条数 表8 信息报送采用情况分页查询接口返回消息字段 字段名 类型 说明 status Integer 返回状态码,见附录 C 中表 C.1 的定义 id Integer 信息 ID name String 信息标题 useStatus Integer 采用状态
18、(0:未采用,1:已采用,3:已退回)useDate Date 采用时间 desc String 描述信息 注:采用情况查询接口示例参见附录D 中 D.2 6.5.3 网站工作年报 6.5.3.1 应报数量查询 功能描述:用于市级平台获取政府网站工作年报应报数量。请求消息字段见表9。返回消息字段见表10。表9 应报数量查询接口请求消息字段 字段名类型约束说明year String 必填 年份,数据格式要求:D4(字符含义见附录 E 中表 E.1 的定义)creditCode String 必填 省市平台对接组织编码 表10 应报数量查询接口返回消息字段 字段名 类型 说明 status Int
19、eger 返回状态码,见附录 C 中表 C.1 的定义 data Integer 返回数据,应报数量 desc String 描述信息 6.5.3.2 填报数量推送 功能描述:用于市级平台向省级平台推送本年度已填报且审核通过的网站工作年报数量。请求消息字段见表11。返回消息字段见表12。DB34/T 40832021 7 表11 填报数量推送接口请求消息字段 字段名 类型 约束 说明 jsonArray year String 必填 年份,数据格式要求:D4(字符含义见附录 E 中表 E.1 的定义)creditCode String 必填 省市平台对接组织编码 count Integer 必
20、填 网站工作年报数量 表12 填报数量推送接口返回消息字段 字段名 类型 说明 status Integer 返回状态码,见附录 C 中表 C.1 的定义 desc String 描述信息 6.5.3.3 上报 功能描述:用于市级平台向省级平台上报网站工作年报数据。请求消息字段见表13。返回消息字段见表14。表13 网站工作年报上报接口请求消息字段 字段名 类型 约束 说明 year String 必填 年份,数据格式要求:D4(字符含义见附录 E 中表 E.1 的定义)creditCode String 必填 省市平台对接组织编码 reportGovYearDataArray reportU
21、nitCreditCode String 必填 填报单位的省市平台对接组织编码 siteName String 必填 网站名称,数据格式要求:A1.50(字符含义见附录 E 中表E.1 的定义)indexWebsite String 必填 首页网址,数据格式要求:A1.100(字符含义见附录 E 中表E.1 的定义)hostUnit String 必填 主办单位,数据格式要求:A1.50(字符含义见附录 E 中表E.1 的定义)websiteType Integer 必填 网站类型,1:政府门户网站 2:部门网站 3:专项网站 siteCode String 必填 政府网站标识码,数据格式要求
22、:A1.30(字符含义见附录 E中表 E.1 的定义)siteICP String 必填 ICP 备案号,数据格式要求:A1.30(字符含义见附录 E 中表E.1 的定义)siteGajgbah String 必填 公安机关备案号,数据格式要求:A1.30(字符含义见附录 E中表 E.1 的定义)reportDate Date 必填 填报日期,数据格式要求:A1.30(字符含义见附录 E 中表E.1 的定义)uv Long 必填 独立用户访问总量(单位:个)pv Long 必填 网站总访问量(单位:次)DB34/T 40832021 8 totalPublishCount Integer 必填
23、 总的信息发布数 glPublishCount Integer 必填 概况类信息更新量 zwdtPublishCount Integer 必填 政务动态信息更新量 xxgkPublishCount Integer 必填 信息公开目录信息更新量 ztzlCount Integer 选填 专题专栏维护数 newZtzlCount Integer 选填 新开设专题专栏数 jdhyCount Integer 选填 解读回应总数 jdclCount Integer 选填 解读材料数量 jdcpCount Integer 选填 解读产品数量 mtplCount Integer 选填 媒体评论文章数量 rd
24、gzOrZdyqCount Integer 选填 回应公众关注热点或重大舆情数量 isPublishServiceCatalog Boolean 必填 是否发布服务事项目录(false:否,true:是)regUserCount Integer 选填 注册用户数 serviceCount Integer 选填 政务服务事项数量 qcblServiceCount Integer 选填 可全程在线办理政务服务事项数量 handleCount Integer 选填 办件总量 personHandleCount Integer 选填 自然人办件量 juridicalPersonHandleCount
25、Integer 选填 法人办件量 isUseUnitePlatform Boolean 必填 是否使用统一平台(false:否,true:是)messageRecieveCount Integer 必填 留言受理数 messageDoneCount Integer 必填 留言办结数 aveProTime Float 必填 平均办结时间(单位:天)publicReplyCount Integer 必填 公开答复数量 surveyCount Integer 必填 征集调查期数 suggestionCount Integer 必填 收到意见数量 findingsCount Integer 必填 公布
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB34_T 4083-2021 政府网站集约化平台应用接口规范-高清现行 4083 2021 政府 网站 集约化 平台 应用 接口 规范 现行
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【Fis****915】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【Fis****915】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。