DB3308T 084-2021 部门联合奖惩系统数据接口技术规范

CCSL65DB3308衢州市市场监督管理局发布IDB3308/T084—2021前言 2规范性引用文件 3术语和定义 4数据交换方式 5数据接口功能建设 6数据接口规范 7数据安全要求 附录A（资料性）接口返回示例 参考文献 DB3308/T084—2021本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利，本文件的发布机构不承担识别专利的责任。本文件由衢州市营商环境建设办公室提出并归口。本文件主要起草单位：衢州市营商环境建设办公室、金电联行（北京）信息技术有限公司、衢州市大数据中心、浙江省方大标准信息有限公司。本文件主要起草人：曹云、许敬群、李文阳、谢毓晗、傅文涛、陈旭文、陈群、黄健民、祁劲松、王春聪、魏春梅。1DB3308/T084—2021部门联合奖惩系统数据接口技术规范本文件规定了部门联合奖惩系统的数据交换方式、数据接口功能建设、数据接口规范、数据安全要本文件适用于市级信用信息共享平台联合奖惩系统、统建业务办理系统、部门自建业务办理系统之间的信用数据交换与共享。2规范性引用文件本文件无规范性引用文件。3术语和定义下列术语和定义适用于本文件。3.1HTTPS协议HyperTextTransferProtocolSecure通过计算机网络进行安全通信的传输协议，又称超文本传输安全协议。4整体架构与数据来源4.1整体架构部门联合奖惩系统基于浙江省公共信用信息平台下放的公共信用产品接口，二次封装接口后发布至衢州公共数据服务管理平台，再由各部门自建统建系统申请接口后嵌入自身业务流程中实现协同应用，数据交换架构图见图1。2接口注册/发布人力社保台公积金管公共资源交易平台统一权力运行系统部门联合奖惩系统数据来源于以下两个方面：自建统建系统。3DB3308/T084—20216.1.1二次封装接口应采用IP白名单、请求密钥定时更新等安全策略，防止信用信息泄漏。6.1.2应保持省信用平台接口推送数据、应用系统反馈数据在二次封装接口转发中的完整性。6.1.3应用系统应独立向省信用平台申请信用接入码。6.1.4二次封装接口添加个性化数据的，接口调用不应影响省信用平台接口执行效率。6.1.5二次封装接口应具备异常管理模块，地市应用系统在接口调用发生错误时，能明确提供错误产生的原因与处理方式。6.2功能要求6.2.1接口基本功能包括以下内容：a)实时转发省平台推送数据及各应用系统反馈数据；b)对省平台推送的数据及各应用系统反馈的数据进行归集、整理、存储。6.2.2信用核查与反馈功能包括以下内容：a)业务系统应在审批全流程嵌入信用核查功能；b)具备信用核查按钮，展示信用核查页面；c)每次调用核查接口均应反馈核查措施（可由系统默认反馈），若未反馈，应提示用户；d)在办结环节验证本办件是否已完成核查反馈，未反馈的办件应提示用户；e)信用核查页面按省公共信用信息平台页面设计规范设置。6.2.3批量核查与反馈功能包括以下内容：a)具备信用核查按钮，展示信用核查页面；b)每次调用核查接口均应反馈核查措施（可由系统默认反馈），若未反馈，应提示用户；c)信用查询页面按省公共信用信息平台页面设计规范设置。6.2.4容缺承诺与反馈功能包括以下内容：a)每次调用承诺接口应保证之后调用反馈接口，反馈数据；b)定期验证本办件是否已完成容缺反馈，未反馈的办件应提示办件人员。7数据接口规范7.1信用核查接口7.1.1接口功能用于返回信用主体的信用状况信息，接口返回本次核查的核查编码（核查编码唯一）和信用状况信息JSON格式的数据。数据中包含信用主体的企业信用状况、企业信用提示、企业信用档案链接、法人信用状况、法人信用提示、法人信用档案链接、红黑名单奖惩措施信息。4DB3308/T084—20217.1.2接口参数接口参数及说明见表1。表1是是是是是是是是7.1.3返回示例返回示例见附录A中表A.1。7.2核查反馈接口7.2.1接口功能用于核查和奖惩结果反馈，根据核查编码反馈核查或奖惩后的结果状态。7.2.2接口参数接口参数见表2。是否是多个措施使用“$”分隔，例如：“01$02”是5DB3308/T084—20217.2.3返回示例返回示例见附录A中表A.2。7.3核查状态接口7.3.1接口功能用于各系统在办结环节强制调用接口时，确认核查结果是否已反馈。7.3.2接口参数接口参数见表3。是7.3.3返回示例返回示例见附录A中表A.3。7.4批量核查接口7.4.1接口功能用于返回信用主体的信用状况信息，接口返回本次核查的核查编码（核查编码唯一）和信用状况信息JSON格式的数据。JSON数据中包含各信用主体的信用状况、信用档案链接、信用信息。7.4.2接口参数接口参数见表4。是是是是6DB3308/T084—2021是7.4.3返回示例返回示例见附录A中表A.4。7.5批量核查反馈接口7.5.1接口功能用于返回信用主体的信用状况信息，接口返回本次核查的核查编码（核查编码唯一）和信用状况信息JSON格式的数据。JSON数据中包含各信用主体的信用状况、信用档案链接、信用信息。7.5.2接口参数接口参数见表5。是多个措施使用“$”分隔，例如：“01$02”是7.5.3返回示例返回示例见附录A中表A.5。7.6容缺承诺接口7.6.1接口说明用于向省/市信用平台推送承诺书数据。7.6.2请求参数接口参数见表6。7DB3308/T084—2021"patchDate":"承诺日期："patchTimeLimitUnit"",是7.6.3返回示例返回示例见附录A中表A.6。7.7容缺承诺反馈接口7.7.1接口功能用于向省/市信用平台推送承诺履约情况数据7.7.2请求参数接口参数见表7。8DB3308/T084—2021是是是7.7.3返回示例返回示例见附录A中表A.7。8数据安全要求8.1访问控制请求方使用刷新秘钥定时获取刷新秘钥和请求秘钥。8.2数据授权控制数据获取由衢州公共数据服务管理平台进行授权访问。8.3数据交互量控制在数据接口交换时，由数据交换系统双方根据业务需求进行数据交互量限制。9DB3308/T084—2021接口返回示例A.1信用核查接口返回示例以JSON格式返回结果数据，格式定义如下：表A.1{"creditLevel":"信用等级{}{{{DB3308/T084—2021]]}}A.2核查反馈接口返回示例核查反馈接口以JSON格式返回结果数据，格式定义如下：表A.2{}A.3核查状态接口返回示例以JSON格式返回结果数据，格式定义如下：表A.3{}DB3308/T084—2021A.4批量核查接口返回示例以JSON格式返回结果数据，格式定义如下：表A.4{{[{[{]{[{DB3308/T084—2021[{]}{{]}}A.5批量核查反馈接口返回示例以JSON格式返回结果数据，格式定义如下：表A.5{"result":"success/error","resultMsg":"提示文字"}DB3308/T08