DB3704T 0042-2024 电子证照共享服务平台证照数据对接技术规范_第1页
DB3704T 0042-2024 电子证照共享服务平台证照数据对接技术规范_第2页
DB3704T 0042-2024 电子证照共享服务平台证照数据对接技术规范_第3页
DB3704T 0042-2024 电子证照共享服务平台证照数据对接技术规范_第4页
DB3704T 0042-2024 电子证照共享服务平台证照数据对接技术规范_第5页
已阅读5页,还剩48页未读 继续免费阅读

下载本文档

版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领

文档简介

ICS35.020CCSL80枣 庄 市 地 方 标 准DB3704/T0042-2024电子证照共享服务平台证照数据对接技术规范2024-03-27发布 2024-04-27实施枣庄市市场监督管理局 发布DB3704/T0042DB3704/T0042—2024目 次前 言 1电子证照共享服务平台证照数据对接技术规范 2范围 2规范性引用文件 2术语和定义 2公用服务 5接口使用须知 5对接须知 5接口列表 5字典数据 43持证主体代码类型代码 43接口返回值列表 44证照类型列表 44DB3704/T0042DB3704/T0042—2024PAGEPAGE27前 言本文件按照GB/T1.1-2020《标准化工作导则第1部分:标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由枣庄市大数据局提出、归口并组织实施。本文件起草单位:枣庄市大数据中心、南威软件股份有限公司。本文件主要起草人:陈夫真、赵瑞欣、赵荣、陈亚楠、郗金鑫、苗媛媛、王振、孙竹梅、韩帮冉、褚萌、马亮。本文件为首次发布。电子证照共享服务平台证照数据对接技术规范范围本规范的阅读对象是业务系统的软件开发人员、各项目管理与开发人员。本规范部分接口配套提供基础的调试DEMO,开发人员可根据实际情况自行扩展DEMO。规范性引用文件(包括所有的修改单适用于本文件。GB∕T36901-2018电子证照总体技术架构GB∕T36902-2018电子证照目录信息规范GB∕T36903-2018电子证照元数据规范GB∕T36904-2018电子证照标识规范GB∕T36905-2018电子证照文件技术要求GB∕T36906-2018电子证照共享服务接口规范ZWFWC0123-2018国家政务服务平台证照类型代码及目录信息ZWFWC0124-2018国家政务服务平台电子证照跨区域共享服务接入要求术语和定义GB∕T36901-2018、GB∕T36902-2018、GB∕T36903-2018及GB∕T36904-2018界定的以及下列术语和定义适用于本文件。证照由机关、团体、企事业单位颁发的,能够证明资格或权利等的凭证类文件。注:证照包括证件和执照等。[来源:GB/T36901-2018,3.1]接口角色及分类电子证照由计算机等电子设备形成、传输和存储的证照数据文件。GB/T36901-2018,3.3]证照照面电子证照可视内容的直接表现形式,包含图像和文字信息两种形式,与实体证照保持一致。电子证照文件[来源:GB/T36901-2018,3.4]证照目录信息揭示电子证照文件主要内容和形式特征的条目信息集合,是证照管理、共享和服务的基本工具。XML可扩展置标语言(eXtensibleMarkupLanguage)。Base64编码Base64内容传送编码被设计用来把任意序列的8位字节描述为一种不易被人直接识别的形式。JSON格式JSON(JavaScriptObjectNotation)是一种轻量级的数据交换格式。易于人阅读和编写,可以在多种语言之间进行数据交换。同时也易于机器解析和生成。TokenRESTful一般指REST,即表述性状态传递(英文:RepresentationalStateTransfer,简称REST)是一种OAuth2.0HTTP服务商之间的被批准的交互动作代表用户,要么允许第三方应用代表用户获得访问的权限。同时为Web应用,桌面应用和手机,和起居室设备提供专门的认证流程。唯一凭证KEY:接口传输中用与标识身份的签名字段;凭证密钥:与凭证一起使用,用于确认接口调用者身份。认证机制4.3.1编码格式数据的接收与发送统一使用UTF-8编码。数据规约接口数据传输使用JSON格式,数据的提交使用HTTP协议的POST标准。数据返回包含有消息头head如下示例:{"head":{"message":"获取成功","status":0},"data":{"total":0,"data":[]}}。服务类型电子证照国标共享服务:根据电子证照国家标准中的共享服务接口规范提供的相关接口。服务方式推荐通过共享服务系统发布为Webservice或RESTful服务;b)RESTful服务直接调用。公用服务接口使用须知电子证照共享服务接口以GB/T36901-2018中指出的电子证照系统与业务系统之间的交互关系为应用场景,电子证照系统是共享服务的提供方,业务系统是共享服务的调用方。对接须知由业务部门向共享平台申请接口权限,审批后接口发给电子证照项目组开通权限;系统根据部门申请信息分配username(访问标识)、password(应用认证信息),并邮件发送至对接单位的相关人员;业务部门对接时向电子证照项目组索要访问地址的IP和port端口号。接口列表用户身份验证接口接口说明:此接口用于获取access_token串,其他接口都需要此接口返回的token作为入参。调用路径:http://ip:port/license-api-release/oauth/token接口调用请求说明:http请求方式:POSThttp请求方式:POST参数说明:参数是否必须说明client_id是固定值为:xxxx-oauthclient_secret是固定值为:xxxx-mobilegrant_type是固定值为:passwordscope是固定值为:readwriteusername是用户名(见4.2对接须知)password是密码(见4.2对接须知)返回说明:返回access_token串。使用返回的access_token的值做为其他接口的access_token的入参值。(有效期12小时),调用方使用该身份验证串就可以调用相应权限的接口。证照共享相关接口。{"access_token":"f54922eb-62da-43df-acee-c2e7d69b0a9c","token_type":"bearer","refresh_token":"bc2d74f1-88ad-42ad-af9d-12b4d57d16bf","expires_in":43199,"scope":"readwrite"}证照标识获取下载地址接口接口说明:根据电子证照标识和事由、有效期等信息生成电子证照加注件并返回下载地址,同时该下载地址有时效控制,默认10分钟。调用路径:http://ip:port/license-api-release/m/v/license/external/api/ShareDownloadUrl接口方式HTTP+JSON请求方式:POST编码类型:UTF-8调用参数参数名称类型是否必填描述信息access_tokenString是访问标识certificateIDString是电子证照标识(证照持有主体代码获取证照信/二维码获取证照信息接口有返回此值)expiryTimeString否电子证照加注件有效期截止时间,格式“yyyy-MM-dd”,如“2021-08-26”certificateSystemNameString是系统名称,如:XXXX服务平台certificateCallCategoryString是调用类别,0标识事项调用,1标识非事项调用certificateMatterNameString是事项名称,如:个人参保缴费证明查询打印certificateEventCodeString是事项编码(暂时定义“实施编码”,如:1137000000450258552372014020002certificateCopyCauseString是申请事由,不超过200字,如:个人参保缴费证明查询打印,需要用到身份证数据callDistrictString否(市(庄区、山亭区、滕州市)callDepartmentString否调用部门districtLevelString否区(市)级别(市级、区级、街镇级)省级接口返回结果说明:当返回结果为省级接口返回数据时如下:{"head":{"message":"接口调用成功!","type":"1","status":"0"},"data":{"total":1,"dataList":[{"certIdentifier":"005.2.1110000000001332XW002.11370000004504679L.3F354BEBEE9D4D1C8AACDD820D9A6DF8.001.O","contentType":"http","content":"http://ip:port/CertShare/zzgxpt/download?id=fe7d0b138e6848bc88268a950aa6d005"}]}}失败返回:{"head":{"message":"接口调用失败!","status":"2"},"data":"证照源未提供此服务接口"}返回参数说明字段名称字段类型描述head.statusint错误码;0.成功;其他.失败,详见5.2接口返回值列表head.typeString1为省级接口查询返回结果数据,2为市级接口查询返回结果数据head.messageString返回结果说明totalint数量dataList.contentTypeString取值为“http”或“https”dataList.certIdentifierStringGB∕T36904-2018dataList.contentStringGB/T36905-2018urlurlpdf。市级接口返回结果说明当返回结果为市级接口返回数据时如下:{"head":{"message":"接口调用成功","status":"0"},"data":{"total":1,"dataList":[{"issueDept":"证照颁发机构","certificateNumber":"证照编号","fileUrl":"http://ip:port/license-api-release/elssp/v1/download_national?fileId=emZ2M3Jwd0EwTlFqSjRlSzBpZUI3nlLU0ZoUTlLdHVmR3RRTGhrTEZhTUZaN1VOa2xHRWtFODR4QWVTS1FnNg==&fileFormat=OFD","issueDate""20130924}]}}返回参数说明字段名称字段类型描述head.statusint错误码:0.成功;其他.失败(详见5.2接口返回值列表)head.messageString返回结果说明totalint数量dataList.issueDeptString证照颁发机构dataList.certificateNumberString证照编号dataList.fileUrlStringGB/T36905-2018dataList.issueDateString证照颁发日期dataList.fileFormatString证照文件格式dataList.CertificateTypeString证照类型名称证照标识获取证照信息接口接口说明根据电子证照标识获取该证照的信息内容。调用路径:http://ip:port/license-api-release/m/v/license/external/api/ShareQueryCertInfo接口方式HTTP+JSON请求方式POST编码类型UTF-8调用参数参数名称类型是否必填描述信息access_tokenString是访问标识certificateIDString是电子证照标识(证照持有主体代码获取证照信息接口/二维码获取证照信息接口有返回此值)interfaceTypeString否0调用省接口,1调用市接口默认0certificateSystemNameString是系统名称certificateCallCategoryString是调用类别0标识事项调用,1标识非事项调用certificateMatterNameString是事项名称certificateEventCodeString是事项编码(暂时定义“实施编码”)certificateCopyCauseString是申请事由,不超过200字callDistrictString否(市(庄区、山亭区、滕州市)callDepartmentString否调用部门districtLevelString否区(市)级别(市级、区级、街镇级)省级接口返回结果说明返回结果如下:{"head":{"message":"接口调用成功!","type":"1","status":"0"},"data":{"total":1,"dataList":[{"certno":"37082619880XXXXXXX","gmsfhm":"37082619880XXXXXXX","name":"XX","cert_identifier":"005.2.11100010000013127D001.11370000004504927A.CFD93524173848F3A2ED4AB7A36E7A50.001.8"}]}}返回参数说明字段名称字段类型描述head.statusint错误码:0.成功;其他.失败(详见5.2接口返回值列表)head.typeString1为省级接口查询返回结果数据,2为市级接口查询返回结果数据head.messageString返回结果说明totalint总数量dataList[].*String电子证照照面信息,每个证照具体的返回字段市级接口返回结果说明当返回结果为市级接口返回数据时如下:{"head":{"message":"接口调用成功","status":"0"},"data":{"total":1,"dataList":[{"certificateHolder":"陈xx","certificateValidateStart""20130923"certificateValidateEnd"20160922XXXX"12370400F49201558F","certificateHolderCode":"37040319XXXX1209","detail":[],"issueDate""20130923"digitalSign"certificateType":"中国XXXX操作证书"}]}}返回参数说明字段名称字段类型描述head.statusint错误码:0.成功;其他.失败(详见5.2接口返回值列表)head.messageString返回结果说明totalint总数量dataList[].*String电子证照照面信息,每个证照具体的返回字段证照类型代码验证证照信息接口接口说明根据持证主体代码、证照类型代码以及其他指定的证照信息内容,查验电子证照有效性。调用路径:http://ip:port/license-api-release/m/v/license/external/api/ShareVerifyCertInfo接口方式HTTP+JSON请求方式POST编码类型UTF-8调用参数参数名称类型是否必填描述信息access_tokenString是访问标识certTypeCodeString是证照类型代码,参考附件5.3证照类型代码表certificateDataString是要查验的电子证照数据json字符串,在对接时由各业务单位提交验证字段申请,由电子证照系统后台配置。useForString是申请事由,不超过200字certificateHolderCodeString是)interfaceTypeString否0调用省接口,1调用市接口默认0callDistrictString否调用区(市(市中区、薛城区、峄城区、台儿庄区、山亭区、滕州市)callDepartmentString否调用部门districtLevelString否区(市)级别(市级、区级、街镇级)省级接口返回结果说明返回结果如下:{"head":{"message":"接口调用成功!","type":"1","status":"0"},"data":{"total":1,"dataList":[{"result":0,"message":"信息正确且有效"}]}}返回参数说明字段名称字段类型描述head.statusint错误码:0.成功;其他.失败(详见5.2接口返回值列表)head.typeString1为省级接口查询返回结果数据,2为市级接口查询返回结果数据head.messageString返回结果说明Data.totalint总数量data.dataList[].resultString校验结果,返回0表示校验正确,其他值表示失败data.dataList[].messageString校验结果说明,与校验结果代码对应的文字说明,如:“0”:“信息正确且有效”;“12“34“5市级接口返回结果说明当返回结果为市级接口返回数据时如下:{"head":{"message":"接口调用成功","status":"0"},"data":{"verifyResult":"true"}}返回参数说明字段名称字段类型描述head.statusint错误码:0.成功;其他.失败(详见5.2接口返回值列表)head.messageString返回结果说明data.verifyResultString校验结果,返回true表示校验正确,其他值表示失败证照类型代码验证证照文件接口接口说明根据提供的电子证照原件或加注件,验证电子证照文件真实性、电子证照文件完整性及电子证照有效性。调用路径:http://ip:port/license-api-release/m/v/license/external/api/ShareVerifyCertInfo接口方式HTTP+JSON请求方式POST编码类型UTF-8调用参数参数名称类型是否必填描述信息access_tokenString是应用认证信息certTypeCodeString是证照类型代码,参考5.3证照类型代码表contentTypeString是固定为base64。contentString是Base64字符串,解码后的内容应符合GB/T36905-2018的要求useCauseString是申请事由,不超过200字interfaceTypeString否0调用省接口,1调用市接口callDistrictString否市(区、滕州市)callDepartmentString否调用部门districtLevelString否区(市)级别(市级、区级、街镇级)返回结果如下:{"head":{"status":0,"message":"接口调用成功"},"data":"04D4FB95943B9E0419390A37B48A6F2805F9091……"}返回结果说明字段名称字段类型描述head.statusint错误码:0.成功;其他.失败(详见5.2接口返回值列表)head.messageString返回结果说明data.resultString校验结果,返回0表示验证通过,其他值表示失败data.messageString校验结果说明,与校验结果代码对应的文字说明,如:“0”:“验证通过”;“““““二维码获取证照信息接口接口说明根据证照二维码获取该证照的信息内容。调用路径:http://ip:port/license-api-release/m/v/license/external/api/ShareQueryCertInfoByQRcode接口方式HTTP+JSON请求方式POST编码类型UTF-8调用参数参数名称类型是否必填描述信息access_tokenString是应用认证信息qrValueString是二维码内容interfaceTypeString否0调用省接口1调用市接口默认0certificateSystemNameString是系统名称certificateCallCategoryString是调用类别,0标识事项调用,1标识非事项调用certificateMatterNameString是事项名称certificateEventCodeString是事项编码(暂时定义“实施编码”)certificateCopyCauseString是申请事由,不超过200字clientInfo_areaCodeString否接入系统所属区号clientInfo_deptCodeString否接入系统部门编号clientInfo_operNameString否业务操作员姓名deptNameString否接入系统部门名称whoseString否证照主体(0-个人;1-法人)categoryString否证照类型(1-证照;0-批文)licenseTypeCodeString否证照类型代码operUserNameString否操作人员名称operTimeString否操作时间operUserIpString否操作IP地址callDistrictString否调用区(市(市中区、薛城区、峄城区、台儿庄区、山亭区、滕州市)callDepartmentString否调用部门districtLevelString否区(市)级别(市级、区级、街镇级)省级接口返回结果说明返回结果如下:{"head":{"message":"接口调用成功!","status":"0"},"data":{"total":1,"dataList":[{"certno":"3708261988XXXX0414","gmsfhm":"3708261988XXXX0414","name":"张XX","cert_identifier":"005.2.11100000000013127D001.11370000004504927A.CFD93524173848F3A2ED4AB7A36E7A50.001.8"}]}}字段名称字段类型字段名称字段类型描述head.statusint错误码:0.成功;其他.失败(详见5.2接口返回值列表)head.typeString1为省级接口查询返回结果数据,2为市级接口查询返回结果数据head.messageString返回结果说明data.dataList[].*Stringcr_dniir(证照标识,可以凭此参数调用《证照标识获取下载地址接口》市级接口返回结果说明(1)返回结果如下:{"head":{"sign":"","time":0,"message":"查询成功","status":0},"data":{"img_sign_fileid":"5b301b493d456b397cf87187","license_name":"中国XXXX操作证书","fileNumber":"02-12370400F49201558F-5100-A000102935","issue_unitname"XXXXX"2020-11-14","licenseId":"46b820f3ed3140da864b9850d4953389","abstractCode":"5cgedf2j6","license_number":"37082619880430XXXX"}}(2)返回参数说明字段名称字段类型描述head.statusint错误码:0.成功;其他.失败(详见5.2接口返回值列表)head.typeString1为省级接口查询返回结果数据,2为市级接口查询返回结果数据head.messageString返回结果说明data.dataList[].*StringflNme证照标识数调用《证照标识获取下载地址接口》证照持有主体代码获取证照信息接口接口说明根据持证主体代码获取该证照的信息内容。调用路径:http://ip:port/license-api-release/m/v/license/external/api/ShareQueryCertInfoByHo接口方式HTTP+JSON请求方式POST编码类型UTF-8调用参数参数名称类型是否必填描述信息access_tokenString是访问标识certificateHolderCodeString是持证主体代码,如:身份证中的身份证号码certificateHolderCodeTypeString是持证主体代码类型代码,如:111公民身份证号码,001统一社会信用代码,省库数据非必填,市库数据必填certTypeCodeString是证照类型代码,参考5.3证照类型代码表certificateNumberString否证照编号certificateTypeString否证照类型名称,预留字段ModeString否查询范围,预留字段PageString否页码,预留字段SizeString否每页条数,预留字段interfaceTypeString否0调用省接口1调用市接口默认0certificateSystemNameString是系统名称certificateCallCategoryString是调用类别,0标识事项调用,1标识非事项调用certificateMatterNameString是事项名称certificateEventCodeString是事项编码(暂时定义“实施编码”)certificateCopyCauseString是申请事由,不超过200字clientInfo_areaCodeString否接入系统所属区号clientInfo_deptCodeString否接入系统部门编号clientInfo_operNameString否业务操作员姓名deptNameString否接入系统部门名称whoseString否证照主体(0-个人;1-法人)categoryString否证照类型(1-证照;0-批文)licenseTypeCodeString否证照类型代码operUserNameString否操作人员名称operTimeString否操作时间operUserIpString否操作IP地址callDistrictString否调用区(市(市中区、薛城区、峄城区、台儿庄区、山亭区、滕州市)callDepartmentString否调用部门districtLevelString否区(市)级别(市级、区级、街镇级)省级接口返回结果说明返回结果如下:{"head":{"message":"接口调用成功!","type":"1","status":"0"},"data":{"total":1,"dataList":[{"certno":"3708261988XXXX1234","gmsfhm":"3708261988XXXX1234","name":"张XX","cert_identifier":"005.2.11100000000013127D101.11370000004504927A.CFD93524173848F3A2ED4AB7A36E7A50.001.8"}]}}字段名称字段类型字段名称字段类型描述head.statusint错误码:0.成功;其他.失败(详见5.2接口返回值列表)head.typeString1为省级接口查询返回结果数据,2为市级接口查询返回结果数据head.messageString返回结果说明data.dataList[].*Stringcert_identifier(证照标识凭此参数调用《证照标识获取下载地址接口》等市级接口返回结果说明(1)返回结果如下:{"head":{"message":"接口调用成功!","status":"0"},"data":{"total":1,"dataList":[{"certificateHolder":"刘XX","certificateValidateStart""20141223"certificateValidateEnd"20171222"XXXXXX"certificateID":"02-12370400F49201558F-51-370481XXXX240910-00-A000032280","certificateNameXXXX"12370400F49201558F","certificateHolderCode":"370481XXXX240910","detail":[],"issueDate""20141223"digitalSign"certificateType":"中国XXXX操作证书"}]}}(2)返回参数说明字段名称字段类型描述head.statusint错误码:0.成功;其他.失败(详见5.2接口返回值列表)head.typeString1为省级接口查询返回结果数据,2为市级接口查询返回结果数据head.messageString返回结果说明data.dataList[].*StringcertificateID(证照标识此参数调用《证照标识获取下载地址接口》证照持有主体代码获取证照下载地址接口接口说明根据持证主体代码获取该证照的信息,根据信息生成电子证照加注件并返回下载地址,同时该下10调用路径:http://ip:port/license-api-release/m/v/license/external/api/ShareDownloadUrlsByHolderCode接口方式HTTP+JSON请求方式POST编码类型UTF-8调用参数参数名称类型是否必填描述信息access_tokenString是应用认证信息certificateHolderCodeString是持证主体代码,如:身份证中的身份证号码certificateHolderCodeTypeString是码,001统一社会信用代码,其值应遵循《GB∕T36903-2018电子证照元数据规范》,见第3.1章节certTypeCodeString是证照类型代码,参考5.3证照类型代码certificateNumberString否电子证照标识(证照持有主体代码获取证照信息接口/二维码获取证照信息接口有返回此值)certificateTypeString否证照类型名称,预留字段interfaceTypeString否0调用省接口,1调用市接口certificateSystemNameString是系统名称certificateCallCategoryString是调用类别,0标识事项调用,1标识非事项调用certificateMatterNameString是事项名称certificateEventCodeString是事项编码(暂时定义“实施编码”)certificateCopyCauseString是申请事由,不超过200字callDistrictString否调用区(市(市中区、薛城区、峄城区、台儿庄区、山亭区、滕州市)callDepartmentString否调用部门districtLevelString否区(市)级别(市级、区级、街镇级)省级接口返回结果说明返回结果如下:{"head":{"message":"接口调用成功!","type":"1","status":"0"},"data":{"total":1,"dataList":[{"certIdentifier":"005.2.11100000000013127D011.11370000004504927A.CFD93524173848F3A2ED4AB7A36E7A50.001.8","contentType":"http","content":"http://ip:port/CertShare/zzgxpt/download?id=CFD93524173848F3A2ED4AB7A36E7A50"}]}}返回参数说明字段名称字段类型描述head.statusint(5.2)head.typeString1为省级接口查询返回结果数据,2为市级接口查询返回结果数据head.messageString返回结果说明Data.totalint总数量data.dataList[].contentTypeString取值为“http”或“https”data.dataList[].certIdentifierString电子证照标识,其值遵循《GB∕T36904-2018电子证照标识规范》data.dataList[].contentString证件文件下载地址,下载后的文件是符合GB/T36905-2018的要求市级接口返回结果说明返回结果如下:{"head":{"message":"接口调用成功","status":"0"},"data":{"total":1,"dataList":[{"issueDept":"XX市XXX局","certificateNumber"(2020)XX100XXXX-02","fileUrl":"http://ip:port/license-api-release/elssp/v1/download_national?fileId=amlZSzdSVng5TmI1bFRvNjdtZTJsQU9POVVEYUg0cVIvNjBNUzh6UUVsdzBsc2E5RDlyMW9MWkVPaDNQSWxYMQ==&fileFormat=OFD","issueDate""20200406"fileFormat":"OFD","certificateType}]}}返回参数说明字段名称字段类型描述head.statusint(5.2)head.messageString返回结果说明Data.totalint总数量data.dataList[].fileUrlString证件文件下载地址,下载后的文件是符合GB/T36905-2018的要求备注:省里的身份证数据返回值是一个url,此url访问后是pdf。base64接口说明base64ofdhttp://ip:port/license-api-release/m/v/license/external/api/ShareDownloadFile接口方式HTTP+JSON请求方式POST编码类型UTF-8调用参数参数名称类型是否必填描述信息access_tokenString是访问标识,由本电子证照系统生成并告知各接口调用单位certificateIdentifierString是电子证照标识(证照持有主体代码获取证照信息接口/二维码获取证照信息接口有返回此值)certificateCopyExpiringTimeString否电子证照加注件有效期截止时间如:2021-08-26interfaceTypeString否0调用省接口,1调用市接口fileTypeString否ofd或默认是ofd文件certificateSystemNameString是系统名称certificateCallCategoryString是调用类别,0标识事项调用,1标识非事项调用certificateMatterNameString是事项名称certificateEventCodeString是事项编码(暂时定义“实施编码”)certificateCopyCauseString是申请事由,不超过200字callDistrictString否调用区(市(市中区、薛城区、峄城区、台儿庄区、山亭区、滕州市)callDepartmentString否调用部门districtLevelString否区(市)级别(市级、区级、街镇级)省市接口返回结果一致返回结果如下:{"head":{"message":"接口调用成功!","type":"1","status":"0"},"data":{"total":1,"dataList":[{"certIdentifier":"005.2.11200000000013127D001.11370000004504927A.CFD93524173848F3A2ED4AB7A36E7A50.001.8","contentType":"base64","content":"base64字符串"}]}}返回参数说明字段名称字段类型描述head.statusint(5.2)head.typeString1为省级接口查询返回结果数据,2为市级接口查询返回结果数据head.messageString返回结果说明data.dataList[].totalint总数量data.dataList[].contentTypeString取值为“http”或“https”data.dataList[].certIdentifierString电子证照标识,其值遵循《GB∕T36904-2018电子证照标识规范》data.dataList[].contentString36905-2018base64jpg市数据返回:base64字符串,解码后的内容符合GB/T36905-2018的要求市电子证照库新增数据到省电子证照库的通知接口接口说明通过证照文件标识通知市电子证照平台将电子证照数据新增到省电子证照平台。应用场景调用路径:http://ip:port/license-api-release/m/v/license/external/api/insertToProvince接口方式HTTP+JSON请求方式POST编码类型UTF-8调用参数参数名称类型是否必填描述信息access_tokenString是访问标识,由本电子证照系统生成并告知各接口调用单位fileNumberString是文件标识,获取方式:成功调用本文档中的<4.2.4电子证照照面信息提交接口>的返回结果中的fileNumber返回结果如下:{"head":{"message":"接口调用成功","status":"0"},"data":{"total":1,"dataList":[{"certIdentifier":"005.2.11100000000013338W006.113704000042365553.VK33PZ9TY58L.001.9"}]}}返回参数说明字段名称字段类型描述head.statusint(5.2)head.messageString返回结果说明data.dataList[].totalint总数量data.dataList[].certIdentifierString电子证照标识,其值遵循《GB∕T36904-2018电子证照标识规范》市电子证照库编辑数据到省电子证照库的通知接口接口说明通过证照文件标识和省电子证照标识通知市电子证照平台将已归集到省电子证照平台的数据进行编辑操作。应用场景调用路径:http://ip:port/license-api-release/m/v/license/external/api/updateToProvince接口方式HTTP+JSON请求方式POST编码类型UTF-8调用参数参数名称类型是否必填描述信息access_tokenString是访问标识,由本电子证照系统生成并告知各接口调用单位fileNumberString是文件标识,获取方式:成功调用本文档中的<4.2.4电子证照照面信息提交接口>的返回结果中的fileNumbercertIdentifierString是电子证照标识,其值遵循《GB∕T36904-2018电子证照标识规范》两种获取方式:第一种调用4.3.7证照持有主体代码获取证照信息接口取返回结果中的cert_identifier第二种调用4.3.10市到省数据归集新增接口取返回结果中的cert_identifier返回结果如下:{"head":{"message":"接口调用成功!","status":"0"},"data":null}返回参数说明字段名称字段类型描述head.statusint错误码:0.成功;其他.失败(详见5.2接口返回值列表)head.messageString返回结果说明市电子证照库作废数据到省电子证照库的通知接口接口说明通过证照文件标识通知市电子证照平台将已归集到省电子证照平台的数据进行作废操作。应用场景调用路径:http://ip:port/license-api-release/m/v/license/external/api/deleteToProvince接口方式HTTP+JSON请求方式POST编码类型UTF-8调用参数参数名称类型是否必填描述信息access_tokenString是访问标识,由本电子证照系统生成并告知各接口调用单位fileNumberString是文件标识,获取方式:成功调用本文档中的<4.2.4电子证照照面信息提交接口>的返回结果中的fileNumber返回结果如下:{"head":{"message":"接口调用成功!","status":"0"},"data":null}返回参数说明字段名称字段类型描述head.statusint(5.2)head.messageString返回结果说明证照持有主体代码获取证照信息和省市数据存在情况接口接口说明根据持证主体代码获取该证照的信息内容和此条数据在省电子证照平台、市电子自证照的存在情况。调用路径:http://ip:port/license-api-release/m/v/license/external/api/shengShiStateInfo接口方式HTTP+JSON请求方式POST编码类型UTF-8调用参数参数名称类型是否必填描述信息access_tokenString是访问标识certificateHolderCodeString是持证主体代码,如:身份证中的身份证号码certificateHolderCodeTypeString是持证主体代码类型代码,如:111公民身份证号码,001统一社会信用代码,省库数据非必填,市库数据必填certTypeCodeString是证照类型代码,参考5.3证照类型代码表certificateNumberString否证照编号如果同一个持证主体代码和证照类型代码下有存在情况certificateTypeString否证照类型名称,预留字段ModeString否查询范围,预留字段PageString否页码,预留字段SizeString否每页条数,预留字段interfaceTypeString否0调用省接口1调用市接口默认0certificateSystemNameString是系统名称certificateCallCategoryString是调用类别,0标识事项调用,1标识非事项调用certificateMatterNameString是事项名称certificateEventCodeString是事项编码(暂时定义“实施编码”)certificateCopyCauseString是申请事由,不超过200字clientInfo_areaCodeString否接入系统所属区号clientInfo_deptCodeString否接入系统部门编号clientInfo_operNameString否业务操作员姓名deptNameString否接入系统部门名称whoseString否证照主体(0-个人;1-法人)categoryString否证照类型(1-证照;0-批文)licenseTypeCodeString否证照类型代码operUserNameString否操作人员名称operTimeString否操作时间operUserIpString否操作IP地址callDepartmentString否调用部门districtLevelString否区(市)级别(市级、区级、街镇级)省级接口返回结果说明返回结果分四种情况,如下:1{"head":{"shengIsExists":"0","shiIsExists":"0","message":"接口调用成功","status":"0"},"data":null}2{"head":{"shengIsExists":"1","shiIsExists":"0","message":"接口调用成功!","status":"0"},"data":{"total":1,"dataList":[{"fzjg":"XX市行政审批服务局","creditcode":"910XXXXXXXX3P038","fundtype":"XX测试","zzyxqqsrq":"2022-04-15","ft1":"/bz/open/qrdetail/license?licenseNo=005.2.11100000000013338W008.XXXXXXXXXXXXXXXXX.AF96FA0FADA24B018FBF0A6E2CEB1FA9.001.H","issuingOrg":"XX市行政审批服务局","orgcode":"1","gmt_modified":"2022-04-2215:47:02.0","certholdercode":"910XXXXXXXX3P038","orglevel":"XX测试","xxdz":"XX测试","zzyxqjzrq":"2027-04-14","certno"XX20220415","ownersfzhm"yxq":"2022-04-15","orgname":"XX测试核验","certholder":"XX测试核验","zzbfrq":"2022-04-15","bz":"XX测试","cert_identifier":"005.2.11100000000013338W008.XXXXXXXXXXXXX.68QZNXENRXK.001.R"}]}}3{"head":{"shengIsExists":"0","shiIsExists":"1","message":"接口调用成功!","status":"0"},"data":{"total":1,"dataList":[{"fileNumber":"005.2.11100000000013338W004.XXXXXXXXXXXXXX.2SDFIBQ76NZYZP3BEN8G.001.L"}]}}4{"head":{"shengIsExists":"1","shiIsExists":"1","message":"接口调用成功!","status":"0"},"data":{"total":1,"dataList":[{"fzjg""XX:"有限责任公司","ft1"https://www.XXX.com/","zzyxqqsrq":"2022-04-13","fileNumber":"005.2.11100000000013338W004.XXXXXXXXXXXXX.N8MBXV8HXMCUED43VBHT.001.A","orgcode":"113704000042365553","certholdercode":"9137XXXXXXDRNW79","orglevel":"甲级","areacode":"370401","xxdz"XXXX"ZMBZDW"XX"zzyxqjzrq""2027-04-12","certno":"20220413","yxq":"1825","orgnameXXXXXXXXXXXXXX"XXXX"zzbfrq":"2022-04-13","bz":"无","fddbr":"马XX","cert_identifier":"005.2.11100000000013338W004.XXXXXXXXXXXXXX.CSXNL73MHWAJ.001.2"}]}}返回参数说明字段名称字段类型描述head.statusint错误码:0.成功;其他.失败(详见5.2接口返回值列表)head.messageString返回结果说明head.shengIsExistsString省库是否存在(0-不存在;1-存在)head.shiIsExistsString市库是否存在(0-不存在;1-存在)data.dataList[].*Stringcr_dniir(证照标识,可以凭此参数调用《证照标识获取下载地址接口》等PDFBase64接口说明PDFBase64http://ip:port/license-api-release/m/v/license/external/api/downloadPdfFile接口方式HTTP+JSON请求方式POST编码类型UTF-8调用参数参数名称类型是否必填描述信息access_tokenString是访问标识abstractCodeString是证照提取码省级接口返回结果说明返回结果如下:{"head":{"message":"接口调用成功!","status":"0"},"data":{"total":1,"dataList":["Base64编码"]}}返回参数说明字段名称字段类型描述head.statusint错误码:0.成功;其他.失败(详见5.2接口返回值列表)head.messageString返回结果说明data.dataList[].*StringPDFBase64编码字典数据持证主体代码类型代码序号持证主体类别类别细分持证主体代码类型代码1法人和其他组织法人和其他组织统一社会信用代码0012其他法人或其他组织有效证件代码0993自然人一般居民公民身份号码1114军人中国人民解放军军官证编号1145中国人民武装警察部队警官证编号1156中国人民解放军士兵证编号1187中国人民武装警察部队士兵证编号1198中国人民解放军文职人员证编号1209中国人民武装警察部队文职人员证编号12210华侨和外籍人士外交护照护照号41111公务护照护照号41212公务普通护照护照号41313普通护照护照号41414台湾人士台湾居民来往大陆通行证号码51115港澳人士港澳居民来往内地通行证号码51616其他自然人有效证件代码999接口返回值列表返回值编码编码描述0接口调用成功1第三方接口连接超时2证照源未提供此服务接口10未找到匹配的证照信息11身份验证不通过12要求必填的输入参数值为空13证照类型不存在或未发布14错误的持证主体代码类型21该电子证照已废止或已注销22该电子证照已过期23该电子证照已受限使用24申请查验的证照数据无法解析99其他异常199应用理由未按照规范填写,请阅读接口文档进行修改证照类型列表序号证照名称证照类型代码1中华人民共和国结婚证1110000000001314330012基金会法人登记证书1110000000001314330073律师工作证11100000000013151X0164司法鉴定人执业证11100000000013151X0075山东省老年人优待证1210000000001805920016融资性担保机构经营许可证12100000717804719J0017水生野生动物经营利用许可证1110000000001326640508水生野生动物人工繁育许可证1110000000001326640519国产电视剧发行许可证11100000MB0372496N01410律师事务所执业许可证11100000000013151X01011特种设备安全管理人员证11100000MB0143028R07212残疾人证13100000000018040200313事业单位法人证书11100000000018526500114中华人民共和国离婚证11100000000013143300215社会团体法人登记证书11100000000013143300816律师执业证11100000000013151X00917食品生产许可证11100000MB0143028R02518建筑施工特种作业人员操作资格证书11100000000013338W03219药品经营许可证11100000MB0341032Y00220食品经营许可证11100000MB0143028R02621出生医学证明11100000717836972700122医师执业证书11100000717836972700823护士执业证书11100000717836972701024医疗机构执业许可证11100000717836972700525采矿许可证11100000MB0327169900326药品生产许可证11100000MB0341032Y00127气瓶充装许可证11100000MB0143028R07028医疗器械经营许可证11100000MB0341032Y04329建筑业企业资质证书11100000000013143300730中华人民共和国居民身份证11100000000013127D00131不动产登记证明11100000MB0327169902232成品油零售经营批准证书11100000000013223N03233中华人民共和国不动产权证11100000MB0327169900134计量标准考核证书11100000MB0143028R00835检验检测机构资质认定证书11100000MB01430

温馨提示

  • 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
  • 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
  • 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
  • 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
  • 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
  • 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
  • 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。

评论

0/150

提交评论