(高清正版）DB42T1865.4-2022政府网站集约化建设规范 第4部分：数据交换.pdf

ICS 35.020CCS L 70DB42湖北省地方标准DB42/T 1865.42022政府网站集约化建设规范第 4 部分：数据交换Specification for intensive construction of government websitesPart4：Data exchange2022-04-25 发布2022-06-25 实施湖北省市场监督管理局发 布DB42/T 1865.42022I目次前言.III1范围.12规范性引用文件.13术语和定义.14数据交换.15数据交换管理.2附录 A（资料性）接口调用示例.4参考文献.14DB42/T 1865.42022III前言本文件按照GB/T 1.1-2020标准化工作导则 第1部分：标准化文件的结构和起草规则的规定起草。本文件是DB42/T 1865政府网站集约化建设规范的第4部分。DB42/T 1865已发布了以下部分：第1部分：平台建设；第2部分：网站建设；第3部分：信息资源；第4部分：数据交换；第5部分：系统安全；第6部分：运维管理。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由湖北省政务管理办公室提出并归口。本文件起草单位：湖北省大数据中心、湖北省标准化与质量研究院、湖北日报传媒集团、拓尔思信息技术股份有限公司。本文件主要起草人：江艳玲、顾鑫、曹磊、詹俊斌、麦清涛、周硙、涂俊、肖诗荣、彭成明、饶飘雪、冯金平。本文件实施应用中的疑问，可咨询湖北省政务管理办公室，联系电话：[phone]，邮箱：；对本标准的有关修改意见建议，请反馈至湖北省大数据中心，联系电话：[phone]，邮箱：。DB42/T 1865.42022V引言随着大数据、云计算等新兴技术和理念的发展，大数据思维和应用已经开始逐渐渗透到公共管理和政府治理范畴内，改变了政府信息的收集、加工、存储、传递、反馈和利用的过程管理方式。为进一步加强政府网站管理，引领各级政府网站创新发展，2017年5月，国务院办公厅印发的政府网站发展指引中明确要求“要通过统一标准体系、统一技术平台、统一安全防护、统一运维监管，集中管理信息数据，集中提供内容服务，实现政府网站资源优化融合、平台整合安全、数据互认共享、管理统筹规范、服务便捷高效”。政府网站集约化标准普遍适用于政府网站安全、建设和组织管理工作，拟由六部分构成。第1部分：平台建设。用于省政务管理办公室对政府网站集约化平台建设按照统一规范要求全面开展集约化工作，包括平台构成、集约模式、技术要求、平台功能、平台安全和平台指标。第2部分：网站建设。用于省政务管理办公室对政府网站集约化建设包括政府门户网站和部门网站在内的在互联网上开办具有信息发布、解读回应、办事服务、互动交流等网站功能。第3部分：信息资源。适用于湖北省、市州各级政府部门开展政府网站及部门网站的建设提供了建设和管理。第4部分：数据交换。适用于对我省政府网站集约化数据进行技术层面上的规范管理，厘清数据共享交换层级、流转路径和交换方式等相关要求。第5部分：系统安全。适用于从标准制定、系统架构、云服务管理模式、用户体验创新以及配套支撑等方面进行了全面探索和创新。第6部分：运维管理。目的在于规定了湖北省政府网站集约化运维管理组织、运维内容、第三方机构管理和监督考核。DB42/T 1865.420221政府网站集约化建设规范第 4 部分：数据交换1范围本文件规定了湖北省、市（州）政府网站信息资源数据交换，交换管理的模式和数据交换规范。本文件适用于湖北省、市（州）政府网站信息资源数据交换相关工作。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。DB42/T 1865.3政府网站集约化建设规范 第3部分：信息资源3术语和定义下列术语和定义适用于本文件。3.1数据交换data exchange信息资源在互相联网的两个或两个以上不同计算机系统之间发送、传输、接收的过程。3.2共享平台sharing platform湖北省政务信息资源共享平台。4数据交换4.1数据交换内容用于交换的数据应符合 DB42/T 1865.3 第 7 章要求，交换内容包括但不限于：a）信息发布；b）信息公开；c）解读回应；d）领导信箱；e）咨询投诉；f）在线访谈；g)问卷调查；h)意见征集；i）办事服务；DB42/T 1865.420222j）结果公示。4.2数据交换方式省、市政府网站信息资源库（以下简称“信息资源库”）应分级管理，按照图 1 模式，省、市之间通过各级网站信息资源库进行交换，省级资源库和全省“政务一张网”通过共享平台进行数据交换。应根据数据交换数量、频次、实时性等要求选择合适的交换方式，交换方式包括：a)库表交换：数据更新频度快、交换频度较高、数据量较大的情况，采用库表交换方式；b)服务接口：少量数据查询、数据核查验证、高实时性数据的情况，采用服务接口方式。图 1交换模式图5数据交换管理5.1总体要求总体要求包括：a）资源提供方应及时维护和更新信息，保障数据的完整性、准确性、时效性和可用性，并按照交换格式要求进行封装；b）资源需求方应按照共享平台流程要求获取相应数据资源，并标记数据来源，不可对源数据进行修改。5.2数据提供数据提供内容包括：a）省级资源库建设方应提供数据目录，形成交换数据和服务接口，通过共享平台将服务接口注册发布到对应的信息资源目录项；DB42/T 1865.420223b）省级资源库建设方应以文档形式提供省、市间资源数据和服务的接口规范，内容包括接口概述、接口访问限制、接口参数说明、接口调用实例等，服务接口类型应选用 HTTP GET/POST 或 WebService，接口参数数据应使用 UTF-8 编码格式，接口数据应采用 XML 或 JSON 格式。示例见附录 A；c）市级信息资源库建设方应按照省级资源库提供的接口规范推送相关数据。5.3数据申请数据申请内容包括：a）市级资源库向省级资源库申请使用数据应通过省级资源库提供的数据目录查找所需信息资源分类，申请获取对应分类的授权，通过省级资源库提供的数据和服务接口，完成数据获取；b）省级资源库向共享平台申请使用数据应通过共享平台查找所需数据目录项，申请获取对应的服务接口，完成数据获取。DB42/T 1865.420224附录A（资料性）接口调用示例表A.1表A.6给出了接口调用示例。表 A.1申请令牌接口调用示例接口请求参数：接口请求参数：名称名称类型类型必填必填说明说明client_id字符串(string)是客户端标识符。对应资源库，系统配置-应用详情：APIKeyclient_secret字符串(string)是客户端密钥。对应资源库，系统配置-应用详情：SecretKeygrent_type字符串(string)是访问许可类型。资源库只采用 client_credentials（客户端授权模式）返回数据参数：返回数据参数：名称名称类型类型说明说明code数值（int）返回码msg字符串（string）返回说明success布尔型（boolean）返回状态（成功 true，失败 false）expiresIn字符串（string）超时时间，单位 svalue字符串（string）token，默认失效时间 120 分钟（可在资源库设置）。失效则重新调用当前接口JSON 返回示例：msg:操作成功,code:200,data:expiresIn:7169,tokenType:bearer,value:9c6d54e4-7087-4993-9864-f9889b867820,success:true状态码：状态码：状态码状态码状态码类型状态码类型状态码说明状态码说明200系统响应成功状态码请求已经成功处理401系统级状态码没有被授权或者授权已经失效500系统级状态码服务器内部错误501系统级状态码服务器不支持当前请求的部分功能502系统级状态码响应无效503系统级状态码服务器维护或者过载，拒绝服务504系统级状态码上游服务器超时505系统级状态码不支持的 HTTP 版本506系统级状态码服务器内部配置错误507系统级状态码服务器无法完成存储请求所需的内容508系统级状态码服务器处理请求时发现死循环509系统级状态码服务器达到带宽限制510系统级状态码获取资源所需的策略没有被满足DB42/T 1865.420225表 A.1申请令牌接口调用示例（续）511系统级状态码需要进行网络授权4006系统级状态码获取 Token 失败4007系统级错误码身份验证失败DB42/T 1865.420226表 A.2获取标准接口调用示例接口请求参数：接口请求参数：名称名称类型类型必填必填说明说明access_token字符串(string)是token返回数据参数：返回数据参数：名称名称类型类型说明说明code数值（int）返回码msg字符串（string）返回说明success布尔型（boolean）返回状态（成功 true，失败 false）id长整数（long）标准 IDname字符串（string）标准名称JSON 返回示例：msg:操作成功,code:200,data:name:资源库标准,id:5089,name:TRS 资源库标准,id:1241,success:true状态码：状态码：错误码错误码错误码类型错误码类型错误码说明错误码说明200代理接口错误码请求已经成功处理401系统级错误码没有被授权或者授权已经失效1000系统级错误码系统错误4000系统级错误码没有被授权或者授权令牌无效4006系统级错误码获取 Token 失败4007系统级错误码身份验证失败DB42/T 1865.420227表 A.3新增资源数据接口调用示例接口请求参数：接口请求参数：名称名称类型类型必填必填说明说明access_token字符串(string)是tokentableName字符串(string)是第三方表名。第三方表名在映射配置中与资源库的资源表名进行了映射，因此数据会推送到当前第三方表映射了的资源下categories字符串(string)是CMS 分类 ID 信息，CHANNELID：栏目 ID，DEPTID：组织、机构 ID，CUSTOMKEY1:自定义数据表表英文名（需要严格区分大小写）。示例：CHANNELID:1,2,3,DEPTID:1,2,3,CUSTOMKEY1:1,2,3DataJSON 字符串（json）是新增资源数据 JSON 字符串appId长整数（long）是应用 IDappHost字符串(string)否第三方域名或 IPPush数值（int）是是否上报。1-是，0-否distribution数值（int）是是否下达。1-是，0-否userName字符串(string)是当前用户的用户名dataSourcesUrl字符串(string)是数据来源 URLId长整数（long是数据 IDsiteId字符串(string)是站点 ID返回数据参数：返回数据参数：名称名称类型类型说明说明code数值（int）返回码msg字符串（string）返回说明success布尔型（boolean）返回状态（成功 true，失败 false）dataId长整数（long）数据 IDJSON 返回示例：code:200,data:1494762,msg:操作成功,success:true状态码：状态码：错误码错误码错误码类型错误码类型错误码说明错误码说明200代理接口错误码请求已经成功处理401系统级错误码没有被授权或者授权已经失效1000系统级错误码系统错误1001系统级错误码远程服务错误1002系统级错误码参数错误，请参考 API 文档1003系统级错误码资源新增失败1004系统级错误码资源更新失败1005系统级错误码资源查询失败1006系统级错误码资源删除失败1007系统级错误码输入文字太长，请确认不超过 140 个字符1008系统级错误码输入文字太长，请确认不超过 200 个字符1009系统级错误码图片太大1010系统级错误码文件太大2000系统级错误码无效标准2001系统级错误码无效分类3000系统级错误码待查应用不存在3001系统级错误码应用已经存在DB42/T 1865.420228表 A.3 新增资源数据接口调用示例（续）3002系统级错误码应用名不可用。应用名由数字、26 个英文字母或下划线组成，长度不超过 30 位3003系统级错误码应用下已绑定数据源，请先删除关联数据源4002系统级错误码Token 已经过期4003系统级错误码Token 不合法4004系统级错误码资源操作权限受限4005系统级错误码缺少 appkey 参数4006系统级错误码获取 Token 失败4007系统级错误码身份验证失败DB42/T 1865.420229表 A.4 获取资源和分类下数据列表接口调用示例接口请求参数：接口请求参数：名称名称类型类型必填必填说明说明access_token字符串(string)是tokenstandardId长整数（long）是标准 IDcategoryId长整数（long）是分类 ID（0 代表全部）resourceId长整数（long）是资源 IDcategoryIds字符串(string)是接口路径中未传入分类 ID 时，才可以选填granularity字符串(string)否时间粒度（创建时间）：ALL-全部LAST_DAY-一天之内LAST_MONTH-一月之内LAST_YEAR-一年之内CUSTOM-自定义beginDateTime长整数（long）否自定义开始时间（创建时间）endDateTime长整数（long）否自定义结束时间（创建时间）pageIndex数值（int）是当前页pageSize数值（int）是页面大小searchText字符串(string)否索关键字返回数据参数：返回数据参数：名称名称类型类型说明说明code数值（int）返回码msg字符串（string）返回说明success布尔型（boolean）返回状态（成功 true，失败 false）id长整数（long）数据 IDstandardId长整数（long）标准 IDresourceId长整数（long）资源 IDtitle字符串（string）标题createTime时间戳（timestamp）创建时间DB42/T 1865.4202210表 A.4 获取资源和分类下数据列表接口调用示例（续）JSON 返回示例：msg:操作成功,code:200,data:data:resourceId:1,createTime:1550672692000,standardId:1241,id:10,title:文章标题 1,resourceId:1,createTime:1550672692000,standardId:1241,id:11,title:文章标题 2,pager:pageCount:10,currPage:1,pageSize:20,itemCount:525,success:true状态码：状态码：错误码错误码错误码类型错误码类型错误码说明错误码说明200代理接口错误码请求已经成功处理401系统级错误码没有被授权或者授权已经失效1000系统级错误码系统错误1001系统级错误码远程服务错误1002系统级错误码参数错误，请参考 API 文档1003系统级错误码资源新增失败1004系统级错误码资源更新失败1005系统级错误码资源查询失败1006系统级错误码资源删除失败1007系统级错误码输入文字太长，请确认不超过 140 个字符1008系统级错误码输入文字太长，请确认不超过 200 个字符1009系统级错误码图片太大1010系统级错误码文件太大2000系统级错误码无效标准2001系统级错误码无效分类3000系统级错误码待查应用不存在3001系统级错误码应用已经存在3002系统级错误码应用名不可用。应用名由数字、26 个英文字母或下划线组成，长度不超过 30 位DB42/T 1865.4202211表 A.4 获取资源和分类下数据列表接口调用示例（续）3003系统级错误码应用下已绑定数据源，请先删除关联数据源4002系统级错误码Token 已经过期4003系统级错误码Token 不合法4004系统级错误码资源操作权限受限4005系统级错误码缺少 appkey 参数4006系统级错误码获取 Token 失败4007系统级错误码身份验证失败DB42/T 1865.4202212表 A.5 撤资源库稿件接口调用示例接口请求参数：接口请求参数：名称名称类型类型必填必填说明说明access_token字符串(string)是token 码standardId长整数（long）是标准 IDresourceId长整数（long）是资源 IDappId长整数（long）是应用 IDdataIds长整数（long）是资源数据 idsversionsString否多个以英文逗号隔开，不填默认为原稿返回数据参数：返回数据参数：名称名称类型类型说明说明code数值（int）返回码msg字符串（string）返回说明success布尔型（boolean）返回状态（成功 true，失败 false）data字符串（string）nullJSON 返回示例：msg:操作成功,code:200,data:null,success:true状态码：状态码：错误码错误码错误码类型错误码类型错误码说明错误码说明200代理接口错误码请求已经成功处理401系统级错误码没有被授权或者授权已经失效1000系统级错误码系统错误1001系统级错误码远程服务错误1002系统级错误码参数错误，请参考 API 文档1003系统级错误码资源新增失败1004系统级错误码资源更新失败1005系统级错误码资源查询失败1006系统级错误码资源删除失败1007系统级错误码输入文字太长，请确认不超过 140 个字符1008系统级错误码输入文字太长，请确认不超过 200 个字符1009系统级错误码图片太大1010系统级错误码文件太大2000系统级错误码无效标准2001系统级错误码无效分类3000系统级错误码待查应用不存在3001系统级错误码应用已经存在3002系统级错误码应用名不可用。应用名由数字、26 个英文字母或下划线组成，长度不超过 30 位3003系统级错误码应用下已绑定数据源，请先删除关联数据源4002系统级错误码Token 已经过期4003系统级错误码Token 不合法4004系统级错误码资源操作权限受限4005系统级错误码缺少 appkey 参数4006系统级错误码获取 Token 失败4007系统级错误码身份验证失败DB42/T 1865.4202213表 A.6 上报、下达接口调用示例消息属性：消息属性：字段字段说明说明虚拟主机gov消息类型topic交换机（exchange）uirb_push消息内容：消息内容：字段字段说明说明standardId标准 IDresourceId资源 IDdataId数据 IDhasRightAppId有权限的、可以访问该数据所在标准或资源的第三方系统的 APPIDversionNum数据版本fromAppId数据来源的第三方系统 APPID消息示例：hasRightAppId:1,2,3,resourceId:1,dataId:1,fromAppId:2,versionNum:1,standardId:1DB42/T 1865.4202214参考文献1国家数据共享交换平台（政务外网）服务接口申请、授权和使用管理暂行办法2政务信息资源共享管理暂行办法（国发201651号）3政府网站集约化试点工作方案（国办函201871号）_