DB14-T 2831-2023 商务诚信公共服务平台信息交换接口规范

ICS03.080.99CCSA2014IDB14/T2831—2023前言 2规范性引用文件 3术语和定义 4缩略语 5接口类型 6接口服务 27技术要求 68管理要求 79持续优化 7附录A（资料性）接口示例 9DB14/T2831—2023本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。本文件由山西省商务厅提出、组织实施和监督检查。山西省市场监督管理局对标准的组织实施情况进行监督检查。本文件由山西省商贸标准化技术委员会归口。本文件起草单位：山西省检验检测中心（山西省标准计量技术研究院）、广东德信行信用管理有限公司、山西清众科技股份有限公司、阿里云计算有限公司、河北省商务厅新闻文化中心（河北省商务研究中心）。本文件主要起草人：邢建全、王剑、乔智敏、杜占利、方明、吴雨洲、金琳琳、郭振超、陈舒庭、胡燕华、罗轩、高志熙、王程、刘剑、陈哲、马勇。1DB14/T2831—2023商务诚信公共服务平台信息交换接口规范本文件规定了商务诚信公共服务平台信息交换接口的术语和定义、接口类型、接口服务、技术要求、管理要求和持续优化。本文件适用于商务诚信公共服务平台与各数据提供方、数据应用方、信用场景方之间的商务诚信信息共享交换活动。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T22117信用基本术语3术语和定义GB/T22117界定的以及下列术语和定义适用于本文件。3.1信息交换informationexchange信息资源在计算机网络环境下从一个交换结点到其他交换结点的传送和处理过程。3.2信息交换接口informationexchangeinterface信息交换在既定交换方式的基础上，约定的信息交换实体，便于信息能够交换到约定地点、信息来源能够被识别、信息内容能够被理解。4缩略语下列缩略语适用于本文件。JSON：JavaScript对象标记（JavaScriptObjectNotation）API：应用程序界面（ApplicationProgramInterface）HTTP：超文本传送协议（HyperTextTransportProtocol）5接口类型5.1数据采集类数据采集类接口用于商务诚信公共服务平台通过地方政务大数据中心、地方公共信用信息共享平台、信用信息数源单位业务系统、第三方机构业务系统及其他商务诚信公共服务平台等采集数据。2DB14/T2831—20235.2数据共享类数据共享类接口用于商务诚信公共服务平台向接入的平台共享商务诚信信息。常见接口示例见附录A。5.3账号管理类账号管理类接口用于商务诚信公共服务平台对接入的平台用户账号和权限的管理，包括获取公钥接口、修改用户密码接口、获取令牌接口。6接口服务6.1平台接入6.1.1接入申请申请接入商务诚信公共服务平台的单位应制定接入方案，描述拟接入平台的网络环境、安全保障、硬件条件、接口调用方案等信息，并向商务诚信公共服务平台运营单位提出接入申请。申请材料包括申请接入的单位证明文件、申请接入的理由、数据需求、用途、接入方案等信息。6.1.2接入审核接入方提出平台数据接入申请后，由商务诚信公共服务平台运营单位对申请材料及接入方案进行审核。对于符合接入条件的单位，按时做好平台接入技术准备工作，并回复申请单位的接入申请审批结果。6.1.3备案登记商务诚信公共服务平台运营单位需对接入平台进行备案登记，记录接入平台的基本资料，包括平台名称、用户编号、域名、服务器IP、运营单位名称、联系人姓名及联系电话等信息。6.1.4签订协议由接入平台与商务诚信公共服务平台运营单位签订用户协议，根据业务场景确定接入方式，明确需要调用的接口信息，共同约定数据共享的频率、数据格式、交换方式、接口要求、有效期限、公开属性等内容。6.1.5密钥获取接入平台用户通过商务诚信公共服务平台注册用户信息，经平台运营单位审核后，申请接口密钥，申请通过后平台下发接口访问密钥。获取密钥流程如图1所示：3DB14/T2831—2023图1获取密钥流程图6.1.6对接调试接入平台用户使用商务诚信公共服务平台运营单位提供的平台账号、接口地址，对接入服务进行双方联调。经调试，实现接口正常调用的，即可正式上线。6.1.7交换审计为保证商务诚信信息交换过程的安全、质量和时效，商务诚信公共服务平台运营单位应遵循相关法律法规及国家标准、地方标准要求，对交换共享的过程进行全面记录并进行交换审计，包括但不限于交换接入审计、信息溯源审计。6.2接口调用6.2.1数据采集类接口调用流程商务诚信公共服务平台可通过接口调用方式从地方政务大数据中心、地方公共信用信息共享平台、信用信息数源单位业务系统、第三方机构业务系统、其他商务诚信公共服务平台等数据提供方平台采集数据。接口采用HTTP通讯协议进行同步通讯，实现信息交换。数据接口应对数据报文进行加密处理，保障数据在传输过程中的安全。商务诚信公共服务平台收到数据提供方平台返回的数据后，进行解密操作，并对解密数据生成摘要，与数据提供方平台生成的摘要进行比对，确保数据没有被篡改。商务诚信公共服务平台根据数据采集任务要求及商务诚信信息服务需要，定期或不定期发起数据采集请求，数据提供方平台再根据接口约定与商务诚信公共服务平台进行数据交互。数据采集类接口调用流程如图2所示：4DB14/T2831—2023图2数据采集类接口调用流程6.2.2一般查询接口调用流程商务诚信公共服务平台面向接入平台主要通过接口调用方式提供商务诚信信息共享服务。接口支持采用webservice/http/https通讯协议进行同步通讯，实现信息交换。商务诚信公共服务平台对外提供的数据接口通过用户账号管理机制来控制接入平台用户使用权限。符合接入条件、完成账号配置的接入平台方能发起查询请求。商务诚信公共服务平台再按照接口约定与接入平台进行数据交互。数据接口应对数据报文进行加密处理，保障数据在传输过程中的安全。接入平台收到商务诚信公共服务平台返回的数据后，进行解密操作，并对解密数据生成摘要，与商务诚信公共服务平台生成的摘要进行比对，确保数据没有被篡改。一般查询接口调用服务流程如图3所示：5DB14/T2831—2023图3一般查询接口调用流程6.2.3授权查询接口调用流程商务诚信公共服务平台还可对外提供能反映商贸流通企业商务诚信水平的非公开信息。接入平台调用此类查询接口时，须提供对应企业的合法授权凭证，包括以下步骤：——通过商务诚信公共服务平台提供的接口上传企业授权协议，保存返回的授权协议标识；——调用授权查询信息接口，文件标识作为必传参数，经商务诚信公共服务平台验证通过后，返回查询结果。授权查询接口调用流程如图4所示：6DB14/T2831—2023图4授权查询接口调用流程7技术要求7.1接口基本规范7.1.1商务诚信公共服务平台提供API接口服务，遵循RESTful设计风格，与接入平台的数据交换格式采用Json格式。接口调用与返回参数可参照附录A的接口示例。7.1.2数据采集类接口可在双方协商一致的基础上，遵循数据提供方平台的接口规范要求。7DB14/T2831—20237.2系统级参数约定表1中系统级参数是由商务诚信公共服务平台系统定义的，各接入平台需要支持这些参数以便接入该平台提供开放接口。商务诚信公共服务平台采用应用授权认证接口方式，接入平台调用平台接口时需提供密钥、账户和密码。表1系统级参数说明是是是7.3应用级参数的通用约定各业务系统应遵守API平台系统规范中应用级通用参数的约定。应用及参数说明见表2。表2应用级参数说明是是8管理要求8.1总体要求商务诚信公共服务平台运营单位负责对接口的设计、开发、启动、修改、停用、删除进行全流程管8.2监测检查8.2.1商务诚信公共服务平台运营单位对接口服务进行定期监测，定期对问题进行汇总分析，检查发现错误或问题及时处理，必要时向接入平台用户协商确定解决方案。8.2.2监测检查的内容包括：——更新频率，按照相关协议检查平台是否与外部系统进行数据共享；——数据质量，商务诚信公共服务平台运营单位每月不低于一次监测数据质量，包括提供的数据是否根据协议规定采集、共享；数据格式是否规范；数据内容是否完整；数据是否准确真实8.3安全控制商务诚信公共服务平台运营单位应从技术和管理两个方面加强系统安全和数据安全，实施严格的用户认证和权限控制策略，满足对信息安全保护及信息保密需求。9持续优化8DB14/T2831—2023商务诚信公共服务平台运营单位应根据平台发展定位及服务需求，结合接口调用实际情况，定期优化调整平台接口规划，提升接口性能及接口数据质量，适应商务诚信公共服务平台及各相关平台对商务诚信信息共享及应用要求。9DB14/T2831—2023接口示例A.1获取单个企业诚信等级接口根据统一社会信用代码获取企业的诚信等级，诚信等级分为5个级别，分别为AA，A，B，C，D。——接口标识：getEnterpriseGrade；——请求方式：POST；——请求参数如表A.1所示，返回参数如表A.2所示。表A.1获取单个企业诚信等级接口请求参数说明是是是是表A.2获取单个企业诚信等级接口返回参数说明{msg:’获取企业诚信等级成功’,data:{uniscId:’91140107×××××××6F’,assessGrade:‘A’}A.2批量获取企业诚信等级接口批量获取企业的诚信等级，根据参数当前页码和页码的大小获取。——接口标识：getEnterpriseGrades——请求方式：POST——请求参数如表A.3所示，返回参数如表A.4所示：DB14/T2831—2023表A.3批量获取企业诚信等级接口请求参数说明是是是是是表A.4批量获取企业诚信等级接口返回参数说明{msg:’获取企业诚信等级成功’,data:{pageno:10,count:1700000,pagesize:1000,companyList:[{uniscId:’92140107××××××1J’,assessGrade:‘A’{uniscId:’92140107××××××1K’,assessGrade:‘B’………,{uniscId:’92140107×××××××56’,assessGrade:‘AA’]DB14/T2831—2023}A.3授权获取公共资源交易记录接口以公共资源交易记录查询接口为例，对接口文档进行说明。根据组织机构统一社会信用代码获取企业的公共资源交