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

《DB14 T 2831-2023 商务诚信公共服务平台 信息交换接口规范.pdf》由会员分享，可在线阅读，更多相关《DB14 T 2831-2023 商务诚信公共服务平台 信息交换接口规范.pdf（16页珍藏版）》请在麦多课文档分享上搜索。

1、ICS03.080.99CCS A2014山西省地方标准DB14/T 28312023商务诚信公共服务平台 信息交换接口规范2023-10-10 发布2024-01-10 实施山西省市场监督管理局 发 布DB14/T 28312023I目次前言.II1范围.12规范性引用文件.13术语和定义.14缩略语.15接口类型.16接口服务.27技术要求.68管理要求.79持续优化.7附录 A（资料性）接口示例.9DB14/T 28312023II前言本文件按照GB/T 1.12020标准化工作导则第1部分：标准化文件的结构和起草规则的规定起草。本文件由山西省商务厅提出、组织实施和监督检查。山西省市场监

2、督管理局对标准的组织实施情况进行监督检查。本文件由山西省商贸标准化技术委员会归口。本文件起草单位：山西省检验检测中心（山西省标准计量技术研究院）、广东德信行信用管理有限公司、山西清众科技股份有限公司、阿里云计算有限公司、河北省商务厅新闻文化中心（河北省商务研究中心）。本文件主要起草人：邢建全、王剑、乔智敏、杜占利、方明、吴雨洲、金琳琳、郭振超、陈舒庭、胡燕华、罗轩、高志熙、王程、刘剑、陈哲、马勇。DB14/T 283120231商务诚信公共服务平台 信息交换接口规范1范围本文件规定了商务诚信公共服务平台信息交换接口的术语和定义、接口类型、接口服务、技术要求、管理要求和持续优化。本文件适用于商务

3、诚信公共服务平台与各数据提供方、数据应用方、信用场景方之间的商务诚信信息共享交换活动。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 22117 信用基本术语3术语和定义GB/T 22117界定的以及下列术语和定义适用于本文件。信息交换information exchange信息资源在计算机网络环境下从一个交换结点到其他交换结点的传送和处理过程。信息交换接口information exchange interface信息交换在既定交换

4、方式的基础上，约定的信息交换实体，便于信息能够交换到约定地点、信息来源能够被识别、信息内容能够被理解。4缩略语下列缩略语适用于本文件。JSON：JavaScript对象标记（JavaScript Object Notation）API：应用程序界面（Application Program Interface）HTTP：超文本传送协议（HyperText Transport Protocol）5接口类型数据采集类数据采集类接口用于商务诚信公共服务平台通过地方政务大数据中心、地方公共信用信息共享平台、信用信息数源单位业务系统、第三方机构业务系统及其他商务诚信公共服务平台等采集数据。DB14/T 2

5、83120232数据共享类数据共享类接口用于商务诚信公共服务平台向接入的平台共享商务诚信信息。常见接口示例见附录A。账号管理类账号管理类接口用于商务诚信公共服务平台对接入的平台用户账号和权限的管理，包括获取公钥接口、修改用户密码接口、获取令牌接口。6接口服务平台接入6.1.1接入申请申请接入商务诚信公共服务平台的单位应制定接入方案，描述拟接入平台的网络环境、安全保障、硬件条件、接口调用方案等信息，并向商务诚信公共服务平台运营单位提出接入申请。申请材料包括申请接入的单位证明文件、申请接入的理由、数据需求、用途、接入方案等信息。6.1.2接入审核接入方提出平台数据接入申请后，由商务诚信公共服务平台

6、运营单位对申请材料及接入方案进行审核。对于符合接入条件的单位，按时做好平台接入技术准备工作，并回复申请单位的接入申请审批结果。6.1.3备案登记商务诚信公共服务平台运营单位需对接入平台进行备案登记，记录接入平台的基本资料，包括平台名称、用户编号、域名、服务器IP、运营单位名称、联系人姓名及联系电话等信息。6.1.4签订协议由接入平台与商务诚信公共服务平台运营单位签订用户协议，根据业务场景确定接入方式，明确需要调用的接口信息，共同约定数据共享的频率、数据格式、交换方式、接口要求、有效期限、公开属性等内容。6.1.5密钥获取接入平台用户通过商务诚信公共服务平台注册用户信息，经平台运营单位审核后，申

7、请接口密钥，申请通过后平台下发接口访问密钥。获取密钥流程如图1所示：DB14/T 283120233图 1获取密钥流程图6.1.6对接调试接入平台用户使用商务诚信公共服务平台运营单位提供的平台账号、接口地址，对接入服务进行双方联调。经调试，实现接口正常调用的，即可正式上线。6.1.7交换审计为保证商务诚信信息交换过程的安全、质量和时效，商务诚信公共服务平台运营单位应遵循相关法律法规及国家标准、地方标准要求，对交换共享的过程进行全面记录并进行交换审计，包括但不限于交换接入审计、信息溯源审计。接口调用6.2.1数据采集类接口调用流程6.2.1.1商务诚信公共服务平台可通过接口调用方式从地方政务大数

8、据中心、地方公共信用信息共享平台、信用信息数源单位业务系统、第三方机构业务系统、其他商务诚信公共服务平台等数据提供方平台采集数据。接口采用 HTTP 通讯协议进行同步通讯，实现信息交换。6.2.1.2数据接口应对数据报文进行加密处理，保障数据在传输过程中的安全。商务诚信公共服务平台收到数据提供方平台返回的数据后，进行解密操作，并对解密数据生成摘要，与数据提供方平台生成的摘要进行比对，确保数据没有被篡改。6.2.1.3商务诚信公共服务平台根据数据采集任务要求及商务诚信信息服务需要，定期或不定期发起数据采集请求，数据提供方平台再根据接口约定与商务诚信公共服务平台进行数据交互。6.2.1.4数据采集

9、类接口调用流程如图 2 所示：DB14/T 283120234图 2数据采集类接口调用流程6.2.2一般查询接口调用流程6.2.2.1商务诚信公共服务平台面向接入平台主要通过接口调用方式提供商务诚信信息共享服务。接口支持采用 webservice/http/https 通讯协议进行同步通讯，实现信息交换。6.2.2.2商务诚信公共服务平台对外提供的数据接口通过用户账号管理机制来控制接入平台用户使用权限。符合接入条件、完成账号配置的接入平台方能发起查询请求。商务诚信公共服务平台再按照接口约定与接入平台进行数据交互。6.2.2.3数据接口应对数据报文进行加密处理，保障数据在传输过程中的安全。接入平

10、台收到商务诚信公共服务平台返回的数据后，进行解密操作，并对解密数据生成摘要，与商务诚信公共服务平台生成的摘要进行比对，确保数据没有被篡改。6.2.2.4一般查询接口调用服务流程如图 3 所示：DB14/T 283120235图 3一般查询接口调用流程6.2.3授权查询接口调用流程6.2.3.1商务诚信公共服务平台还可对外提供能反映商贸流通企业商务诚信水平的非公开信息。接入平台调用此类查询接口时，须提供对应企业的合法授权凭证，包括以下步骤：通过商务诚信公共服务平台提供的接口上传企业授权协议，保存返回的授权协议标识；调用授权查询信息接口，文件标识作为必传参数，经商务诚信公共服务平台验证通过后，返回

11、查询结果。6.2.3.2授权查询接口调用流程如图 4 所示：DB14/T 283120236图 4授权查询接口调用流程7技术要求接口基本规范7.1.1商务诚信公共服务平台提供 API 接口服务，遵循 RESTful 设计风格，与接入平台的数据交换格式采用 Json 格式。接口调用与返回参数可参照附录 A 的接口示例。7.1.2数据采集类接口可在双方协商一致的基础上，遵循数据提供方平台的接口规范要求。DB14/T 283120237系统级参数约定表1中系统级参数是由商务诚信公共服务平台系统定义的，各接入平台需要支持这些参数以便接入该平台提供开放接口。商务诚信公共服务平台采用应用授权认证接口方式，

12、接入平台调用平台接口时需提供密钥、账户和密码。表 1系统级参数说明参数名类型是否必需描述accessid字符串是用户申请接口时，平台自动分配到的应用唯一标识username字符串是在平台注册账户时的唯一用户名pwd字符串是授权用户登录系统的密码应用级参数的通用约定各业务系统应遵守API平台系统规范中应用级通用参数的约定。应用及参数说明见表2。表 2应用级参数说明参数名类型是否必需描述pagenoint是用于支持分页的api，默认为1，表示第几页pagesizeint是用于支持分页的api，表示每页返回多少条数据8管理要求总体要求商务诚信公共服务平台运营单位负责对接口的设计、开发、启动、修改、停

13、用、删除进行全流程管理。监测检查8.2.1商务诚信公共服务平台运营单位对接口服务进行定期监测，定期对问题进行汇总分析，检查发现错误或问题及时处理，必要时向接入平台用户协商确定解决方案。8.2.2监测检查的内容包括：更新频率，按照相关协议检查平台是否与外部系统进行数据共享；数据质量，商务诚信公共服务平台运营单位每月不低于一次监测数据质量，包括提供的数据是否根据协议规定采集、共享；数据格式是否规范；数据内容是否完整；数据是否准确真实等。安全控制商务诚信公共服务平台运营单位应从技术和管理两个方面加强系统安全和数据安全，实施严格的用户认证和权限控制策略，满足对信息安全保护及信息保密需求。9持续优化DB

14、14/T 283120238商务诚信公共服务平台运营单位应根据平台发展定位及服务需求，结合接口调用实际情况，定期优化调整平台接口规划，提升接口性能及接口数据质量，适应商务诚信公共服务平台及各相关平台对商务诚信信息共享及应用要求。DB14/T 283120239AA附录A（资料性）接口示例A.1获取单个企业诚信等级接口根据统一社会信用代码获取企业的诚信等级，诚信等级分为5个级别，分别为AA，A，B，C，D。接口标识：getEnterpriseGrade；请求方式：POST；请求参数如表 A.1 所示，返回参数如表 A.2 所示。表 A.1 获取单个企业诚信等级接口请求参数说明参数名类型必填示例值

15、描述accessidstring是访问接口的密钥usernamestring是用户账户pwdstring是密码uniscIdstring是企业统一社会信用代码表 A.2 获取单个企业诚信等级接口返回参数说明参数名类型示例值描述msgstring获取企业诚信等级成功接口调用结果描述resultint调用接口，成功与否，1代表成功，0代表失败。uniscIdstring企业统一社会信用代码enterpriseNamestring企业名称assessGradestring企业的诚信等级示例：msg:获取企业诚信等级成功,result:1,data:uniscId:911401076F,enterpr

16、iseName:太原市科技有限公司,assessGrade:A A.2批量获取企业诚信等级接口批量获取企业的诚信等级，根据参数当前页码和页码的大小获取。接口标识：getEnterpriseGrades请求方式：POST请求参数如表 A.3 所示，返回参数如表 A.4 所示：DB14/T 2831202310表 A.3 批量获取企业诚信等级接口请求参数说明参数名类型必填示例值描述accessidstring是访问接口的密钥usernamestring是用户账户pwdstring是密码pagenoint是当前获取数据的页pagesizeint是每一页大小，最大不得超过1000表 A.4 批量获取企

17、业诚信等级接口返回参数说明参数名类型示例值描述msgstring获取企业诚信等级成功接口调用结果描述resultint调用接口，成功与否，1代表成功，0代表失败。uniscIdstring企业统一社会信用代码enterpriseNamestring企业名称assessGradestring企业的诚信等级示例：msg:获取企业诚信等级成功,result:1,data:pageno:10,count:1700000,pagesize:1000,companyList:uniscId:921401071J,enterpriseName:,assessGrade:A,uniscId:921401071

18、K,enterpriseName:,assessGrade:B,uniscId:9214010756,enterpriseName:,assessGrade:AADB14/T 2831202311A.3授权获取公共资源交易记录接口以公共资源交易记录查询接口为例，对接口文档进行说明。根据组织机构统一社会信用代码获取企业的公共资源交易记录。该接口属于授权查询接口。接口标识：getPublicResourcesTrading；请求方式：POST；请求参数说明和返回参数说明分别见表 A.5、表 A.6。表 A.5 公共资源交易记录查询接口请求参数参数名类型必填示例值描述accessidstring是访

19、问接口的密钥usernamestring是用户账户pwdstring是密码uniscIdstring是企业统一社会信用代码licenseIDstring是企业授权协议标识（回传接口返回）表 A.6 公共资源交易记录查询接口返回参数参数名类型示例值描述msgstring获取公共资源交易记录成功接口调用结果描述resultint调用接口，成功与否，1代表成功，0代表失败。dataarray交易信息列表typestring交易类型，包含工程建设、政府采购、土地、矿业、国有产权实物、国有产权股权projectNamestring项目名称ownerOrgNamestring项目所有组织名称urlstri

20、ng链接地址publicizingDaydate公告日期，格式：YYYY-MM-DD HH:mm:ssbidPricestring项目金额，单位：元示例：msg:获取企业公共资源交易记录成功,result:1,data:uniscId:911400009B,enterpriseName:山西太原市有限公司,type:政府采购,projectName:济南市城乡建设委员测研究,ownerOrgName:济南市城乡建设委员会,bidPrice:595000,url:http:/,DB14/T 2831202312publicizingDay:2019-01-07 13:20:24,type:政府采购,projectName:无人驾驶综合管控平台系统采购项目,ownerOrgName:鹤壁市城乡发有限公司,bidPrice:2570000,url:http:/,publicizingDay:2019-04-17 00:00:00