DB14T 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部分：标准化文件的结构和起草规则》的规定起草。本文件由山西省商务厅提出、组织实施和监督检查。山西省市场监督管理局对标准的组织实施情况进行监督检查。本文件由山西省商贸标准化技术委员会归口。本文件起草单位：山西省检验检测中心（山西省标准计量技术研究院）、广东德信行信用管理有限公司、山西清众科技股份有限公司、阿里云计算有限公司、河北省商务厅新闻文化中心（河北省商务研究中心）。本文件主要起草人：邢建全、王剑、乔智敏、杜占利、方明、吴雨洲、金琳琳、郭振超、陈舒庭、胡燕华、罗轩、高志熙、王程、刘剑、陈哲、马勇。DB14/T2831—20231商务诚信公共服务平台信息交换接口规范本文件规定了商务诚信公共服务平台信息交换接口的术语和定义、接口类型、接口服务、技术要求、管理要求和持续优化。本文件适用于商务诚信公共服务平台与各数据提供方、数据应用方、信用场景方之间的商务诚信信息共享交换活动。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T22117信用基本术语3术语和定义GB/T22117界定的以及下列术语和定义适用于本文件。信息交换informationexchange信息资源在计算机网络环境下从一个交换结点到其他交换结点的传送和处理过程。信息交换接口informationexchangeinterface信息交换在既定交换方式的基础上，约定的信息交换实体，便于信息能够交换到约定地点、信息来源能够被识别、信息内容能够被理解。4缩略语下列缩略语适用于本文件。JSON：JavaScript对象标记（JavaScriptObjectNotation）API：应用程序界面（ApplicationProgramInterface）HTTP：超文本传送协议（HyperTextTransportProtocol）5接口类型数据采集类数据采集类接口用于商务诚信公共服务平台通过地方政务大数据中心、地方公共信用信息共享平台、信用信息数源单位业务系统、第三方机构业务系统及其他商务诚信公共服务平台等采集数据。DB14/T2831—20232数据共享类数据共享类接口用于商务诚信公共服务平台向接入的平台共享商务诚信信息。常见接口示例见附录A。账号管理类账号管理类接口用于商务诚信公共服务平台对接入的平台用户账号和权限的管理，包括获取公钥接口、修改用户密码接口、获取令牌接口。6接口服务平台接入6.1.1接入申请申请接入商务诚信公共服务平台的单位应制定接入方案，描述拟接入平台的网络环境、安全保障、硬件条件、接口调用方案等信息，并向商务诚信公共服务平台运营单位提出接入申请。申请材料包括申请接入的单位证明文件、申请接入的理由、数据需求、用途、接入方案等信息。6.1.2接入审核接入方提出平台数据接入申请后，由商务诚信公共服务平台运营单位对申请材料及接入方案进行审核。对于符合接入条件的单位，按时做好平台接入技术准备工作，并回复申请单位的接入申请审批结果。6.1.3备案登记商务诚信公共服务平台运营单位需对接入平台进行备案登记，记录接入平台的基本资料，包括平台名称、用户编号、域名、服务器IP、运营单位名称、联系人姓名及联系电话等信息。6.1.4签订协议由接入平台与商务诚信公共服务平台运营单位签订用户协议，根据业务场景确定接入方式，明确需要调用的接口信息，共同约定数据共享的频率、数据格式、交换方式、接口要求、有效期限、公开属性等内容。6.1.5密钥获取接入平台用户通过商务诚信公共服务平台注册用户信息，经平台运营单位审核后，申请接口密钥，申请通过后平台下发接口访问密钥。获取密钥流程如图1所示：钥接口申请6.1.6对接调试6.1.7交换审计数据接口应对数据报文进行加密处理，保障数据在传输过程中的安全。商务诚信公共服务平4商务诚信公共服务平台调用数据接口请求调用成功/返回数据数据提供方平台请求参数解析口支持采用webservice/http/https通商务诚信公共服务平台对外提供的数据接口通过用户账号管理机制来控制接入平台用户使用调用数据接口请求据请求参数解析数据接口商务诚信公共服务平台还可对外提供能反映商贸流通企业商务诚信水平的非公开信息。接入6接入平台接入平台商务诚信公共服务上传授权文件保存企业文件授权保存授权文件/授调用授权查询接口调用失败验证通过调用成功/返回数据验证授权文件标识授权信息查询接口授权文件接口7.1.2数据采集类接口可在双方协商一致的基础上，遵循数据提供方平台的接口规范要求。7表1中系统级参数是由商务诚信公共服务平台系统定义的，各接入平台需要支参数名是否必需字符串是字符串是在平台注册账户时的唯一用户名字符串是参数名是否必需是用于支持分页的api,默认为1,表示第几页是8.1总体要求8.2.1商务诚信公共服务平台运营单位对接口服务进行定期监测，定期对问题进行汇总分析，检查发8.2.2监测检查的内容包括：8DB14/T2831—2023商务诚信公共服务平台运营单位应根据平台发展定位及服务需求，结合接口调用实际情况，定期优化调整平台接口规划，提升接口性能及接口数据质量，适应商务诚信公共服务平台及各相关平台对商务诚信信息共享及应用要求。DB14/T2831—20239（资料性）接口示例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授权获取公共资源交易记录接口以公共资源交易记录查询接口为例，对接口文档进行说明。根据组织机构统一社会信用代码获取企业的公共资源交易记录。该接口属于授权查询接口。——接口标识：getPublicResourcesTrading；——请求方式：POST；——请求参数说明