GB/T 40094.3-2021 电子商务数据交易 第3部分：数据接口规范

　　ICS 35 . 240 . 0 1 A 10

　　中 华 人 民 共 和 国 国 家 标 准

　　GB/T 40094 . 3—2021

　　电子商务数据交易

　　第 3 部分：数据接口规范

　　Electroniccommercedatatransaction—part3：Datainterfacespecification

　　2021-05-21 发布 2021-12-01 实施

　　国家市场监督管理总局国家标准化管理委员会

　　发

　　布

　　GB/T 40094 . 3—202 1

　　GB/T 40094 . 3—202 1

　　前 言

　　GB/T 40094《电子商务数据交易》分为如下部分：

　　— 第 1 部分：准则;

　　— 第 2 部分：数据描述规范;

　　— 第 3 部分：数据接口规范;

　　— 第 4 部分：隐私保护规范。

　　本部分为 GB/T 40094 的第 3 部分。

　　本部分按照 GB/T 1 . 1—2009 给出的规则起草。

　　请注意本文件的某些内容可能涉及专利。 本文件的发布机构不承担识别这些专利的责任。

　　本部分由全国电子业务标准化技术委员会(SAC/TC 83)提出并归口 。

　　本部分起草单位：北京安宏睿业科技有限公司、合肥状元郎电子科技有限公司、广东源创智能科技有限公司、北京中普至信标准化咨询事务所、厦门荆艺软件有限公司、东莞市衣电园实业投资有限公司、福建德化陶知然陶瓷文化创意有限公司、广东新安怀电子商务有限公司、中国标准化研究院、北京无界标准科技有限公司、浙江省林业技术推广总站、广东奇化化工交易中心股份有限公司、广东路霸克机电设备有限公司、佛山维尚家具制造有限公司、浙江和也健康科技有限公司、中国计量大学、滁州喜多多食品科技有限公司、山东省中智科标准化研究院有限公司、福建海西标准化技术服务事务所有限公司、北京中金永嘉大数据技术有限公司、北京阿拉丁火燚大数据科技有限公司。

　　本部分主要起草人：马建红、李园莉、蒋智谋、周博纬、金振华、侯明月、刘颖、张明贵、李春兰、王伟、张洪德、易蕴魁、梁锡钧、林文博、蒋剑豪、陈麦岐、张科、姜殿臣、张月义、胡立江、崔从俊、林影、郝凤英、刘亚男。

　　GB/T 40094 . 3—202 1

　　电子商务数据交易

　　第 3 部分：数据接口规范

　　1 范围

　　GB/T 40094 的本部分规定了电子商务数据交易平台的数据接口方式、数据接口要求和证实方法。本部分适用于电子商务数据交易平台的交易主体之间的数据获取。

　　2 规范性引用文件

　　下列文件对于本文件的应用是必不可少的。 凡是注 日期的引用文件，仅注 日期的版本适用于本文件 。凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。

　　GB/T 40094 . 1—2021 电子商务数据交易 第 1 部分：准则

　　GB/T 40094 . 2—2021 电子商务数据交易 第 2 部分：数据描述规范

　　3 术语、定义和缩略语

　　3 . 1 术语和定义

　　GB/T 40094 . 1—2021、GB/T 40094 . 2—2021 界定的以及下列术语和定义适用于本文件。

　　3 . 1 . 1

　　数据文件 datafile

　　用于电子商务数据交易平台数据传输的文件。

　　3 . 2 缩略语

　　下列缩略语适用于本文件。

　　API：应用程序编程接口(Application Programming Interface)

　　URL：统一资源定位符(Uniform Resource Locator)

　　4 数据接口方式

　　数据交易平台提供的数据接口方式应包括但不限于：

　　a) 文件接口：基于超文本传输协议(HTTP)或超文本传输安全协议(HTTPS) 网络协议的网络服务，以电子文件形式传输数据、交换信息的方式;

　　b) API接口：基于 HTTP 或 HTTPS 网络协议的网络服务，用于交易主体之间通过调用 API 接口获取数据的方式。

　　GB/T 40094 . 3—202 1

　　5 数据接口要求

　　5 . 1 身份认证

　　数据需求方应通过身份认证申请后，按照数据交易平台或数据提供方定义的数据接口获取数据。相关要求应包括但不限于：

　　a) 数据需求方通过用户名/密码向数据交易平台请求身份认证;

　　b) 通过认证后，由数据交易平台为数据需求方提供一个身份令牌;

　　c) 数据需求方按照数据交易平台或数据提供方提供的接口方式、接口说明等要求来获取数据，具体接口要求见 5 . 2 和 5 . 3 。

　　5 . 2 文件接口

　　5 . 2 . 1 概述

　　文件接口是数据需求方购买数据后由数据交易平台为其提供的下载地址，通过下载地址可获取所购买的数据文件。

　　5 . 2 . 2 文件接口说明要求

　　文件接口说明应包括但不限于：

　　a) 文件下载地址：可获取到数据文件的 URL地址;

　　示例 1 : http://file. XXXjiaoyi. com/common_flowers/download? name=金 钱 兜 &access_token=您 申 请 的 AC-

　　CESSTOKEN。

　　b) 文件类型：数据文件的存储格式说明;示例 2 : .xls 文件 。

　　c) 文件大小：数据文件的存储空间大小或数据量的描述;示例 3 : 5 MB。

　　d) 附加说明：数据文件的其他说明。

　　5 . 3 API接口

　　5 . 3 . 1 概述

　　API接口是数据提供方通过数据交易平台提供的数据获取方式，数据需求方通过调用数据提供方定义的 API接口获取所购买的数据。

　　5 . 3 . 2 API接口说明要求

　　API接口说明应包括但不限于：

　　a) 接口名称：交易数据主题内容的简要和概况性描述，名称突出数据内容指向的对象以及对象具

　　有的显著特征，如时间特征、地域特征和行业特征等;示例 1 ：常见花卉数据查询。

　　b) 接口描述：接口的功能性描述;

　　示例 2：接口提供常见花卉数据查询，维度有名称、拉丁名、别名、分类、科属、盛花期、简介。

　　c) 接口地址：接口的调用地址;

　　示例 3 : http://api.XXXjiaoyi.com/common_flowers/query。

　　d) 请求方式：对数据进行操作采用的类型，可采用 GET或 POST等方式;

　　GB/T 40094 . 3—202 1

　　示例 4 : http GET。

　　e) 请求示例：请求数据的接口地址示例说明;

　　示例 5 : http://api. XXXjiaoyi. com/common_flowers/query? name=金钱兜 &access_token=您申请的 ACCESS-

　　TOKEN。

　　f) 请求参数：访问接口时必要的或可选的参数，说明参数名称、类型、是否必填、示例值和描述说明等;其中，必要参数应给出调用 API所需的唯一身份令牌;

　　示例 6 :

　　g) 返回结果：请求数据后，系统返回的请求结果。 包括但不限于返回状态代码、返回消息说明和

　　数据信息等内容;返回结果可采用 JSON(JS 对象简谱，JavaScript Object Notation)等格式;

　　示例 7 :

　　h) 返回字段说明：返回结果中数据信息的字段说明，包括但不限于字段的名称、类型、示例值和描述说明等;

　　示例 8 :

　　GB/T 40094 . 3—202 1

　　i) 返回状态代码：请求数据后，系统返回的状态代码及其说明。

　　示例 9 :

　　6 证实方法

　　6 . 1 电子商务或电子商务数据交易软件检测机构检查数据交易平台提供的数据接口方式是否符合第 4章要求，对不符合要求的数据交易平台进行整改，直至符合第 4 章的要求。

　　6 . 2 电子商务或电子商务数据交易软件检测机构检查数据交易平台提供的身份认证、文件接口和 API接口是否符合 5 . 1~5 . 3 的要求，对不符合要求的数据交易平台进行整改，直至符合 5 . 1~5 . 3 的要求。

　　6 . 3 数据交易平台检查数据提供方提供的文件接口和 API接口是否符合 5 . 2 和 5 . 3 的要求，对不符合要求的，数据提供方进行整改，直至符合 5 . 2 和 5 . 3 的要求。

　　GB/T 40094 . 3—202 1

　　参 考 文 献

　　[1] GB/T 18391 . 1—2009 信息技术 元数据注册系统(MDR) 第 1 部分：框架

　　[2] GB/T 32670—2016 电子商务交易产品信息描述 服装

　　[3] GB/T 35408—2017 电子商务质量管理 术语