电子商务数据交易平台 数据接口规范（征求意见稿）

ICSFORMTEXT35.240.60FORMTEXTA10中华人民共和国国家标准GB/TFORMTEXTXXXXX—FORMTEXTXXXXFORMTEXTFORMTEXT电子商务数据交易平台数据接口规范FORMTEXTE-commercedatatransactionplatform——

SpecificationfordatainterfaceFORMTEXTFORMTEXTFORMTEXTXXXX-FORMTEXTXX-FORMTEXTXX发布FORMTEXTXXXX-FORMTEXTXX-FORMTEXTXX实施GB/TXXXXX—XXXX前言 II1范围 12规范性引用文件 13术语、定义和缩略语 14数据接口类型 35数据获取接口方式 36数据获取接口说明 37数据接口内容 6电子商务数据交易平台数据接口规范范围本标准规定了电子商务数据交易平台的数据接口类型、数据获取接口方式、数据获取接口说明和数据接口内容。本标准适用于电子商务数据交易平台的交易主体之间的数据传输获取。规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T2260中华人民共和国行政区划代码GB/T2659世界各国和地区名称代码GB/T4754国民经济行业分类GB/T4880.1语种名称代码第1部分：2字母代码GB/T4881中国语种代码GB/T5271.1信息技术词汇第1部分：基本术语GB/T7408数据元和交换格式信息交换日期和时间表示法（ISO8601:2000,IDT）GB/T32670电子商务交易产品信息描述服装GB/T35408电子商务质量管理术语GB/TXXX电子商务数据交易数据描述规范术语、定义和缩略语术语和定义下列术语和定义适用于本文件。电子商务E-commerce通过信息网络进行产品和服务交易的经营活动。[GB/T35408，定义2.1.1]数据data信息的可再解释的信息化表示，以适用于通信、解释和处理。一个概念模型表示人们对一个体系的理解。[GB/T5271.1，定义01.01.02]电子商务数据交易平台E-commercedatatransactionplatform在电子商务模式下为交易双方或多方提供数据交易撮合及相关服务的信息网络系统。交易主体transactionsubject经由电子商务数据交易平台根据有关法律法规及电子商务数据交易平台的有关规定审核批准，在电子商务数据交易平台进行数据交易的组织或个人。分为：数据提供方：即卖方，利用电子商务数据交易平台出售数据或提供服务；数据需求方：即买方，利用电子商务数据交易平台购买数据或获取服务。本标准只涉及数据交易，不包括服务交易。数据提供方datasupplier在电子商务数据交易中，拥有数据所有权或受数据所有者合法授权而获得部分或全部权益的向平台提供交易数据的组织或个人。数据需求方datademander在电子商务数据交易中发布数据需求或搜索、购买数据的组织或个人。数据文件datafile用于电子商务数据交易平台数据传输的文件。信息元素informationelement信息的基本单元。与UML术语中的属性同义。信息元素在信息实体中是唯一的。[GB/T32670，定义3.4]信息实体informationentity一组说明数据相同特性的信息元素。与UML术语中的类同义。可以包含一个或一个以上信息实体。[GB/T32670，定义3.5]缩略语下列缩略语适用于本文件。API应用程序编程接口（ApplicationProgrammingInterface）URL统一资源定位符（UniformResourceLocator）数据接口类型平台应提供一系列的接口，包括但不限于：登录接口（可授权第三方登录）；身份认证接口；目录列表和查询接口；数据发布接口；数据获取接口；支付接口。本标准主要规范数据获取接口的相关要求，其他接口的技术要求应遵循法律法规、国家标准的相关规定。数据获取接口方式数据获取接口方式包括但不限于：文件接口：以电子文件形式传输数据、交换信息的接口方式；API接口：基于http（超文本传输协议，HypertextTransferProtocol）或https

（超文本传输安全协议，HypertextTransferProtocolSecure）网络协议的网络服务，用于交易主体之间传输获取数据的接口方式。数据获取接口说明文件接口概述文件接口是数据需求方购买数据后由电子商务数据交易平台为其提供的下载端口，通过端口可直接获取所购买的数据文件。接口说明文件接口说明包括但不限于：文件下载地址：可获取到数据文件的URL地址；URL一般包括模式或协议、服务器名称或IP（互联网协议地址，InternetProtocolAddress）地址、路径和文件名等；协议：//用户名:密码@子域名.域名.顶级域名:端口号/目录/文件名.文件后缀?参数=值#标志文件类型：数据文件的存储格式说明；CSV文件文件大小：数据文件的数据量描述；1000条附加说明：数据文件的其他说明。API接口概述API接口是获得所有数据集唯一访问标识列表，数据需求方通过数据提供方定义的接口参数可获取到购买的数据。接口说明API接口说明包括但不限于：接口标识：赋予API接口的唯一标识；由平台或数据提供方自定义；common_flowers接口名称：接口传输的数据核心内容的简要、概况性描述，应突出数据内容指向的对象以及对象具有的显著特征，如时间特征、地域特征、行业特征等；由数据提供方自定义；常见花卉数据查询接口描述：接口的功能描述；由数据提供方自定义；接口提供常见花卉数据查询，维度有名称，拉丁名，别名，分类，科属，盛花期，简介接口地址：接口的URL访问地址；由数据提供方自定义；http://api.XXX/commonFlowers/query请求方式：对数据进行操作采用的类型，可采用GET或POST等方式；由数据提供方自定义；httpGET请求示例：请求数据的接口地址示例说明；由数据提供方自定义；http://api.XXX/commonFlowers/query?name=金钱兜&access_token=您申请的ACCESSTOKEN请求参数：访问接口时必要的或可选的参数，应说明参数的名称、类型、是否必填、示例值和描述说明等属性；由数据提供方自定义；名称类型必填示例值描述系统级别输入参数access_tokenString是-您申请的ACCESSTOKEN应用级别输入参数nameString是金钱兜名称返回参数：请求数据后，系统返回的相关参数，应说明参数的名称、类型、示例值和描述说明等属性；由数据提供方自定义；系统级别返回参数错误描述Status状态码，200表示成功Message返回信息Data返回数据应用级别返回参数名称类型示例值描述statusString200返回状态码messageString查询成功状态说明nameString金钱兜名称latinNameStringPolysciasbalfourianaBailey拉丁名aliasString圆叶南洋森、圆叶福禄桐、金钱多多别名classificationString灌木花卉分类generaString植物界被子植物门科属floweringPeriodString秋季冬季盛花期briefIntroductionString金钱兜因叶子像圆肚兜而得名简介返回示例：请求数据是否成功的返回示例；由数据提供方自定义；{{"status":200,"success":true,"message":"查询成功","data":[{"name":"金钱兜","latinName":"PolysciasbalfourianaBailey","alias":"圆叶南洋森、圆叶福禄桐、金钱多多","classification":"灌木花卉","genera":"植物界被子植物门双子叶植物纲伞形目五加科南洋参属","floweringPeriod":"秋季冬季","briefIntroduction":"金钱兜因叶子像圆肚兜而得名，又叫金钱多多，因树叶圆形而呈兜状，称作钱兜寓意吉祥富贵。在香港、台湾是很受欢迎的室内植物，金钱兜室内养护要注意放在有散射光的地方，一天中有一些阳光直射也可以。性喜高温多湿，耐旱耐阴。姿态优美，古色古香，适合布置于客厅、庭园、花圃，亦可作盆景欣赏。主供盆栽，庭园树及绿篱。接触其汁液，可能引起发红疹；碰到口部时，有时会引起肿痛而无法吞咽。"}]}返回格式：返回信息中需要描述返回的状态代码，返回消息说明，附加的数据信息，如JSON（JS对象简谱，JavaScript

ObjectNotation）格式；由数据提供方自定义；错误码参照：请求数据后，系统返回的错误码及其返回说明。系统级别错误码错误描述3004请求参数不存在3005请求过于频繁，请稍后再试3006access_token参数不能为空3007该IP已被禁用3008接口需要付费，请充值3009商家接口调用异常，请稍后再试3010access_token令牌无效3011该数据只允许企业用户调用3012调用api网关失败，请与客服联系应用级别错误码错误描述300缺少名称参数301未查询到数据数据接口内容描述规则数据接口内容的描述规则应遵循GB/TXXX《电子商务数据交易数据描述规范》中的相关规定。接口内容本标准规定的数据接口内容包括但不限于查询、发布、认证、获取等接口涉及的内容，见表1。数据接口内容序号中文名称英文名称说明数据类型及格式约束/条件同义词值域计量单位备注1数据名称dataname交易数据在发布时采用的名称C..200M数据名称应突出数据内容指向的对象以及对象具有的显著特征，如时间特征、地域特征、行业特征等2数据标签datatag描述交易数据内容的核心关键词C..200M多个关键词之间以空格隔开3计费方式quotationmode交易数据定价采取的方式C..100O可以按照数据使用量、使用时长、调用次数等参数进行计费4数据价格dataprice交易数据价值的量化价格N..ul,2M人民币元可根据交易数据的数据规模、使用次数、提供方式等制定价格5数据规模datascale交易数据占据的存储空间大小、数据条数等C..200MKB、MB、条等6描述语种descriptionlanguage交易数据内容采用的描述语种的名称C..50C遵循GB/T4880.1和GB/T4881中的规定对于文本型数据内容该信息元素为必备7有效期限validityperiod交易数据具有可被购买、下载、使用或调用等属性的有效截止日期YYYYMMDD或YYYY-MM-DDM遵循GB/T7408中的规定8数据种类datatype一些可区分的数据的集合，这种区别由这些数据的性质以及对这些数据的应用所表征C..200M可以按照不同维度进行划分，如按照数据交易形式可分为API、数据包等，按照数据应用领域可分为政府数据、电商数据、金融数据等数据接口内容（续）序号中文名称英文名称说明数据类型及格式约束/条件同义词值域计量单位备注9数据存储格式data

storage

format数据在计算机内部或外部存储介质上的记录格式C..200M一般以扩展名表示，如“.txt”、“.doc”、“JPEG”、“AVI”等10数据简介dataprofile对交易数据主题内容的简要描述C..ulM11数据来源datasources交易数据的来源，如政府、企业、个人等C..200O12数据用途datafunction交易数据适用的范围、人群或应用的场景、业务及领域等方面的说明C..ulO13所属行业industry交易数据所属的国民经济行业的名称C..100O遵循GB/T4754中的规定14覆盖地区administrativedivision交易数据内容所涉及到的行政区划的名称C..200O遵循GB/T2659和GB/T2260中的规定15交付方式deliverymode交易数据交付成功采用的方法或途径C..50M主要包括线上传输、线下实体介质拷贝、API接口调用等16版权说明copyrightdescription数据所有权的归属信息说明C..200M17数据权限dataauthority数据提供方对数据需求方提出的数据行使权力的限制范围C..ulM18发布者publisher发布交易数据的机构或个人的中文名称C..200M本标准定义的发布者是指数据提供方数据接口内容（续）序号中文名称英文名称说明数据类型及格式约束/条件同义词值域计