DB37-T 3522-2019政务信息资源　数据交换规范

ICS 35.240L72

DB37山 东 省 地 方 标 准DB37/T3522—2019政务信息资源数据交换规范Governmentinformationresources—Datasharedexchangespecification20192019032120190421山东省市场监督管理局发布目 次前言 II范围 1规性用1定和1缩1交方式 22务2表4件4交流程 5流程 5表6件表6件67交安全 6附录A（范附）口用回定义 8附录B（料附）务口述息示例 9参考10前 言本标准按GB/T1.1—2009给出的规则起草。本标准由山东省大数据局提出、归口并监督实施。（政务信息资源数据交换规范范围本标准规定了政务信息资源的交换方式、交换流程和交换安全要求。本标准适用于政务信息资源的数据交换。GB/T3304—1991中国各民族名称的罗马字母拼写法和代码GB/T2261.1—2003个人基本信息分类与代码第1部分：人的性别代码DB37/T3520—2019政务数据资源体系总体架构DB37/T3521.1—2019政务信息资源目录第1部分：编码规则下列定义和术语适用于本文件。下列定义和术语适用于本文件。3.1政务信息资源governmentaffairsinformationresources[DB/T3520—2019，定义3.1]3.2信息资源代码informationresourcecode用于唯一标识政务信息资源的一组字符。[DB/T3521.1—2019，定义3.3]3.3交换exchange信息资源提供方和信息资源需求方间通过政务信息资源共享交换平台实现政务信息资源在线传送的过程。4缩略语下列缩略语适用于本文件。HTTP：超文本传输协议(HypertextTransferProtocal)HTTPS(SecureHypertextTransferProtocal)WSDL：Web(WebServicesDescriptionLanguage)SOAPSimpleObjectAccessProtocol)RESTRepresentationalStateTransfer)Utf-8：Unicode的可变长度字符编码(8-bitUnicodeTransformationFormat)概述（（）（服务接口设计的基本原则包括但不限于：服务接口设计的基本原则包括但不限于：接口分为查询类、验证类、数据传输类、下载类及其他类，接口分类代码见表1。表1接口分类代码代码分类名称1查询类2验证类3数据传输类4下载类9其他类1。图1服务接口代码结构服务接口代码编码规则如下：112～1312DB37/T3521.1—201912000001000001～999999999999；1411～节；15～16201～99。服务接口技术要求包括但不限于：HTTP/HTTPS1.0/1.1SOAP1.1/1.2HTTP1.0/1.1WSDL1.1、SOAP1.1/1.2IPWebServiceRESTRESTRESTApiKey。RESTHeaderAppKey、AppSecret、ApiKeyApiSecret，POSTBodyApplication/JSONWebServiceHeaderBodyUtf-8xml、JSONA。B。应通过共享交换平台分配的接口密钥、访问令牌等方式对调用服务申请进行授权验证。库表交换要求包括但不限于：数据导入方式，仅适用于结构化数据。对于非结构化数据，无交换格式限制。对于结构化数据，应支持txt总流程基于共享交换平台的资源共享交换总流程见图2，包括但不限于：图2交换总流程图2交换总流程服务接口交换流程包括但不限于：库表资源交换流程包括但不限于：文件资源交换流程包括但不限于：7交换安全政务资源交换安全要求包括但不限于：a)应对提供方和需求方进行身份和权限验证，避免非法请求；附录A（）服务接口调用返回码定义见表A.1。表A.1接口调用返回码定义序号返回码返回码描述1200请求成功，请求所希望的响应头或数据体将随此响应返回。2300请求失败，程序执行异常或失败，无法返回正确的响应结果。3400错误请求。4403请求成功，服务器已经理解请求，但无权限而拒绝执行它。5404请求失败，请求所希望得到的资源未被在服务器上发现。6500请求失败，服务器遇到了一个未曾预料的状况，导致了它无法完成对请求的处理。7504请求超时。附录B（资料性附录）服务接口描述信息填写示例用户信息查询接口描述信息填写示例见表B.1。表B.1用户信息查询接口描述信息填写示例接口概述通过公民身份号码、姓名、性别，在人口库中定位人员信息，并将该人的性别、民族、出生日期、出生地信息和死亡标识进行反馈。接口名称省公安厅人口信息查询接口接口分类查询类接口方式WebService接口地址http://80:443/gateway/1/sgatxxcx接口授权资源提供方授权接口方法cxreceiveRequest输入（业务请求参数说明）参数名参数说明类型约束sfzh公民身份证号码字符型必填xm姓名字符型必填xb性别，性别的标识代码按GB/T2261.1—2003的规定取值字符型必填输出（业务返回参数）参数名参数说明类型备注sfzh公民身份证号码字符型非空项xm姓名字符型非空项xb性别，性别的标识代码按GB/T2261.1—2003的规定取值字符型非空项mz民族，民族的标识代码按GB/T3304-1991的规定取值字符型非空项csrq出生日期字符型非空项csd出生地，国家-省-市-县-详细