ICS35.240.01 A 10 中华人民共和国国家标准 GB/T 40094.3—2021 电子商务数据交易 第3部分：数据接口规范 Electronic commerce data transaction-Part 3:Data interface specification 2021-05-21发布 2021-12-01实施 国家市场监督管理总局 发布 国家标准化管理委员会 GB/T 40094.3—2021 目 次 前言 1 范围 2 规范性引用文件 3术语、定义和缩略语· 4 数据接口方式 5 数据接口要求 6 证实方法 参考文献 GB/T40094.3—2021 前言 GB/T40094《电子商务数据交易》分为如下部分： 第1部分：准则； 一第2部分：数据描述规范； 一第3部分：数据接口规范； 一第4部分：隐私保护规范。 本部分为GB/T40094的第3部分。 本部分按照GB/T1.1一2009给出的规则起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本部分由全国电子业务标准化技术委员会（SAC/TC83）提出并归口。 本部分起草单位：北京安宏睿业科技有限公司、合肥状元郎电子科技有限公司、广东源创智能科技 有限公司、北京中普至信标准化咨询事务所、厦门荆艺软件有限公司、东莞市衣电园实业投资有限公司、 福建德化陶知然陶瓷文化创意有限公司、广东新安怀电子商务有限公司、中国标准化研究院、北京无界 标准科技有限公司、浙江省林业技术推广总站、广东奇化化工交易中心股份有限公司、广东路霸克机电 设备有限公司、佛山维尚家具制造有限公司、浙江和也健康科技有限公司、中国计量大学、滁州喜多多食 京中金永嘉大数据技术有限公司、北京阿拉丁火燚大数据科技有限公司。 本部分主要起草人：马建红、李园莉、蒋智谋、周博纬、金振华、侯明月、刘颖、张明贵、李春兰、王伟、 张洪德、易蕴魁、梁锡钧、林文博、蒋剑豪、陈麦岐、张科、姜殿臣、张月义、胡立江、霍从俊、林影、郝凤英、 刘亚男 Ⅲ GB/T40094.3—2021 电子商务数据交易 第3部分：数据接口规范 1范围 GB/T40094的本部分规定了电子商务数据交易平台的数据接口方式、数据接口要求和证实方法。 本部分适用于电子商务数据交易平台的交易主体之间的数据获取。 2 2规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件 GB/T40094.1—2021电子商务数据交易第1部分：准则 GB/T40094.2—2021电子商务数据交易第2部分：数据描述规范 3术语、定义和缩略语 3.1术语和定义 GB/T40094.1一2021，GB/T40094.2一2021界定的以及下列术语和定义适用于本文件 3.1.1 数据文件 datafile 用于电子商务数据交易平台数据传输的文件。 3.2 缩略语 下列缩略语适用于本文件。 API：应用程序编程接口（ApplicationProgrammingInterface） URL：统一资源定位符（UniformResourceLocator） 4 数据接口方式 数据交易平台提供的数据接口方式应包括但不限于： a) 文件接口：基于超文本传输协议（HTTP）或超文本传输安全协议（HTTPS）网络协议的网络服 务，以电子文件形式传输数据、交换信息的方式； b) API接口：基于HTTP或HTTPS网络协议的网络服务，用于交易主体之间通过调用API接 口获取数据的方式 1 GB/T40094.3—2021 5数据接口要求 5.1身份认证 数据需求方应通过身份认证申请后，按照数据交易平台或数据提供方定义的数据接口获取数据。 相关要求应包括但不限于： a） 数据需求方通过用户名/密码向数据交易平台请求身份认证； b) 通过认证后，由数据交易平台为数据需求方提供一个身份令牌； c） 数据需求方按照数据交易平台或数据提供方提供的接口方式接口说明等要求来获取数据，具 体接口要求见5.2和5.3。 5.2 文件接口 5.2.1概述 文件接口是数据需求方购买数据后由数据交易平台为其提供的下载地址，通过下载地址可获取所 购买的数据文件。 5.2.2文件接口说明要求 文件接口说明应包括但不限于： a）文件下载地址：可获取到数据文件的URL地址； 示例1：http：//fileXxXjiaoyi.com/common_flowers/download?name=金钱兜&accesstoken=您申请的AC- CESSTOKEN。 b）文件类型：数据文件的存储格式说明； 示例2：.xls文件。 c）文件大小：数据文件的存储空间大小或数据量的描述； 示例3：5MB。 d) 附加说明：数据文件的其他说明。 5.3 API接口 5.3.1概述 API接口是数据提供方通过数据交易平台提供的数据获取方式，数据需求方通过调用数据提供方 定义的API接口获取所购买的数据。 5.3.2API接口说明要求 API接口说明应包括但不限于： a) 接口名称：交易数据主题内容的简要和概况性描述，名称突出数据内容指向的对象以及对象具 有的显著特征，如时间特征、地域特征和行业特征等； 示例1：常见花卉数据查询。 b）接口描述：接口的功能性描述 示例2：接口提供常见花卉数据查询，维度有名称、拉丁名、别名、分类、科属、盛花期、简介。 c）接口地址：接口的调用地址； 示例3：http：//api.XXXjiaoyi.com/common_flowers/query。 d）请求方式：对数据进行操作采用的类型，可采用GET或POST等方式； 2 GB/T40094.3—2021 示例4：httpGET e）请求示例：请求数据的接口地址示例说明； TOKEN。 请求参数：访问接口时必要的或可选的参数·说明参数名称、类型、是否必填、示例值和描述说 明等；其中，必要参数应给出调用API所需的唯一身份令牌； 示例6： 名称 类型 必填 示例值 描述 系统级别输人参数 access_token String 是 您申请的ACCESSTOKEN 应用级别输人参数 String 是 金钱兜 name 名称 g） 返回结果：请求数据后，系统返回的请求结果。包括但不限于返回状态代码、返回消息说明和 数据信息等内容；返回结果可采用JSON(JS对象简谱，JavaScriptObjectNotation）等格式； 示例7： "status":200, "success":true, "message"："查询成功"， "data":L "name"："金钱兜"， "latinName":"PolysciasbalfourianaBailey", "alias"："圆叶南洋森、圆叶福禄桐、金钱多多”， "classification"："灌木花卉”， "genera"："植物界被子植物门双子叶植物纲伞形目五加科南洋参属"， "floweringPeriod"："秋季冬季"， "brieflntroduction"："金钱兜因叶子像圆肚兜而得名，又叫金钱多多，因树叶圆形而呈兜状，称 作钱兜寓意吉祥富贵。在香港、台湾是很受欢迎的室内植物，金钱兜室内养护要注意放在有散射光的地方，一天 中有一些阳光直射也可以。性喜高温多湿，耐旱耐阴。姿态优美，古色古香，适合布置于客厅、庭园、花圃，亦可作 盆景欣赏。主供盆栽，庭园树及绿篱。接触其汁液，可能引起发红疹；碰到口部时，有时会引起肿痛而无法吞咽。" 1 h) 返回字段说明：返回结果中数据信息的字段说明，包括但不限于字段的名称、类型、示例值和描 述说明等； 示例8： 名称 类型 示例值 描述 String 金钱兜 name 名称 String Polyscias balfouriana Bailey latinName 拉丁名 3 GB/T40094.3—2021 名称 类型 示例值 描述 String 圆叶南洋森、圆叶福禄桐、金钱多多 别名 classification suns 灌木花卉 分类 String 植物界被子植物门 genera 科属 String 秋季冬季 floweringPeriod 盛花期 String 金钱兜因叶子像圆肚兜而得名 brieflntroduction 简介 D) 返回状态代码：请求数据后，系统返回的状态代码及其说明。 示例9： 返回状态代码 说明 200 成功 300 缺少名称参数 301 未查询到数据 302 请求参数不存在 请求过于频繁，请稍后再试 304 access_token参数不能为空 305 该IP已被禁用 306 商家接口调用异常，请稍后再试 307 access_token令牌无效 308 调用API网关失败，请与客服联系 6 证实方法 6.1 电子商务或电子商务数据交易软件检测机构检查数据交易平台提供的数据接口方式是否符合第4 章要求，对不符合要求的数据交易平台进行整改，直至符合第4章的要求。 6.2 2电子商务或电子商务数据交易软件检测机构检查数据交易平台提供的身份认证、文件接口和API 接口是否符合5.1～5.3的要求，对不符合要求的数据交易平台进行整改，直至符合5.1～5.3的要求 6.3 3数据交易平台检查数据提供方提供的文件接口和API接口是否符合5.2和5.3的要求，对不符合 要求的，数据提供方进行整改，直至符合5.2和5.3的要求。 4