目录国家网络目录数据库
国家网络目录数据库 时间:2021-04-18 阅读:()
国家数据共享交换平台(政务外网)省级目录系统对接技术方案国家电子政务外网管理中心二〇一七年十一月2目录第一章背景.
5第二章对接设计流程.
6第三章接口访问流程.
8第四章接口标准.
94.
1接口地址(测试地址)94.
2接口地址(正式地址)104.
3接口描述.
124.
3.
1接口调用流程.
124.
3.
2信息校验.
124.
3.
3接口授权.
134.
3.
4目录资源分类.
154.
3.
5数据目录.
214.
4Schema定义.
314.
4.
1Catalog_Schema314.
4.
2CatalogColumn_Schema.
344.
4.
3CatalogGroup_Schema344.
5返回码定义.
354.
5.
1返回码规则.
354.
5.
2返回值定义.
354.
6接口数据字典.
374.
6.
1信息资源提供方.
374.
6.
2信息资源格式分类.
414.
6.
3信息资源格式类型(与信息资源格式分类为父子关系)414.
6.
4数据类型.
434.
6.
5共享类型.
444.
6.
6共享方式分类.
444.
6.
7共享方式类型.
4434.
6.
8更新周期.
444.
6.
9数据目录状态.
454.
7数据字典补充说明.
45第五章省平台对接工作事项.
464文档变更说明版本类型日期说明V0.
1新增2017-10-25新增目录系统对接方案V0.
2修改2017-10-261、更新了接口地址【测试用地址】,将原地址http://59.
255.
104.
52/interface/service.
htm及http://59.
255.
104.
52/interface/catalog.
htm统一修改为http://59.
255.
104.
52/interface/service.
do;2、补充授权接口传入的参数optype,并将传入参数封装为jsonStr3、统一所有接口中传入参数token名称为access_tokenV0.
3修改2017-10-301、增加参数错误返回码005-信息已存在2、增加业务错误返回码005-没有对应信息V0.
4修改2017-11-021、修改数据资源目录是否已存方法的返回示例中resultdata的显示值显示为0或1;2、修改Catalog_Schema中传入字段columnslist修改为columnlistV0.
5修改2017-11-061、增加了groupid和catacode字段备注2、去掉CatalogColumn_Schema中必填access_token字段.
V0.
5修改2017-11-131、修改Catalog_Schema中传入字段,增加必填字段目录状态status及描述2、新增数据目录状态变更的方法updateCatalogStatus3、新增目录资源分类的新增,修改,删除方法VO.
6修改2017-11-161、新增数据目录查询接口返回国家平台目录id5第一章背景按照《国务院办公厅关于印发政务信息系统整合共享实施方案的通知》(国办发〔2017〕39号)、《国务院关于印发政务信息资源共享管理暂行办法的通知》(国发〔2016〕51号)等文件精神,为促进政务信息资源共享交换,规范省级数据共享交换平台(以下简称"省平台")与国家数据共享交换平台(外网)(以下简称"国家平台")政务信息资源目录对接,实现省平台与国家平台的目录信息实时同步制定本方案.
本方案主要用于省平台目录系统与国家平台目录系统对接,规范省平台政务资源目录与国家平台政务资源目录的实时同步工作.
6第二章对接设计流程省平台目录系统通过调用国家平台目录系统提供的服务接口,实现本地区政务信息资源目录的上报、修改和删除.
省平台目录系统与国家平台目录系统对接流程国家平台目录系统省平台目录系统开始结束目录创建目录审批未通过调用国家平台接口通过获取数据请求目录格式校验授权校验权限校验目录格式校验通过处理数据目录资源库审核日志获取返回结果通过通过返回出来结果校验不成功,返回错误码无权限操作,返回错误码校验不成功,返回错误码一、省平台目录系统1、省平台目录系统接入国家平台目录系统,上报的目录数据必须通过省平台目录系统的审核和目录格式校验校验.
72、省平台目录系统调用国家平台目录系统前,给国家平台目录系统提供调用方名称、联系人、联系电话、请求来源IP信息,由国家平台目录系统分配platkey和platsecret,通过调用授权密钥获取接口,获取或重置授权密钥.
3、接口调用方获取到授权密钥后,调用数据目录相关接口查询时,授权密钥、请求来源IP对数据请求权限进行双重权限验证,如不符合权限要求,系统不予放行并返回错误码信息.
4、省平台目录系统调用国家平台目录系统服务接口时,提报的政务信息资源目录数据必须按照本文4.
4、4.
6章节中的对数据格式和数据字典内容得要求填写.
二、国家平台目录系统1、根据请求方提供资料,生成platkey和platsecret并反馈给省平台目录系统.
2、接口调用时,国家平台目录系统负责完成调用授权校验、权限校验和数据目录格式校核工作,符合要求的数据,汇总至国家平台目录系统,否则返回错误信息至接口调用方.
3、国家平台目录系统,对接口请求过程进行监控和日志审计,保证接口的安全性和可追溯性.
8第三章接口访问流程省平台调用国家平台目录系统服务接口时,通过国家平台目录系统分配的接口账号、接口密钥调用接口申请访问令牌token;通过申请到的token进行业务接口访问.
9第四章接口标准省平台目录系统与国家平台目录系统采用API接口的方式实现对接和数据同步.
4.
1接口地址(测试地址)对接密钥获取地址http://59.
255.
104.
52/interface/service.
domethod=GetResourcePlatToken目录资源分类获取http://59.
255.
104.
52/interface/service.
domethod=GetCatalogGroupReq目录资源分类创建http://59.
255.
104.
52/interface/service.
domethod=CreateCataLogGroup目录资源分类修改http://59.
255.
104.
52/interface/service.
domethod=UpdateCataLogGroup目录资源分类删除http://59.
255.
104.
52/interface/service.
domethod=DeleteCataLogGroup10数据资源目录是否已存在http://59.
255.
104.
52/interface/service.
domethod=IseCataLogHasReq数据资源目录创建http://59.
255.
104.
52/interface/service.
domethod=CreateCataLogReq数据资源目录修改http://59.
255.
104.
52/interface/service.
domethod=UpdateCataLogReq数据资源目录删除http://59.
255.
104.
52/interface/service.
domethod=DeleteCataLogReq数据资源状态变更http://59.
255.
104.
52/interface/service.
domethod=UpdateCatalogStatus4.
2接口地址(正式地址)对接密钥获取地址http://data.
cegn.
cn/interface/service.
domethod=GetResourcePlatToken11目录资源分类获取http://data.
cegn.
cn/interface/service.
domethod=GetCatalogGroupReq目录资源分类创建http://data.
cegn.
cn/interface/service.
domethod=CreateCataLogGroup目录资源分类修改http://data.
cegn.
cn/interface/service.
domethod=UpdateCataLogGroup目录资源分类删除http://data.
cegn.
cn/interface/service.
domethod=DeleteCataLogGroup数据资源目录是否已存在http://data.
cegn.
cn/interface/service.
domethod=IseCataLogHasReq数据资源目录创建http://data.
cegn.
cn/interface/service.
domethod=CreateCataLogReq数据资源目录修改http://data.
cegn.
cn/interface/service.
domethod=UpdateCataLogReq12数据资源目录删除http://data.
cegn.
cn/interface/service.
domethod=DeleteCataLogReq数据资源状态变更http://data.
cegn.
cn/interface/service.
domethod=UpdateCatalogStatus4.
3接口描述4.
3.
1接口调用流程4.
3.
2信息校验4.
3.
2.
1授权校验省平台发起调用服务申请,国家平台对发起申请调用的省平台进行权限验证,判断是否具有调用接口服务的相应权限,若没有相应的权限,则返回相应的错误码.
4.
3.
2.
2权限校验省平台通过授权验证后,在调用相应的接口前,国家平台会对省平台进行相应的权限验证,如果没有相应的获取及修13改权限,则返回相应的错误码.
4.
3.
2.
3省平台信息数据校验省平台须先调用信息校核工具(校核工具包含java和.
net两个版本,详情请参考"国家数据共享交换平台(外网)校核工具包说明文档"),对准备传输到国家平台的数据进行相应的校验,包括目录信息格式校验和信息字典项项校验.
若校验成功,则可调用国家平台服务接口,若校验不成功,省平台需按要求做相应的修改.
4.
3.
2.
4国家平台信息校验省平台通过调用接口服务将目录信息上传至国家平台,国家平台将进行二次校验,若校验成功,则目录信息进入国家平台目录系统;若校验不成功,国家平台将向省平台返回相应的错误码及详细的错误信息.
.
4.
3.
3接口授权使用HTTP+JSON的协议,HTTP承载使用HTTPPOST/GET方法由请求方发送请求,由消息接收方回复响应,用户调用接口前,需要调用对接密钥获取接口,获取授权唯一票据,认证通过后,方可正常调用接口.
接口名称接口编码协议接口方向对接密钥获取GetResourcePlatTokenHTTP+JSON省平台->国家平台4.
3.
3.
1授权密钥获取及重置(1)接口描述14当需要获取数据资源密钥时,省平台调用国家平台提供的"获取授权密钥接口",获取省平台调用接口token.
当需要更新数据资源密钥时,省平台调用国家平台提供的"更新授权密钥接口",更新省平台调用接口token.
(2)接口方向发起方:省平台目录系统接收方:国家平台目录系统(3)接口协议协议:HTTP+JSON方法:POST(4)消息定义GetResourcePlatToken请求消息字段描述字段名约束类型长度说明platkey必选string32业务系统代码platsecret必选string100应用密钥optype必选string20:获取;1:重置GetResourcePlatToken返回消息字段描述字段名约束类型长度说明access_token必选string32用户授权的唯一票据(5)接口示例请求参数示例15jsonStr={"platkey":jOnY8XZQaYpVB4FbYXis9THz,"platsecret":"mWqQrLIeSPkgiUEE37y93Z5zD4U2iUxb","optype":"0"}返回参数示例{"result":"003000","resultinfo":"处理成功""resultdata":"{"access_token":"XXXXXXXXXXXXXXXXXXXXXXX"}"}(6)错误码定义如果参数或接口调用不通过,通过错误码返回数据,错误码见4.
5返回码定义章节描述.
4.
3.
4目录资源分类接口名称接口编码协议接口方向目录资源分类获取接口GetCatalogGroupReqHTTP+JSON省平台->国家平台目录资源分类创建CreateCataLogGroupHTTP+JSON省平台->国家平台目录资源分类编辑UpdateCataLogGroupHTTP+JSON省平台->国家平台目录资源分类删除DeleteCataLogGroupHTTP+JSON省平台->国家平台4.
3.
4.
1目录资源分类获取(1)接口描述当需要获取目录资源分类列表时,省平台调用国家平台提供的"获取目录资源分类接口",获取目录资源分类列表.
16(2)接口方向发起方:省平台目录系统接收方:国家平台目录系统(3)接口协议协议:HTTP+JSON方法:POST(4)消息定义GetCatalogGroupReq请求消息字段描述字段名约束类型长度说明access_token必选string32用户授权的唯一票据GetCatalogGroupReq返回消息字段描述字段名约束类型长度说明cataloggroup必选cataloggroup_schema资源目录分组定义信息,见Schema描述(5)接口示例请求参数示例jsonStr={"access_token":"XXXXXXXXXXXXXXXXXXXXXXX"}返回参数示例{"result":"002000","resultinfo":"处理成功""resultdata":[{"id":"3070260156","remark":null,"name":"贵阳市","order_id":1,"parent_id":"30702601"}17……]}(6)错误码定义如果token验证不通过或参数、权限错误,通过错误码返回数据,错误码见4.
5返回码定义章节描述.
4.
3.
4.
2目录资源分类创建(1)接口描述当对目录资源分类有新增需求时,省平台调用国家平台提供的"目录资源分类创建接口",新增目录资源分类信息.
(2)接口方向发起方:省平台目录系统接收方:国家平台目录系统(3)接口协议协议:HTTP+JSON方法:POST(4)消息定义CreateCataLogGroup请求消息字段描述字段名约束类型长度说明access_token必选string32用户授权的唯一票据catalogGroup必选CatalogGroup_schema-目录资源分类定义信息,见Schema描述18CreateCataLogGroup返回消息字段描述无消息体(5)接口示例请求参数示例jsonStr={"access_token":"XXXXXXXXXXXXXXXXXXXXXXX","name":"资源分类名称",//必填"parent_id":"资源分类父级id",//必填"remark":"资源分类描述",//选填"order_id":"资源排序编号"//选填}返回参数示例{"result":"001000","resultinfo":"处理成功","resultdata":"{"id":"3070260158"}"}(6)错误码定义如果token验证不通过或参数、权限错误,通过错误码返回数据,错误码见4.
5返回码定义章节描述.
4.
3.
4.
3目录资源分类编辑(1)接口描述当对目录资源分类有编辑需求时,省平台调用国家平台提供的"目录资源分类编辑接口",编辑目录资源分类信息.
(2)接口方向19发起方:省平台目录系统接收方:国家平台目录系统(3)接口协议协议:HTTP+JSON方法:POST(4)消息定义UpdateCataLogGroup请求消息字段描述字段名约束类型长度说明access_token必选string32用户授权的唯一票据catalogGroup必选CatalogGroup_schema-目录资源分类定义信息,见Schema描述UpdateCataLogGroup返回消息字段描述无消息体(5)接口示例请求参数示例jsonStr={"access_token":"XXXXXXXXXXXXXXXXXXXXXXX","id":"资源分类id",//必填"name":"资源分类名称",//必填"parent_id":"资源分类父级id",//必填"remark":"资源分类描述",//选填"order_id":"资源排序编号"//选填}返回参数示例{20"result":"001000","resultinfo":"处理成功"}(6)错误码定义如果token验证不通过或参数、权限错误,通过错误码返回数据,错误码见4.
5返回码定义章节描述.
4.
3.
4.
4目录资源分类删除(1)接口描述当对目录资源分类有删除需求时,省平台调用国家平台提供的"目录资源分类删除接口",删除目录资源分类信息.
(2)接口方向发起方:省平台目录系统接收方:国家平台目录系统(3)接口协议协议:HTTP+JSON方法:POST(4)消息定义DeleteCataLogGroup请求消息字段描述字段名约束类型长度说明access_token必选string32用户授权的唯一票据id必选string-目录资源分id21deleteCataLogGroup返回消息字段描述无消息体(5)接口示例请求参数示例jsonStr={"access_token":"XXXXXXXXXXXXXXXXXXXXXXX","id":"资源分类id"}返回参数示例{"result":"001000","resultinfo":"处理成功"}(6)错误码定义如果token验证不通过或参数、权限错误,通过错误码返回数据,错误码见4.
5返回码定义章节描述.
4.
3.
5数据目录接口名称接口编码协议接口方向数据资源目录是否已存在IseCataLogHasReqHTTP+JSON省平台->国家平台数据资源目录创建CreateCataLogReqHTTP+JSON省平台->国家平台数据资源目录修改UpdateCataLogReqHTTP+JSON省平台->国家平台数据资源目录删除DeleteCataLogReqHTTP+JSON省平台->国家平台数据目录状态变更UpdateCatalogStatusHTTP+JSON省平台->国家平台4.
3.
5.
1数据资源目录是否已存在(1)接口描述22当需要获取国家平台是否已存在省平台资源目录信息时,省平台调用国家平台提供的"数据资源目录是否已存在接口",获取国家平台对目录是否已存在信息.
(2)接口方向发起方:省平台目录系统接收方:国家平台目录系统(3)接口协议协议:HTTP+JSON方法:POST(4)消息定义IseCataLogHasReq请求消息字段描述字段名约束类型长度说明access_token必选string32用户授权的唯一票据catacode必选string32信息资源代码IseCataLogHasReq返回消息字段描述字段名约束类型长度说明isHas必选int2目录信息是否存在0:不存在;1:已存在(5)接口示例请求参数示例jsonStr={23"access_token":"XXXXXXXXXXXXXXXXXXXXXXX","catacode":"30303000000000001"}返回参数示例{"result":"001000","resultinfo":"处理成功","resultdata":0}(6)错误码定义如果token验证不通过或参数、权限错误,通过错误码返回数据,错误码见4.
5返回码定义章节描述.
4.
3.
5.
2数据目录创建(1)接口描述当需要新增资源目录时,省平台调用国家平台提供的"数据目录创建接口",新增目录信息.
(2)接口方向发起方:省平台目录系统接收方:国家平台目录系统(3)接口协议协议:HTTP+JSON方法:POST24(4)消息定义CreateCataLogReq请求消息字段描述字段名约束类型长度说明access_token必选string32用户授权的唯一票据catalog必选catalog_schema-数据目录定义信息,见Schema描述CreateCataLogReq返回消息字段描述无消息体(5)接口示例请求参数示例jsonStr={"access_token":"XXXXXXXXXXXXXXXXXXXXXXX","cataid":"10001","catacode":"30703000000000001",……"columnlist":[{"namecn":"信息项名称",……}]}返回参数示例{"result":"001000","resultinfo":"处理成功","resultdata":"{"cata_id":"1510727521903027532"}"}(6)错误码定义25如果token验证不通过或参数、权限错误,通过错误码返回数据,错误码见4.
5返回码定义章节描述.
4.
3.
5.
3数据目录修改(1)接口描述当需要变更资源目录时,省平台调用国家平台提供的"数据目录修改接口",修改更新目录信息.
(2)接口方向发起方:省平台目录系统接收方:国家平台目录系统(3)接口协议协议:HTTP+JSON方法:POST(4)消息定义UpdateCataLogReq请求消息字段描述字段名约束类型长度说明access_token必选string32用户授权的唯一票据catalog必选catalog_schema-数据目录定义信息,见Schema描述UpdateCataLogReq消息字段描述无消息体(5)接口示例26请求参数示例jsonStr={"access_token":"XXXXXXXXXXXXXXXXXXXXXXX","cataid":"10001","catacode":"30703000000000001",……"columnlist":[{"namecn":"信息项名称",……}]}返回参数示例{"result":"001000","resultinfo":"处理成功"}(6)错误码定义如果token验证不通过或参数、权限错误,通过错误码返回数据,错误码见4.
5返回码定义章节描述.
4.
3.
5.
4数据目录删除(1)接口描述当对数据目录信息有删除需求时,省平台调用国家平台提供的数据目录删除接口,删除数据目录信息.
(2)接口方向发起方:省平台目录系统27接收方:国家平台目录系统(3)接口协议协议:HTTP+JSON方法:POST(4)消息定义DeleteCataLogReq消息字段描述字段名约束类型长度说明access_token必选string32用户授权的唯一票据Cataid必选string32省平台数据目录编码(主键)DeleteCataLogReq消息字段描述无消息体(5)接口示例请求参数示例jsonStr={"access_token":"XXXXXXXXXXXXXXXXXXXXXXX","cataid":"10001"}返回参数示例{"result":"001000","resultinfo":"处理成功"}28(6)返回说明如果token验证不通过或参数、权限错误,通过错误码返回数据,错误码见4.
5返回码定义章节描述.
4.
3.
5.
5数据目录状态变更(1)接口描述当对数据目录信息有状态变更时,省平台调用国家平台提供的数据目录数据目录状态变更接口,更新数据目录信息状态.
(2)接口方向发起方:省平台目录系统接收方:国家平台目录系统(3)接口协议协议:HTTP+JSON方法:POST(4)消息定义UpdateCatalogStatus消息字段描述字段名约束类型长度说明access_token必选string32用户授权的唯一票据cataid必选string32省平台数据目录编码(主键)status必选Int2数据目录状态(见附录目录状态字典)29updateCatalogStatus消息字段描述无消息体(5)接口示例请求参数示例jsonStr={"access_token":"XXXXXXXXXXXXXXXXXXXXXXX","cataid":"10001","status":"0"}返回参数示例{"result":"001000","resultinfo":"处理成功"}(6)返回说明如果token验证不通过或参数、权限错误,通过错误码返回数据,错误码见4.
5返回码定义章节描述.
4.
3.
5.
6数据目录查询(1)接口描述当省级共享平台在资源发布时,按照"本省目录资源代码"或"本省目录分类全路径、目录名称"等查询参数,调用目录查询接口获取国家共享平台的目录唯一编码.
30(2)接口方向发起方:部门目录系统接收方:国家平台目录系统(3)接口协议协议:HTTP+JSON方法:POST(4)消息定义GetNationalCatalogId消息字段描述字段名约束类型长度说明access_token必选string32用户授权的唯一票据catacode选填string32信息资源代码groupnames选填string255全路径资源分类catatitle选填string50信息资源名称GetNationalCatalogId消息字段描述无消息体(5)接口示例请求参数示例jsonStr={"access_token":"XXXXXXXXXXXXXXXXXXXXXXX","catacode":"3070131001/000001","groupnames":"部门信息资源目录-省(自治区、直辖市)和计划单列市-山东省-济南市-发改委","catatitle":"主体身份登记变更信息"}31返回参数示例{"result":"010000","resultinfo":"处理成功","resultdata":"{"cata_id":"1510727521903027532"}"}(6)返回说明如果token验证不通过或参数、权限错误,通过错误码返回数据,错误码见4.
5返回码定义章节描述.
4.
4Schema定义4.
4.
1Catalog_Schema字段名约束类型长度说明token必填string32平台所属tokengroupid必填string32所属目录资源分类编码(见目录编码系统目录维护)cataid必填string32平台数据目录标识catatitle必填string512信息资源名称catacode必填string32信息资源代码orgcode必填string32信息资源提供方编码(见附录字典项定义)orgname必填string100信息资源提供方名称internalorgan可选string100提供方内部部门creditcode必填string32资源提供方代码(统一信用代码)32description必填string1024信息资源摘要resourceformat必填string20信息资源格式分类编码(见附录字典项定义)resourceformattype必填string20信息资源格式类型编码(见附录字典项定义)resourceformatother选填string100其他类型资源格式描述totalstorage必填double-数据存储总量(G)totalstructurerecord必填double-结构化信息记录总数(万)totalsharedstorage必填double-已共享的数据存储量(G)totalsharedstructurerecord必填double-已共享结构化记录数(万)totalopenstorage必填double-已开放的数据存储量(G)totalopenstructurerecord必填double-已开放结构化记录数(万)columnlist必填catalogcolumn_schema-数据项项列表信息[1.
.
n]publishedtime必填date-发布日期updatetime必填datatime-更新时间status必填Int-目录状态(见附录目录状态字典)注:331、分组编码groupid必须是国家平台目录系统中提供的目录资源分类编码;2、信息资源代码catacode根据政务信息资源目录编制指南,采用不定长度,原则上以1为起始、连续的阿拉伯数字表示.
政务信息资源分类码与政务信息资源顺序码的组合,形成完整的政务信息资源代码,详见政务信息资源编制指南第6章6.
3节政务信息资源代码内容.
344.
4.
2CatalogColumn_Schema字段名约束类型长度说明columnid选填string32信息项编码,空则认为是新增数据项namecn必填string100信息项名称dataformat必填string20数据类型编码(见附录字典项定义)length必填int20数据长度sharedtype必填string20共享类型编码(见附录字典项定义)sharedcondition必填string200共享条件sharedwaytype必填string20共享方式分类编码(见附录字典项定义)sharedway必填string20共享方式类型编码(见附录字典项定义)isopen必填int20是否向社会开放(0:不开放,1:开放)opencondition选填string200开放条件update_cycle必填string20更新周期编码(见附录字典项定义)updatetime必填datatime-更新时间4.
4.
3CatalogGroup_Schema字段名约束类型长度说明id选填string32分类idname必填string32分类名称parent_id必填string32上级分类idremark选填string100分类描述order_id选填int8排序编号354.
5返回码定义4.
5.
1返回码规则所有应答消息均使用统一定义的返回码,返回码一共6位,假设返回码格式为"ABCDEF".
其中,"A"表示返回码类型,各代码代表模块类型如下:0:成功1:系统错误2:参数错误3:业务错误"BC"表示业务模块类型,各代码代表的模块类型如下,具体实现时,可根据实际情况进行扩展:00:通用模块01:目录模块02:目录分类03:接口授权"DEF"表示具体的返回值,具体实现时,可根据实际情况进行扩展.
4.
5.
2返回值定义按照以上格式说明,返回值的具体定义如下表所示(注:所有模块错误码中的XX即为定义的模块编号):36成功类型表模块具体返回码如何理解所有模块0XX000处理成功.
系统错误类型表模块具体返回码如何理解所有模块1XX000未知错误所有模块1XX001系统忙所有模块1XX002操作超时所有模块1XX003网络异常所有模块1XX004数据库操作异常所有模块1XX005非法的连接源IP地址参数错误类型表模块具体返回码如何理解所有模块2XX000未知错误所有模块2XX001必选参数为空所有模块2XX002参数格式错误所有模块2XX003参数长度超出范围所有模块2XX004所有输入参数都为空所有模块2XX005信息已存在业务错误类型表模块具体返回码如何理解所有模块3XX000未知错误所有模块3XX001必选参数为空所有模块3XX002参数格式传递错误所有模块3XX003用户权限不足所有模块3XX004没有对应的信息374.
6接口数据字典4.
6.
1信息资源提供方序号字典码字典名称备注1111000000000130127外交部2111000000000130004国防部311100000000013039Y国家发展和改革委员会4111000000000136028教育部511100000000013063F科学技术部6000019692工业和信息化部711100000000018200F国家民族事务委员会811100000000013127D公安部9000013119监察部10111000000000131433民政部1111100000000013151X司法部1211100000000013186G财政部1311100000717823004M人力资源和社会保障部14000019174国土资源部1511100000000014672N环境保护部1611100000000013338W住房和城乡建设部1711100000000019713D交通运输部181110000000001332XW水利部19111000000000132664农业部2011100000000013223N商务部21x11000000000130006文化部22111000007178369727卫生和计划生育委员会23111000000000130007中国人民银行2411100000000013696X审计署382511100000000019545B国有资产监督管理委员会2611100000000014154E海关总署27111000000000130010税务总局2811100000MB0194554T工商行政管理总局29000019449质量监督检验检疫总局3011100000MB0372496N国家新闻出版广电总局31111000000000136290国家体育总局3211100000000013661B国家安全生产监督管理总局33000019190国家食品药品监督管理总局34111000000000141036国家统计局35000013274国家林业局3612100000400019851B国家知识产权局371110000000001420XC国家旅游局3811100000000014277F国家宗教事务局39111000000000142935国务院参事室40000014306国家机关事务管理局41717849888版权局42111000000000143573国务院侨务办公室4311100000000014365X国务院港澳事务办公室4411100000000014330B国务院法治办公室4511100000000014314M国务院研究室46x11000000000130017中央网信办4712100000000014701Y新华通讯社481210000000001471XN中国科学院4912100000000014728N中国社会科学院395012100000400016159N中国工程院5112100000000014736H国务院发展研究中心52121000004000118688国家行政学院5312100000000014197Q中国地震局54121000000000141626中国气象局5512100000717804719J中国银行监督管理委员会5612100000MB0278571G中国证券监督管理委员会57121000000000192620中国保险监督管理委员会5812100000717800822N全国社会保障基金理事会5912100000000019035T自然科学基金委员会6011100000000018606Q信访局6111100000000018016P粮食局6211100000000019705J能源局63x11000000000130021国防科技工业局6411100000000014568J烟草专卖局65111000000000144024外国专家局66x11000000000130022国家公务员局67000014189海洋局6811100000000014664U测绘地理信息局6911100000717835929G铁路局70111000000000141704中国民用航空局7111100000717819048R国家邮政局72000014533国家文物局7311100000000014680H中医药管理局407411100000000014453C外汇管理局75111000000000130025煤矿安全监察局7611100000000019502X扶贫办77000018243三峡办78111000000000195611南水北调办79110000北京市80120000天津市81130000河北省82140000山西省83150000内蒙古自治区84210000辽宁省85220000吉林省86230000黑龙江省87310000上海市88320000江苏省89330000浙江省90340000安徽省91350000福建省92360000江西省93370000山东省94410000河南省95420000湖北省96430000湖南省97440000广东省98450000广西壮族自治区99460000海南省100500000重庆市41101510000四川省102520000贵州省103530000云南省104540000西藏自治区105610000陕西省106620000甘肃省107630000青海省108640000宁夏回族自治区109650000新疆维吾尔自治区110660000新疆生产建设兵团111810000香港特别行政区112820000澳门特别行政区注:部门的统一社会信用代码标红的均是在官网没有或暂时没有查询到的,后续进行相应的补充修改.
4.
6.
2信息资源格式分类序号字典码字典名称备注101电子文件202电子表格303数据库404图形图像505流媒体606自描述格式4.
6.
3信息资源格式类型(与信息资源格式分类为父子关系)序号字典码资源格式分类字典名称备注10101电子文件doc20102docx4230103html40104OFD50105pdf60106ppt70107txt80108wps90109xml100110dbf110111bmp位图文件格120100其他130201电子表格et140202xls150203xlsx160200其他170301数据库access180302db2190303dbase200304dbf210305Dm220306KingbaseES230307oracle240308sqlServer250309sybase260310mysql270311GBase280312Hbase290313hdfs43300314EsgynDB310315redis320316mongodb330300其他340401图形图像bmp350402gif360403jpg370400其他380501流媒体mpg390502rm400503swf410500其他420601自描述格式表格驱动码430600其他注:标黄色的为新增字典类型4.
6.
4数据类型序号字典码字典名称备注11字符串型C22数值型N33货币型Y44日期型D55日期时间型T66逻辑型L77备注型M88通用型G99双精度型B441010整型I1111浮点型F1212二进制blob1313长文本text4.
6.
5共享类型序号字典码字典名称备注11有条件共享22无条件共享33不共享4.
6.
6共享方式分类序号字典码字典名称备注101共享平台方式202邮件或介质4.
6.
7共享方式类型序号字典码共享方式分类字典名称备注10101共享平台方式接口20102数据库30103文件40201邮件或介质邮件50202拷盘60203纸质报表70204电子文档4.
6.
8更新周期序号字典码字典名称备注11自定义22每日4533每周44每月55每季度66每半年77每年88实时4.
6.
9数据目录状态序号字典码字典名称备注10编辑21待审批32已审批43已驳回54已上线65已下线7-1删除4.
7数据字典补充说明以上字典项是依据目录编制指南定义的,无法穷举所有字典项,如不满足省平台的工作需要,可向国家平台发起相应的申请,申请变更或补充相应的字典项,并由国家平台进行相应审核.
如通过审核,国家平台会根据需求变更或补充字典项,并发布新的对接方案版本给省平台.
46字典项补充变更申请开始国家平台审批字典项申请审批字典项补充变更申请结束将驳回理由反馈给省平台更新字典项,更新对接文档版本驳回通过省平台字典项补充变更申请第五章省平台对接工作事项为完成省平台目录系统与国家平台目录系统对接,实现省平台资源目录的实时上报工作,省平台需开展以下工作:1、系统研发工作根据省平台目录系统对接技术要求,开发与国家平台目录系统的对接模块,实现对国家平台目录系统对接接口的调用.
2、测试准备(1)调通省平台到国家平台目录系统接口测试服务器的网络.
(2)准备好需要测试的资源目录数据.
(3)向国家平台申请接口账号和接口密钥.
3、测试工作调试对接模块,调用国家平台目录系统测试接口,测试资源目录数据的添加、修改、删除.
5第二章对接设计流程.
6第三章接口访问流程.
8第四章接口标准.
94.
1接口地址(测试地址)94.
2接口地址(正式地址)104.
3接口描述.
124.
3.
1接口调用流程.
124.
3.
2信息校验.
124.
3.
3接口授权.
134.
3.
4目录资源分类.
154.
3.
5数据目录.
214.
4Schema定义.
314.
4.
1Catalog_Schema314.
4.
2CatalogColumn_Schema.
344.
4.
3CatalogGroup_Schema344.
5返回码定义.
354.
5.
1返回码规则.
354.
5.
2返回值定义.
354.
6接口数据字典.
374.
6.
1信息资源提供方.
374.
6.
2信息资源格式分类.
414.
6.
3信息资源格式类型(与信息资源格式分类为父子关系)414.
6.
4数据类型.
434.
6.
5共享类型.
444.
6.
6共享方式分类.
444.
6.
7共享方式类型.
4434.
6.
8更新周期.
444.
6.
9数据目录状态.
454.
7数据字典补充说明.
45第五章省平台对接工作事项.
464文档变更说明版本类型日期说明V0.
1新增2017-10-25新增目录系统对接方案V0.
2修改2017-10-261、更新了接口地址【测试用地址】,将原地址http://59.
255.
104.
52/interface/service.
htm及http://59.
255.
104.
52/interface/catalog.
htm统一修改为http://59.
255.
104.
52/interface/service.
do;2、补充授权接口传入的参数optype,并将传入参数封装为jsonStr3、统一所有接口中传入参数token名称为access_tokenV0.
3修改2017-10-301、增加参数错误返回码005-信息已存在2、增加业务错误返回码005-没有对应信息V0.
4修改2017-11-021、修改数据资源目录是否已存方法的返回示例中resultdata的显示值显示为0或1;2、修改Catalog_Schema中传入字段columnslist修改为columnlistV0.
5修改2017-11-061、增加了groupid和catacode字段备注2、去掉CatalogColumn_Schema中必填access_token字段.
V0.
5修改2017-11-131、修改Catalog_Schema中传入字段,增加必填字段目录状态status及描述2、新增数据目录状态变更的方法updateCatalogStatus3、新增目录资源分类的新增,修改,删除方法VO.
6修改2017-11-161、新增数据目录查询接口返回国家平台目录id5第一章背景按照《国务院办公厅关于印发政务信息系统整合共享实施方案的通知》(国办发〔2017〕39号)、《国务院关于印发政务信息资源共享管理暂行办法的通知》(国发〔2016〕51号)等文件精神,为促进政务信息资源共享交换,规范省级数据共享交换平台(以下简称"省平台")与国家数据共享交换平台(外网)(以下简称"国家平台")政务信息资源目录对接,实现省平台与国家平台的目录信息实时同步制定本方案.
本方案主要用于省平台目录系统与国家平台目录系统对接,规范省平台政务资源目录与国家平台政务资源目录的实时同步工作.
6第二章对接设计流程省平台目录系统通过调用国家平台目录系统提供的服务接口,实现本地区政务信息资源目录的上报、修改和删除.
省平台目录系统与国家平台目录系统对接流程国家平台目录系统省平台目录系统开始结束目录创建目录审批未通过调用国家平台接口通过获取数据请求目录格式校验授权校验权限校验目录格式校验通过处理数据目录资源库审核日志获取返回结果通过通过返回出来结果校验不成功,返回错误码无权限操作,返回错误码校验不成功,返回错误码一、省平台目录系统1、省平台目录系统接入国家平台目录系统,上报的目录数据必须通过省平台目录系统的审核和目录格式校验校验.
72、省平台目录系统调用国家平台目录系统前,给国家平台目录系统提供调用方名称、联系人、联系电话、请求来源IP信息,由国家平台目录系统分配platkey和platsecret,通过调用授权密钥获取接口,获取或重置授权密钥.
3、接口调用方获取到授权密钥后,调用数据目录相关接口查询时,授权密钥、请求来源IP对数据请求权限进行双重权限验证,如不符合权限要求,系统不予放行并返回错误码信息.
4、省平台目录系统调用国家平台目录系统服务接口时,提报的政务信息资源目录数据必须按照本文4.
4、4.
6章节中的对数据格式和数据字典内容得要求填写.
二、国家平台目录系统1、根据请求方提供资料,生成platkey和platsecret并反馈给省平台目录系统.
2、接口调用时,国家平台目录系统负责完成调用授权校验、权限校验和数据目录格式校核工作,符合要求的数据,汇总至国家平台目录系统,否则返回错误信息至接口调用方.
3、国家平台目录系统,对接口请求过程进行监控和日志审计,保证接口的安全性和可追溯性.
8第三章接口访问流程省平台调用国家平台目录系统服务接口时,通过国家平台目录系统分配的接口账号、接口密钥调用接口申请访问令牌token;通过申请到的token进行业务接口访问.
9第四章接口标准省平台目录系统与国家平台目录系统采用API接口的方式实现对接和数据同步.
4.
1接口地址(测试地址)对接密钥获取地址http://59.
255.
104.
52/interface/service.
domethod=GetResourcePlatToken目录资源分类获取http://59.
255.
104.
52/interface/service.
domethod=GetCatalogGroupReq目录资源分类创建http://59.
255.
104.
52/interface/service.
domethod=CreateCataLogGroup目录资源分类修改http://59.
255.
104.
52/interface/service.
domethod=UpdateCataLogGroup目录资源分类删除http://59.
255.
104.
52/interface/service.
domethod=DeleteCataLogGroup10数据资源目录是否已存在http://59.
255.
104.
52/interface/service.
domethod=IseCataLogHasReq数据资源目录创建http://59.
255.
104.
52/interface/service.
domethod=CreateCataLogReq数据资源目录修改http://59.
255.
104.
52/interface/service.
domethod=UpdateCataLogReq数据资源目录删除http://59.
255.
104.
52/interface/service.
domethod=DeleteCataLogReq数据资源状态变更http://59.
255.
104.
52/interface/service.
domethod=UpdateCatalogStatus4.
2接口地址(正式地址)对接密钥获取地址http://data.
cegn.
cn/interface/service.
domethod=GetResourcePlatToken11目录资源分类获取http://data.
cegn.
cn/interface/service.
domethod=GetCatalogGroupReq目录资源分类创建http://data.
cegn.
cn/interface/service.
domethod=CreateCataLogGroup目录资源分类修改http://data.
cegn.
cn/interface/service.
domethod=UpdateCataLogGroup目录资源分类删除http://data.
cegn.
cn/interface/service.
domethod=DeleteCataLogGroup数据资源目录是否已存在http://data.
cegn.
cn/interface/service.
domethod=IseCataLogHasReq数据资源目录创建http://data.
cegn.
cn/interface/service.
domethod=CreateCataLogReq数据资源目录修改http://data.
cegn.
cn/interface/service.
domethod=UpdateCataLogReq12数据资源目录删除http://data.
cegn.
cn/interface/service.
domethod=DeleteCataLogReq数据资源状态变更http://data.
cegn.
cn/interface/service.
domethod=UpdateCatalogStatus4.
3接口描述4.
3.
1接口调用流程4.
3.
2信息校验4.
3.
2.
1授权校验省平台发起调用服务申请,国家平台对发起申请调用的省平台进行权限验证,判断是否具有调用接口服务的相应权限,若没有相应的权限,则返回相应的错误码.
4.
3.
2.
2权限校验省平台通过授权验证后,在调用相应的接口前,国家平台会对省平台进行相应的权限验证,如果没有相应的获取及修13改权限,则返回相应的错误码.
4.
3.
2.
3省平台信息数据校验省平台须先调用信息校核工具(校核工具包含java和.
net两个版本,详情请参考"国家数据共享交换平台(外网)校核工具包说明文档"),对准备传输到国家平台的数据进行相应的校验,包括目录信息格式校验和信息字典项项校验.
若校验成功,则可调用国家平台服务接口,若校验不成功,省平台需按要求做相应的修改.
4.
3.
2.
4国家平台信息校验省平台通过调用接口服务将目录信息上传至国家平台,国家平台将进行二次校验,若校验成功,则目录信息进入国家平台目录系统;若校验不成功,国家平台将向省平台返回相应的错误码及详细的错误信息.
.
4.
3.
3接口授权使用HTTP+JSON的协议,HTTP承载使用HTTPPOST/GET方法由请求方发送请求,由消息接收方回复响应,用户调用接口前,需要调用对接密钥获取接口,获取授权唯一票据,认证通过后,方可正常调用接口.
接口名称接口编码协议接口方向对接密钥获取GetResourcePlatTokenHTTP+JSON省平台->国家平台4.
3.
3.
1授权密钥获取及重置(1)接口描述14当需要获取数据资源密钥时,省平台调用国家平台提供的"获取授权密钥接口",获取省平台调用接口token.
当需要更新数据资源密钥时,省平台调用国家平台提供的"更新授权密钥接口",更新省平台调用接口token.
(2)接口方向发起方:省平台目录系统接收方:国家平台目录系统(3)接口协议协议:HTTP+JSON方法:POST(4)消息定义GetResourcePlatToken请求消息字段描述字段名约束类型长度说明platkey必选string32业务系统代码platsecret必选string100应用密钥optype必选string20:获取;1:重置GetResourcePlatToken返回消息字段描述字段名约束类型长度说明access_token必选string32用户授权的唯一票据(5)接口示例请求参数示例15jsonStr={"platkey":jOnY8XZQaYpVB4FbYXis9THz,"platsecret":"mWqQrLIeSPkgiUEE37y93Z5zD4U2iUxb","optype":"0"}返回参数示例{"result":"003000","resultinfo":"处理成功""resultdata":"{"access_token":"XXXXXXXXXXXXXXXXXXXXXXX"}"}(6)错误码定义如果参数或接口调用不通过,通过错误码返回数据,错误码见4.
5返回码定义章节描述.
4.
3.
4目录资源分类接口名称接口编码协议接口方向目录资源分类获取接口GetCatalogGroupReqHTTP+JSON省平台->国家平台目录资源分类创建CreateCataLogGroupHTTP+JSON省平台->国家平台目录资源分类编辑UpdateCataLogGroupHTTP+JSON省平台->国家平台目录资源分类删除DeleteCataLogGroupHTTP+JSON省平台->国家平台4.
3.
4.
1目录资源分类获取(1)接口描述当需要获取目录资源分类列表时,省平台调用国家平台提供的"获取目录资源分类接口",获取目录资源分类列表.
16(2)接口方向发起方:省平台目录系统接收方:国家平台目录系统(3)接口协议协议:HTTP+JSON方法:POST(4)消息定义GetCatalogGroupReq请求消息字段描述字段名约束类型长度说明access_token必选string32用户授权的唯一票据GetCatalogGroupReq返回消息字段描述字段名约束类型长度说明cataloggroup必选cataloggroup_schema资源目录分组定义信息,见Schema描述(5)接口示例请求参数示例jsonStr={"access_token":"XXXXXXXXXXXXXXXXXXXXXXX"}返回参数示例{"result":"002000","resultinfo":"处理成功""resultdata":[{"id":"3070260156","remark":null,"name":"贵阳市","order_id":1,"parent_id":"30702601"}17……]}(6)错误码定义如果token验证不通过或参数、权限错误,通过错误码返回数据,错误码见4.
5返回码定义章节描述.
4.
3.
4.
2目录资源分类创建(1)接口描述当对目录资源分类有新增需求时,省平台调用国家平台提供的"目录资源分类创建接口",新增目录资源分类信息.
(2)接口方向发起方:省平台目录系统接收方:国家平台目录系统(3)接口协议协议:HTTP+JSON方法:POST(4)消息定义CreateCataLogGroup请求消息字段描述字段名约束类型长度说明access_token必选string32用户授权的唯一票据catalogGroup必选CatalogGroup_schema-目录资源分类定义信息,见Schema描述18CreateCataLogGroup返回消息字段描述无消息体(5)接口示例请求参数示例jsonStr={"access_token":"XXXXXXXXXXXXXXXXXXXXXXX","name":"资源分类名称",//必填"parent_id":"资源分类父级id",//必填"remark":"资源分类描述",//选填"order_id":"资源排序编号"//选填}返回参数示例{"result":"001000","resultinfo":"处理成功","resultdata":"{"id":"3070260158"}"}(6)错误码定义如果token验证不通过或参数、权限错误,通过错误码返回数据,错误码见4.
5返回码定义章节描述.
4.
3.
4.
3目录资源分类编辑(1)接口描述当对目录资源分类有编辑需求时,省平台调用国家平台提供的"目录资源分类编辑接口",编辑目录资源分类信息.
(2)接口方向19发起方:省平台目录系统接收方:国家平台目录系统(3)接口协议协议:HTTP+JSON方法:POST(4)消息定义UpdateCataLogGroup请求消息字段描述字段名约束类型长度说明access_token必选string32用户授权的唯一票据catalogGroup必选CatalogGroup_schema-目录资源分类定义信息,见Schema描述UpdateCataLogGroup返回消息字段描述无消息体(5)接口示例请求参数示例jsonStr={"access_token":"XXXXXXXXXXXXXXXXXXXXXXX","id":"资源分类id",//必填"name":"资源分类名称",//必填"parent_id":"资源分类父级id",//必填"remark":"资源分类描述",//选填"order_id":"资源排序编号"//选填}返回参数示例{20"result":"001000","resultinfo":"处理成功"}(6)错误码定义如果token验证不通过或参数、权限错误,通过错误码返回数据,错误码见4.
5返回码定义章节描述.
4.
3.
4.
4目录资源分类删除(1)接口描述当对目录资源分类有删除需求时,省平台调用国家平台提供的"目录资源分类删除接口",删除目录资源分类信息.
(2)接口方向发起方:省平台目录系统接收方:国家平台目录系统(3)接口协议协议:HTTP+JSON方法:POST(4)消息定义DeleteCataLogGroup请求消息字段描述字段名约束类型长度说明access_token必选string32用户授权的唯一票据id必选string-目录资源分id21deleteCataLogGroup返回消息字段描述无消息体(5)接口示例请求参数示例jsonStr={"access_token":"XXXXXXXXXXXXXXXXXXXXXXX","id":"资源分类id"}返回参数示例{"result":"001000","resultinfo":"处理成功"}(6)错误码定义如果token验证不通过或参数、权限错误,通过错误码返回数据,错误码见4.
5返回码定义章节描述.
4.
3.
5数据目录接口名称接口编码协议接口方向数据资源目录是否已存在IseCataLogHasReqHTTP+JSON省平台->国家平台数据资源目录创建CreateCataLogReqHTTP+JSON省平台->国家平台数据资源目录修改UpdateCataLogReqHTTP+JSON省平台->国家平台数据资源目录删除DeleteCataLogReqHTTP+JSON省平台->国家平台数据目录状态变更UpdateCatalogStatusHTTP+JSON省平台->国家平台4.
3.
5.
1数据资源目录是否已存在(1)接口描述22当需要获取国家平台是否已存在省平台资源目录信息时,省平台调用国家平台提供的"数据资源目录是否已存在接口",获取国家平台对目录是否已存在信息.
(2)接口方向发起方:省平台目录系统接收方:国家平台目录系统(3)接口协议协议:HTTP+JSON方法:POST(4)消息定义IseCataLogHasReq请求消息字段描述字段名约束类型长度说明access_token必选string32用户授权的唯一票据catacode必选string32信息资源代码IseCataLogHasReq返回消息字段描述字段名约束类型长度说明isHas必选int2目录信息是否存在0:不存在;1:已存在(5)接口示例请求参数示例jsonStr={23"access_token":"XXXXXXXXXXXXXXXXXXXXXXX","catacode":"30303000000000001"}返回参数示例{"result":"001000","resultinfo":"处理成功","resultdata":0}(6)错误码定义如果token验证不通过或参数、权限错误,通过错误码返回数据,错误码见4.
5返回码定义章节描述.
4.
3.
5.
2数据目录创建(1)接口描述当需要新增资源目录时,省平台调用国家平台提供的"数据目录创建接口",新增目录信息.
(2)接口方向发起方:省平台目录系统接收方:国家平台目录系统(3)接口协议协议:HTTP+JSON方法:POST24(4)消息定义CreateCataLogReq请求消息字段描述字段名约束类型长度说明access_token必选string32用户授权的唯一票据catalog必选catalog_schema-数据目录定义信息,见Schema描述CreateCataLogReq返回消息字段描述无消息体(5)接口示例请求参数示例jsonStr={"access_token":"XXXXXXXXXXXXXXXXXXXXXXX","cataid":"10001","catacode":"30703000000000001",……"columnlist":[{"namecn":"信息项名称",……}]}返回参数示例{"result":"001000","resultinfo":"处理成功","resultdata":"{"cata_id":"1510727521903027532"}"}(6)错误码定义25如果token验证不通过或参数、权限错误,通过错误码返回数据,错误码见4.
5返回码定义章节描述.
4.
3.
5.
3数据目录修改(1)接口描述当需要变更资源目录时,省平台调用国家平台提供的"数据目录修改接口",修改更新目录信息.
(2)接口方向发起方:省平台目录系统接收方:国家平台目录系统(3)接口协议协议:HTTP+JSON方法:POST(4)消息定义UpdateCataLogReq请求消息字段描述字段名约束类型长度说明access_token必选string32用户授权的唯一票据catalog必选catalog_schema-数据目录定义信息,见Schema描述UpdateCataLogReq消息字段描述无消息体(5)接口示例26请求参数示例jsonStr={"access_token":"XXXXXXXXXXXXXXXXXXXXXXX","cataid":"10001","catacode":"30703000000000001",……"columnlist":[{"namecn":"信息项名称",……}]}返回参数示例{"result":"001000","resultinfo":"处理成功"}(6)错误码定义如果token验证不通过或参数、权限错误,通过错误码返回数据,错误码见4.
5返回码定义章节描述.
4.
3.
5.
4数据目录删除(1)接口描述当对数据目录信息有删除需求时,省平台调用国家平台提供的数据目录删除接口,删除数据目录信息.
(2)接口方向发起方:省平台目录系统27接收方:国家平台目录系统(3)接口协议协议:HTTP+JSON方法:POST(4)消息定义DeleteCataLogReq消息字段描述字段名约束类型长度说明access_token必选string32用户授权的唯一票据Cataid必选string32省平台数据目录编码(主键)DeleteCataLogReq消息字段描述无消息体(5)接口示例请求参数示例jsonStr={"access_token":"XXXXXXXXXXXXXXXXXXXXXXX","cataid":"10001"}返回参数示例{"result":"001000","resultinfo":"处理成功"}28(6)返回说明如果token验证不通过或参数、权限错误,通过错误码返回数据,错误码见4.
5返回码定义章节描述.
4.
3.
5.
5数据目录状态变更(1)接口描述当对数据目录信息有状态变更时,省平台调用国家平台提供的数据目录数据目录状态变更接口,更新数据目录信息状态.
(2)接口方向发起方:省平台目录系统接收方:国家平台目录系统(3)接口协议协议:HTTP+JSON方法:POST(4)消息定义UpdateCatalogStatus消息字段描述字段名约束类型长度说明access_token必选string32用户授权的唯一票据cataid必选string32省平台数据目录编码(主键)status必选Int2数据目录状态(见附录目录状态字典)29updateCatalogStatus消息字段描述无消息体(5)接口示例请求参数示例jsonStr={"access_token":"XXXXXXXXXXXXXXXXXXXXXXX","cataid":"10001","status":"0"}返回参数示例{"result":"001000","resultinfo":"处理成功"}(6)返回说明如果token验证不通过或参数、权限错误,通过错误码返回数据,错误码见4.
5返回码定义章节描述.
4.
3.
5.
6数据目录查询(1)接口描述当省级共享平台在资源发布时,按照"本省目录资源代码"或"本省目录分类全路径、目录名称"等查询参数,调用目录查询接口获取国家共享平台的目录唯一编码.
30(2)接口方向发起方:部门目录系统接收方:国家平台目录系统(3)接口协议协议:HTTP+JSON方法:POST(4)消息定义GetNationalCatalogId消息字段描述字段名约束类型长度说明access_token必选string32用户授权的唯一票据catacode选填string32信息资源代码groupnames选填string255全路径资源分类catatitle选填string50信息资源名称GetNationalCatalogId消息字段描述无消息体(5)接口示例请求参数示例jsonStr={"access_token":"XXXXXXXXXXXXXXXXXXXXXXX","catacode":"3070131001/000001","groupnames":"部门信息资源目录-省(自治区、直辖市)和计划单列市-山东省-济南市-发改委","catatitle":"主体身份登记变更信息"}31返回参数示例{"result":"010000","resultinfo":"处理成功","resultdata":"{"cata_id":"1510727521903027532"}"}(6)返回说明如果token验证不通过或参数、权限错误,通过错误码返回数据,错误码见4.
5返回码定义章节描述.
4.
4Schema定义4.
4.
1Catalog_Schema字段名约束类型长度说明token必填string32平台所属tokengroupid必填string32所属目录资源分类编码(见目录编码系统目录维护)cataid必填string32平台数据目录标识catatitle必填string512信息资源名称catacode必填string32信息资源代码orgcode必填string32信息资源提供方编码(见附录字典项定义)orgname必填string100信息资源提供方名称internalorgan可选string100提供方内部部门creditcode必填string32资源提供方代码(统一信用代码)32description必填string1024信息资源摘要resourceformat必填string20信息资源格式分类编码(见附录字典项定义)resourceformattype必填string20信息资源格式类型编码(见附录字典项定义)resourceformatother选填string100其他类型资源格式描述totalstorage必填double-数据存储总量(G)totalstructurerecord必填double-结构化信息记录总数(万)totalsharedstorage必填double-已共享的数据存储量(G)totalsharedstructurerecord必填double-已共享结构化记录数(万)totalopenstorage必填double-已开放的数据存储量(G)totalopenstructurerecord必填double-已开放结构化记录数(万)columnlist必填catalogcolumn_schema-数据项项列表信息[1.
.
n]publishedtime必填date-发布日期updatetime必填datatime-更新时间status必填Int-目录状态(见附录目录状态字典)注:331、分组编码groupid必须是国家平台目录系统中提供的目录资源分类编码;2、信息资源代码catacode根据政务信息资源目录编制指南,采用不定长度,原则上以1为起始、连续的阿拉伯数字表示.
政务信息资源分类码与政务信息资源顺序码的组合,形成完整的政务信息资源代码,详见政务信息资源编制指南第6章6.
3节政务信息资源代码内容.
344.
4.
2CatalogColumn_Schema字段名约束类型长度说明columnid选填string32信息项编码,空则认为是新增数据项namecn必填string100信息项名称dataformat必填string20数据类型编码(见附录字典项定义)length必填int20数据长度sharedtype必填string20共享类型编码(见附录字典项定义)sharedcondition必填string200共享条件sharedwaytype必填string20共享方式分类编码(见附录字典项定义)sharedway必填string20共享方式类型编码(见附录字典项定义)isopen必填int20是否向社会开放(0:不开放,1:开放)opencondition选填string200开放条件update_cycle必填string20更新周期编码(见附录字典项定义)updatetime必填datatime-更新时间4.
4.
3CatalogGroup_Schema字段名约束类型长度说明id选填string32分类idname必填string32分类名称parent_id必填string32上级分类idremark选填string100分类描述order_id选填int8排序编号354.
5返回码定义4.
5.
1返回码规则所有应答消息均使用统一定义的返回码,返回码一共6位,假设返回码格式为"ABCDEF".
其中,"A"表示返回码类型,各代码代表模块类型如下:0:成功1:系统错误2:参数错误3:业务错误"BC"表示业务模块类型,各代码代表的模块类型如下,具体实现时,可根据实际情况进行扩展:00:通用模块01:目录模块02:目录分类03:接口授权"DEF"表示具体的返回值,具体实现时,可根据实际情况进行扩展.
4.
5.
2返回值定义按照以上格式说明,返回值的具体定义如下表所示(注:所有模块错误码中的XX即为定义的模块编号):36成功类型表模块具体返回码如何理解所有模块0XX000处理成功.
系统错误类型表模块具体返回码如何理解所有模块1XX000未知错误所有模块1XX001系统忙所有模块1XX002操作超时所有模块1XX003网络异常所有模块1XX004数据库操作异常所有模块1XX005非法的连接源IP地址参数错误类型表模块具体返回码如何理解所有模块2XX000未知错误所有模块2XX001必选参数为空所有模块2XX002参数格式错误所有模块2XX003参数长度超出范围所有模块2XX004所有输入参数都为空所有模块2XX005信息已存在业务错误类型表模块具体返回码如何理解所有模块3XX000未知错误所有模块3XX001必选参数为空所有模块3XX002参数格式传递错误所有模块3XX003用户权限不足所有模块3XX004没有对应的信息374.
6接口数据字典4.
6.
1信息资源提供方序号字典码字典名称备注1111000000000130127外交部2111000000000130004国防部311100000000013039Y国家发展和改革委员会4111000000000136028教育部511100000000013063F科学技术部6000019692工业和信息化部711100000000018200F国家民族事务委员会811100000000013127D公安部9000013119监察部10111000000000131433民政部1111100000000013151X司法部1211100000000013186G财政部1311100000717823004M人力资源和社会保障部14000019174国土资源部1511100000000014672N环境保护部1611100000000013338W住房和城乡建设部1711100000000019713D交通运输部181110000000001332XW水利部19111000000000132664农业部2011100000000013223N商务部21x11000000000130006文化部22111000007178369727卫生和计划生育委员会23111000000000130007中国人民银行2411100000000013696X审计署382511100000000019545B国有资产监督管理委员会2611100000000014154E海关总署27111000000000130010税务总局2811100000MB0194554T工商行政管理总局29000019449质量监督检验检疫总局3011100000MB0372496N国家新闻出版广电总局31111000000000136290国家体育总局3211100000000013661B国家安全生产监督管理总局33000019190国家食品药品监督管理总局34111000000000141036国家统计局35000013274国家林业局3612100000400019851B国家知识产权局371110000000001420XC国家旅游局3811100000000014277F国家宗教事务局39111000000000142935国务院参事室40000014306国家机关事务管理局41717849888版权局42111000000000143573国务院侨务办公室4311100000000014365X国务院港澳事务办公室4411100000000014330B国务院法治办公室4511100000000014314M国务院研究室46x11000000000130017中央网信办4712100000000014701Y新华通讯社481210000000001471XN中国科学院4912100000000014728N中国社会科学院395012100000400016159N中国工程院5112100000000014736H国务院发展研究中心52121000004000118688国家行政学院5312100000000014197Q中国地震局54121000000000141626中国气象局5512100000717804719J中国银行监督管理委员会5612100000MB0278571G中国证券监督管理委员会57121000000000192620中国保险监督管理委员会5812100000717800822N全国社会保障基金理事会5912100000000019035T自然科学基金委员会6011100000000018606Q信访局6111100000000018016P粮食局6211100000000019705J能源局63x11000000000130021国防科技工业局6411100000000014568J烟草专卖局65111000000000144024外国专家局66x11000000000130022国家公务员局67000014189海洋局6811100000000014664U测绘地理信息局6911100000717835929G铁路局70111000000000141704中国民用航空局7111100000717819048R国家邮政局72000014533国家文物局7311100000000014680H中医药管理局407411100000000014453C外汇管理局75111000000000130025煤矿安全监察局7611100000000019502X扶贫办77000018243三峡办78111000000000195611南水北调办79110000北京市80120000天津市81130000河北省82140000山西省83150000内蒙古自治区84210000辽宁省85220000吉林省86230000黑龙江省87310000上海市88320000江苏省89330000浙江省90340000安徽省91350000福建省92360000江西省93370000山东省94410000河南省95420000湖北省96430000湖南省97440000广东省98450000广西壮族自治区99460000海南省100500000重庆市41101510000四川省102520000贵州省103530000云南省104540000西藏自治区105610000陕西省106620000甘肃省107630000青海省108640000宁夏回族自治区109650000新疆维吾尔自治区110660000新疆生产建设兵团111810000香港特别行政区112820000澳门特别行政区注:部门的统一社会信用代码标红的均是在官网没有或暂时没有查询到的,后续进行相应的补充修改.
4.
6.
2信息资源格式分类序号字典码字典名称备注101电子文件202电子表格303数据库404图形图像505流媒体606自描述格式4.
6.
3信息资源格式类型(与信息资源格式分类为父子关系)序号字典码资源格式分类字典名称备注10101电子文件doc20102docx4230103html40104OFD50105pdf60106ppt70107txt80108wps90109xml100110dbf110111bmp位图文件格120100其他130201电子表格et140202xls150203xlsx160200其他170301数据库access180302db2190303dbase200304dbf210305Dm220306KingbaseES230307oracle240308sqlServer250309sybase260310mysql270311GBase280312Hbase290313hdfs43300314EsgynDB310315redis320316mongodb330300其他340401图形图像bmp350402gif360403jpg370400其他380501流媒体mpg390502rm400503swf410500其他420601自描述格式表格驱动码430600其他注:标黄色的为新增字典类型4.
6.
4数据类型序号字典码字典名称备注11字符串型C22数值型N33货币型Y44日期型D55日期时间型T66逻辑型L77备注型M88通用型G99双精度型B441010整型I1111浮点型F1212二进制blob1313长文本text4.
6.
5共享类型序号字典码字典名称备注11有条件共享22无条件共享33不共享4.
6.
6共享方式分类序号字典码字典名称备注101共享平台方式202邮件或介质4.
6.
7共享方式类型序号字典码共享方式分类字典名称备注10101共享平台方式接口20102数据库30103文件40201邮件或介质邮件50202拷盘60203纸质报表70204电子文档4.
6.
8更新周期序号字典码字典名称备注11自定义22每日4533每周44每月55每季度66每半年77每年88实时4.
6.
9数据目录状态序号字典码字典名称备注10编辑21待审批32已审批43已驳回54已上线65已下线7-1删除4.
7数据字典补充说明以上字典项是依据目录编制指南定义的,无法穷举所有字典项,如不满足省平台的工作需要,可向国家平台发起相应的申请,申请变更或补充相应的字典项,并由国家平台进行相应审核.
如通过审核,国家平台会根据需求变更或补充字典项,并发布新的对接方案版本给省平台.
46字典项补充变更申请开始国家平台审批字典项申请审批字典项补充变更申请结束将驳回理由反馈给省平台更新字典项,更新对接文档版本驳回通过省平台字典项补充变更申请第五章省平台对接工作事项为完成省平台目录系统与国家平台目录系统对接,实现省平台资源目录的实时上报工作,省平台需开展以下工作:1、系统研发工作根据省平台目录系统对接技术要求,开发与国家平台目录系统的对接模块,实现对国家平台目录系统对接接口的调用.
2、测试准备(1)调通省平台到国家平台目录系统接口测试服务器的网络.
(2)准备好需要测试的资源目录数据.
(3)向国家平台申请接口账号和接口密钥.
3、测试工作调试对接模块,调用国家平台目录系统测试接口,测试资源目录数据的添加、修改、删除.
hosteons：10Gbps带宽，免费Windows授权，自定义上传ISO，VPS低至$21/年，可选洛杉矶达拉斯纽约
hosteons当前对美国洛杉矶、达拉斯、纽约数据中心的VPS进行特别的促销活动：（1）免费从1Gbps升级到10Gbps带宽，（2）Free Blesta License授权，（3）Windows server 2019授权，要求从2G内存起，而且是年付。 官方网站：https://www.hosteons.com 使用优惠码：zhujicepingEDDB10G，可以获得： 免费升级10...
阿里云年中活动最后一周 - ECS共享型N4 2G1M年付59元
以前我们在参与到云服务商促销活动的时候周期基本是一周时间，而如今我们会看到无论是云服务商还是电商活动基本上周期都要有超过一个月，所以我们有一些网友习惯在活动结束之前看看商家是不是有最后的促销活动吸引力的，比如有看到阿里云年中活动最后一周，如果我们有需要云服务器的可以看看。在前面的文章中（阿里云新人福利选择共享性N4云服务器年79.86元且送2月数据库），（LAOZUO.ORG）有提到阿里云今年的云...
AkkoCloud(60元/月 ),英国伦敦CN2 1核 768 MB 内存 10 GB SSD 硬盘 600GB 流量 英国伦敦CN2 1核 1.5G 300Mbps
官方网站：https://www.akkocloud.com/AkkoCloud新品英国伦敦CN2 GIA已上线三网回程CN2 GIA 国内速度优秀.电信去程CN2 GIALooking Glass:http://lonlg.akkocloud.com/Speedtest:http://lonlg.akkocloud.com/speedtest/新品上线刚好碰上国庆节 特此放上国庆专属九折循环优惠...
国家网络目录数据库为你推荐
-
小米iosdiskmedia三星iphone现有新的ios更新可用请从ios14be苹果11建议更新ios14.3iprouteip route 0.0.0.0 0.0.0.0 s0/0/0 中s0/0/0 指的是本地的还是??中国企业信息网中国企业网怎么样支付宝是什么什么是支付宝? 请详细介绍.Aliasedinternal三友网三友联众集团怎么样？正大天地网二三线城市适合做生鲜b2b电商吗