(高清版)GBT 40094.3-2021 电子商务数据交易 第3部分：数据接口规范

ICS35.240.01第3部分：数据接口规范国家市场监督管理总局国家标准化管理委员会IGB/T40094.3—2021 12规范性引用文件 1 14数据接口方式 15数据接口要求 2 4参考文献 5ⅢGB/T40094.3—2021GB/T40094《电子商务数据交易》——第1部分：准则；本部分为GB/T40094的第3部分。本部分按照GB/T1.1—2009给出的规则起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本部分由全国电子业务标准化技术委员会(SAC/TC83)提出并归口。本部分起草单位：北京安宏睿业科技有限公司、合肥状元郎电子科技有限公司、广东源创智能科技有限公司、北京中普至信标准化咨询事务所、厦门荆艺软件有限公司、东莞市衣电园实业投资有限公司、福建德化陶知然陶瓷文化创意有限公司、广东新安怀电子商务有限公司、中国标准化研究院、北京无界标准科技有限公司、浙江省林业技术推广总站、广东奇化化工交易中心股份有限公司、广东路霸克机电品科技有限公司、山东省中智科标准化研究院有限公司、福建海西标准化技术服务事务所有限公司、北京中金永嘉大数据技术有限公司、北京阿拉丁火焱大数据科技有限公司。1GB/T40094.3—2021电子商务数据交易第3部分：数据接口规范1范围GB/T40094的本部分规定了电子商务数据交易平台的数据接口方式、数据接口要求和证实方法。本部分适用于电子商务数据交易平台的交易主体之间的数据获取。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。GB/T40094.1—2021电子商务数据交易第1部分：准则GB/T40094.2—2021电子商务数据交易第2部分：数据描述规范3.1术语和定义GB/T40094.1—2021、GB/T40094.2—2021界定的以及下列术语和定义适用于本文件。3.1.1数据文件datafile用于电子商务数据交易平台数据传输的文件。下列缩略语适用于本文件。API:应用程序编程接口(ApplicationProgrammingInterface)URL:统一资源定位符(UniformResourceLocator)4数据接口方式数据交易平台提供的数据接口方式应包括但不限于：a)文件接口：基于超文本传输协议(HTTP)或超文本传输安全协议(HTTPS)网络协议的网络服b)API接口：基于HTTP或HTTPS网络协议的网络服务，用于交易主体之间通过调用API接口获取数据的方式。2GB/T40094.3—20215数据接口要求5.1身份认证数据需求方应通过身份认证申请后，按照数据交易平台或数据提供方定义的数据接口获取数据。相关要求应包括但不限于：a)数据需求方通过用户名/密码向数据交易平台请求身份认证；b)通过认证后，由数据交易平台为数据需求方提供一个身份令牌；c)数据需求方按照数据交易平台或数据提供方提供的接口方式、接口说明等要求来获取数据，具体接口要求见5.2和5.3。5.2文件接口文件接口是数据需求方购买数据后由数据交易平台为其提供的下载地址，通过下载地址可获取所购买的数据文件。文件接口说明应包括但不限于：a)文件下载地址：可获取到数据文件的URL地址；示例1:http://file.XXX/common_flowers/download?name=CESSTOKEN。b)文件类型：数据文件的存储格式说明；金钱兜&accesstoken=您申请的AC-示例2:.xls文件。c)文件大小：数据文件的存储空间大小或数据量的描述；示例3:5MB。5.3API接口API接口是数据提供方通过数据交易平台提供的数据获取方式，数据需求方通过调用数据提供方定义的API接口获取所购买的数据。5.3.2API接口说明要求API接口说明应包括但不限于：a)接口名称：交易数据主题内容的简要和概况性描述，名称突出数据内容指向的对象以及对象具示例1:常见花卉数据查询。b)接口描述：接口的功能性描述；示例3:http://api.XXX/common_flowers/query。d)请求方式：对数据进行操作采用的类型，可采用GET或POST等方式；3示例5:http://api.XXX/common_flowers/query?name=GB/T40094.3—2021金钱兜&-access_token=您申请的ACCESS-TOKEN。示例6:名称类型必填示例值描述系统级别输入参数access_tokenString是您申请的ACCESSTOKEN应用级别输入参数nameString是金钱兜名称示例7:{{"status":200,"success":true,"message":"查询成功",{"name":"金钱兜","latinName":"PolysciasbalfourianaBailey","classification":"灌木花卉","genera":"植物界被子植物门双子叶植物纲伞形目五加科南洋参属",}]}示例8:名称类型示例值描述String金钱兜名称latinNameStringPolysciasbalfourianaBailey拉丁名4GB/T40094.3—2021名称类型示例值描述圆叶南洋森、圆叶福禄桐、金钱多多别名灌木花卉分类植物界被子植物门科属秋季冬季盛花期briefIntroduction金钱兜因叶子像圆肚兜而得名简介i)返回状态代码：请求数据后，系统返回的状态代码及其说明。示例9:返回状态代码说明成功缺少名称参数未查询到数据请求参数不存在请求过于频繁，请稍后再试access_token参数不能为空该IP已被禁用商家接口调用异常，请稍后再试access_token令牌无效调用API网关失败，请与客服联系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的要