ICS03.080.99 CCSA20 14 山西省地方标准 DB14/T2831—2023 商务诚信公共服务平台信息交换接口规范 2023-10-10发布 2024-01-10实施 山西省市场监督管理局  发布 DB14/T2831—2023 I目次 前言..................................................................................II 1范围................................................................................1 2规范性引用文件......................................................................1 3术语和定义..........................................................................1 4缩略语..............................................................................1 5接口类型............................................................................1 6接口服务............................................................................2 7技术要求............................................................................6 8管理要求............................................................................7 9持续优化............................................................................7 附录A（资料性）接口示例..............................................................9 DB14/T2831—2023 II前言 本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定 起草。 本文件由山西省商务厅提出、组织实施和监督检查。 山西省市场监督管理局对标准的组织实施情况进行监督检查。 本文件由山西省商贸标准化技术委员会归口。 本文件起草单位：山西省检验检测中心（山西省标准计量技术研究院）、广东德信行信用管理有限 公司、山西清众科技股份有限公司、阿里云计算有限公司、河北省商务厅新闻文化中心（河北省商务研 究中心）。 本文件主要起草人：邢建全、王剑、乔智敏、杜占利、方明、吴雨洲、金琳琳、郭振超、陈舒庭、 胡燕华、罗轩、高志熙、王程、刘剑、陈哲、马勇。 DB14/T2831—2023 1商务诚信公共服务平台信息交换接口规范 1范围 本文件规定了商务诚信公共服务平台信息交换接口的术语和定义、接口类型、接口服务、技术要求、 管理要求和持续优化。 本文件适用于商务诚信公共服务平台与各数据提供方、数据应用方、信用场景方之间的商务诚信信 息共享交换活动。 2规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 GB/T22117信用基本术语 3术语和定义 GB/T22117界定的以及下列术语和定义适用于本文件。 信息交换informationexchange 信息资源在计算机网络环境下从一个交换结点到其他交换结点的传送和处理过程。 信息交换接口informationexchangeinterface 信息交换在既定交换方式的基础上，约定的信息交换实体，便于信息能够交换到约定地点、信息来 源能够被识别、信息内容能够被理解。 4缩略语 下列缩略语适用于本文件。 JSON：JavaScript对象标记（JavaScriptObjectNotation） API：应用程序界面（ApplicationProgramInterface） HTTP：超文本传送协议（HyperTextTransportProtocol） 5接口类型 数据采集类 数据采集类接口用于商务诚信公共服务平台通过地方政务大数据中心、地方公共信用信息共享平台、 信用信息数源单位业务系统、第三方机构业务系统及其他商务诚信公共服务平台等采集数据。 DB14/T2831—2023 2 数据共享类 数据共享类接口用于商务诚信公共服务平台向接入的平台共享商务诚信信息。常见接口示例见附录 A。 账号管理类 账号管理类接口用于商务诚信公共服务平台对接入的平台用户账号和权限的管理，包括获取公钥接 口、修改用户密码接口、获取令牌接口。 6接口服务 平台接入 6.1.1接入申请 申请接入商务诚信公共服务平台的单位应制定接入方案，描述拟接入平台的网络环境、安全保障、 硬件条件、接口调用方案等信息，并向商务诚信公共服务平台运营单位提出接入申请。申请材料包括申 请接入的单位证明文件、申请接入的理由、数据需求、用途、接入方案等信息。 6.1.2接入审核 接入方提出平台数据接入申请后，由商务诚信公共服务平台运营单位对申请材料及接入方案进行审 核。对于符合接入条件的单位，按时做好平台接入技术准备工作，并回复申请单位的接入申请审批结果。 6.1.3备案登记 商务诚信公共服务平台运营单位需对接入平台进行备案登记，记录接入平台的基本资料，包括平台 名称、用户编号、域名、服务器IP、运营单位名称、联系人姓名及联系电话等信息。 6.1.4签订协议 由接入平台与商务诚信公共服务平台运营单位签订用户协议，根据业务场景确定接入方式，明确需 要调用的接口信息，共同约定数据共享的频率、数据格式、交换方式、接口要求、有效期限、公开属性 等内容。 6.1.5密钥获取 接入平台用户通过商务诚信公共服务平台注册用户信息，经平台运营单位审核后，申请接口密钥， 申请通过后平台下发接口访问密钥。获取密钥流程如图1所示： DB14/T2831—2023 3 图1获取密钥流程图 6.1.6对接调试 接入平台用户使用商务诚信公共服务平台运营单位提供的平台账号、接口地址，对接入服务进行双 方联调。经调试，实现接口正常调用的，即可正式上线。 6.1.7交换审计 为保证商务诚信信息交换过程的安全、质量和时效，商务诚信公共服务平台运营单位应遵循相关法 律法规及国家标准、地方标准要求，对交换共享的过程进行全面记录并进行交换审计，包括但不限于交 换接入审计、信息溯源审计。 接口调用 6.2.1数据采集类接口调用流程 6.2.1.1商务诚信公共服务平台可通过接口调用方式从地方政务大数据中心、地方公共信用信息共享 平台、信用信息数源单位业务系统、第三方机构业务系统、其他商务诚信公共服务平台等数据提供方平 台采集数据。接口采用HTTP通讯协议进行同步通讯，实现信息交换。 6.2.1.2数据接口应对数据报文进行加密处理，保障数据在传输过程中的安全。商务诚信公共服务平 台收到数据提供方平台返回的数据后，进行解密操作，并对解密数据生成摘要，与数据提供方平台生成 的摘要进行比对，确保数据没有被篡改。 6.2.1.3商务诚信公共服务平台根据数据采集任务要求及商务诚信信息服务需要，定期或不定期发起 数据采集请求，数据提供方平台再根据接口约定与商务诚信公共服务平台进行数据交互。 6.2.1.4数据采集类接口调用流程如图2所示： DB14/T2831—2023 4 图2数据采集类接口调用流程 6.2.2一般查询接口调用流程 6.2.2.1商务诚信公共服务平台面向接入平台主要通过接口调用方式提供商务诚信信息共享服务。接 口支持采用webservice/http/https通讯协议进行同步通讯，实现信息交换。 6.2.2.2商务诚信公共服务平台对外提供的数据接口通过用户账号管理机制来控制接入平台用户使用 权限。符合接入条件、完成账号配置的接入平台方能发起查询请求。商务诚信公共服务平台再按照接口 约定与接入平台进行数据交互。 6.2.2.3数据接口应对数据报文进行加密处理，保障数据在传输过程中的安全。接入平台收到商务诚 信公共服务平台返回的数据后，进行解密操作，并对解密数据生成摘要，与商务诚信公共服务平台生成 的摘要进行比对，确保数据没有被篡改。 6.2.2.4一般查询接口调用服务流程如图3所示：