Electronic commerce data transaction—Part 3:Data interface specification
other information
drafter:Ma Jianhong, Li Yuanli, Jiang Zhimou, Zhou Bowei, Jin Zhenhua, Hou Mingyue, Liu Ying, Zhang Minggui, Li Chunlan, Wang Wei, Zhang Hongde, Yi Yunkui, Liang Xijun, Lin Wenbo, Jiang Jianhao, Chen Maiqi, Zhang Ke, Jiang Dianchen, Zhang Yueyi, Hu Lijiang, Cui Congjun, Lin Ying, Hao Fengying, Liu Yanan
Drafting unit:Beijing Anhong Ruiye Technology Co., Ltd., Hefei Zhuangyuanlang Electronic Technology Co., Ltd., Guangdong Yuanchuang Intelligent Technology Co., Ltd., Beijing Zhongpu Zhixin Standardization Consulting Firm, Xiamen Jingyi Software Co., Ltd., Dongguan
Focal point unit:National Electronic Business Standardization Technical Committee (SAC/TC 83)
Proposing unit:National Electronic Business Standardization Technical Committee (SAC/TC 83)
Publishing department:State Administration for Market Regulation National Standardization Administration
Some standard content:
ICS35.240.01
National Standard of the People's Republic of China
GB/T40094.3—2021
Electronic commerce data transaction
Part 3: Data interface specification
Electronic commerce data transactionPart 3:Data interface specification2021-05-21Promulgated
State Administration for Market Regulation
National Administration of Standardization
2021-12-01Implementation
-riKacerKAca-
2Normative references
3Terms, definitions and abbreviations·
4Data interface mode
5Data interface requirements
6Verification method
References··
-rKaeerKa-
GB/T 40094.3—2021
-riKacerKAca-
GB/T40094 "E-commerce Data Transaction" is divided into the following parts: Part 1: Guidelines:
Part 2: Data Description Specification;
-Part 3: Data Interface Specification:
-Part 1: Privacy Protection Specification,
This part is Part 3 of GB/T40094
This part is drafted in accordance with the rules of GB/T1.12009. GB/T40094.3—2021
Please note that some contents of this document may involve patents. The issuing agency of this document does not assume the responsibility for identifying these patents. This part is proposed and attributed by the National Technical Committee for Standardization of Electronic Business (SAC/TC83). Drafting units of this part: Beijing Anhongrongye Technology Co., Ltd., Hebazhuangyuanlangdianliao Technology Co., Ltd., Guangdong Yuanchuang Intelligent Technology Co., Ltd., Beijing Zhongpuzhixin Standardization Consulting Office, Xiamen Jingyi Software Co., Ltd., Dongguan Yidianyuan Industrial Investment Co., Ltd., Fujian Dehua Taozhiran Ceramic Cultural Creativity Co., Ltd., Guangdong Xinanhuai E-Commerce Co., Ltd., China National Institute of Standardization, Beijing Wujie Standard Technology Co., Ltd., Zhejiang Forestry Technology Promotion Center, Guangdong Qihua Chemical Trading Center Co., Ltd., Guangdong Lujuke Mechanical and Electrical Equipment Co., Ltd., Foshan Weishang Furniture Manufacturing Co., Ltd., Zhejiang Heye Health Technology Co., Ltd., China University of Metrology, Chuzhou Xiduoduo Food Technology Co., Ltd., Shandong Zhongzhike Standardization Research Institute Co., Ltd., Fujian Haixi Standardization Technology Service Office Co., Ltd., Beijing Zhongjin Shuijiaren Data Technology Co., Ltd., Beijing Alahuoshuren Data Technology Co., Ltd. The main drafters of this part are: Ma Jianhong, Li Yuanli, Jiang Zhimou, Zhou Bowei, Jin Zhenhua, Hou Mingyue, Liu Ying, Zhang Minggui, Li Chunlan, Gan Wei, Zhang Hongde, Yi Yunkui, Liang Xigou, Lin Wenbo, Jiang Jianhao, Chen Maiqi, Zhang Ke, Jiang Dianchen, Zhang Yueyi, Hu Lijiang, Cui Congjun, Lin Ying, Hao Fengying, Liu Yenan.
rKaeerkAca-
-riKacerKAca-
1 Scope
E-commerce data transaction
Part 3: Data interface specification
GB/T 40094.3—2021
This part of GB/T40094 specifies the data interface mode, data interface requirements and verification methods of the e-commerce data transaction platform. This part applies to data acquisition between transaction entities of the e-commerce data transaction platform. 2 Normative references
The following documents are indispensable for the use of this document. For all references, the versions indicated apply to this document. For all undated references, the latest versions (including all amendments) apply to this document GB/T40094.1-2021 Electronic Commerce Data Transaction Part 1: Recommendation GB/T40094.2-2021, Electronic Commerce Data Transaction Part 2: Data Description Specification 3 Terms, Definitions and Abbreviations
3.1 Terms and Definitions
The terms and definitions defined in GB/T40094.1-2021 and GB/T40094.2-2021 and the following terms and definitions apply to this document: 3.1.1
Data file
datafile
File used for data transmission on the electronic commerce data transaction platform. 3.2 Abbreviations
The following abbreviations apply to this document.
API.J Application Programming Interface (Application Programming Interface) URI.: Uniform Resource Locator (Uniform Resource Locator) 4 Data Interface Methods
The data interface methods provided by the data trading platform include but are not limited to: a) File interface: a network service based on the Hypertext Transfer Protocol (HTTP) or Hypertext Transfer Secure Protocol (HTTPS) network protocol, which transmits data in the form of electronic files and exchanges information. b) API interface: a network service based on the HTTP or HTTPS network protocol. The transaction subject obtains data by calling the API interface.
rKaeerkca-
GB/T40094.3—2021
5 Data Interface Requirements
5.1 Identity Authentication
The data demander shall obtain data according to the data interface defined by the data trading platform or data provider after passing the identity authentication. The requirements include but are not limited to:
a) The data demander requests identity authentication from the data trading platform through the user name/password; b) After authentication, the data trading platform provides an identity token to the data demander; c) The data demander obtains data according to the interface method, interface description and other requirements provided by the data trading platform or data provider. The specific interface requirements are shown in 5.2 and 5.3.
5.2 File interface
5.2.1 Overview
The file interface is the download address provided by the data trading platform after the data demander purchases the data. The data file purchased can be obtained through the download address.
5.2.2 File interface description requirements
File interface description includes but is not limited to: a) File download address: URL address of the data file obtained: Example 1: http://file.xxxjiaoyi,com/commonflowers/download?name-余钱兜&.accestoken-your requested ACESSTOKEX.
b) File type: Storage format description of the data file: Example 2:,xls file
c) File size: Storage space size of the data file or description of the data volume; Example 3: 5MB.
d) Additional Notes: Other instructions for data files 5.3 API interface
5.3.1 Overview
The API interface is a data acquisition method provided by the data provider through the data trading platform. The data demander obtains the purchased data by calling the API interface defined by the data provider 5.3.2 API interface description requirements
The API interface description should include but is not limited to:
a) Interface name: A brief and general description of the transaction data content. The name highlights the object to which the data content points and its prominent features, such as time features, regional features and industry features. Example 1: Common flower data query.
b) Interface description: Functional description of the interface: Example 2: The interface provides flower data query with dimensions such as name, nickname, alias, classification, family, peak flowering period, and introduction. c) Interface address: the calling address of the interface; Example 3: http://rpi,XXXjinoyi.com/commonflowera/queryd) Request method: the type of operation on the data. It can be used (GE or PS, etc. rKaeerkAca-
Example 4: http GFT,
e) Request example: the interface address example description of the requested data; GB/T 40094.3—2021
Example 5: hltp://api.xxxjiaoyi.com/eommon_lowcrs/qucry?maine-money-see&acecss_token-the AccEss-TOKEN you requested.
Request parameters: necessary or optional parameters when accessing the interface, indicating the parameter name, type, whether it is required, example value and description, etc.; among them, the necessary parameters should give the unique identity token required to call the API: Example 6:
acresstoken
String
String
Example value
System-level input parameters
Application-level input parameters
Money bag
The ACCESSTOKEN you applied for
g) Return result: After requesting data, the system returns the same request result. Including but not limited to the return status code, return message description and data information, etc. The return result can be in JSON (IS Object Vocabulary) format, etc. Example 7:
\status\.200.
\suecess\: true.
\mcsage\: "Query successful\
\name\\money bag\.
\letinNeme\\Polyscias ballouriana Bailcy\\alias\"round-leaved Nanyang Sen, round-leaved Phlox, lots of money\,\clasaification\:\Shrub flower market"\genera\:"Plant kingdom Angiosperms Dicots Apiaceae Araliaceae Nanyang genus\\TlowcringPeriod\,\Autumn and winter\,\bricentlntrodution, "The money bag is named because it looks like a round bellyband, which means lots of money. Because the leaves are round and holy, it is called the money bag, which means ancient auspiciousness and wealth. It is a very popular indoor ornament in Hong Kong and Taiwan. When maintaining the money bag indoors, you should pay attention to placing it in a place with scattered light. There is some sunlight in the day. It is also OK. It is hot and humid, drought and resistant, beautiful and antique, suitable for decoration in guest rooms, gardens, and flower beds. It can also be used as a landscape, for planting, garden trees and green pipes. Contact with common juice waves may cause rashes; when Yao touches the part, it sometimes causes swelling and pain, blood loss, "h) Return field description: The field description of the data information in the return result, including but not limited to the field name, type, sample value and description, etc.:
Example 8:
latinName
String
String
Sample value
Money bag
Polyscias balfouriana Bailey-rrKaeerKAca-
Latin name
GB/T 40094.3—2021
elessification
gencra
floweringPeriucd
briefIntroduction
Striug
Striug
Striug
String
String
Example value
Round-leaved Nanyangsen, round-leaved Phlox, money-rich shrubs and flowers
Plant kingdom Angiosperms
Autumn and winter
Money-rich shrubs are named after their leaves that look like net liver bags
Return status code: After requesting data, the system returns the status code and its description. Example 9:
Return status code
6Verification method
Missing name parameter
No data found
Request parameter does not exist
Requests are too frequent. Please try again later
Access token parameter cannot be used
The IP has been banned
The merchant interface call is abnormal, please try again later. Access token token is invalid
Failed to call API gateway, please contact customer service
Blooming period
E-commerce or e-commerce data trading software testing agencies shall check whether the data interface method provided by the data trading platform complies with the requirements of Chapter 46.1
, and make rectifications to the data trading platform that does not meet the requirements until it complies with the requirements of Chapter 46.2 E-commerce or e-commerce data trading software testing agencies shall check whether the identity authentication file interface and API interface provided by the data trading platform comply with the requirements of 5.1~5.3. The data trading platform shall check whether the file interface and API interface provided by the data provider comply with the requirements of 5.2 and 5.3. If they do not meet the requirements, the data provider shall make rectifications until they meet the requirements of 5.2 and 5.3. -rKaeerkAca-
References
GB/T40094.3—2021
GB/T18391.12009 Information technology Metadata annotation system (MDR) Part 1: Framework
GB/T32670—2016 E-commerce transaction product information description Clothing
GB/T35408—2017
E-commerce quality management
-rrKaeerKAca-
GB/T40094.3-2021
Scan the code
Authentic service to
People's Republic of China
National Standard
E-commerce data transaction
Part 3: Data interface specification
GB/T 40091.32021
Published by China Standards Press
No. 2, Hepingli West Street, Xieyang District, Beijing (10(:029) No. 16, Shenghe North Street, Xicheng District, Beijing (100045) Website: spc.org.cn
Service hotline: 100-168-0010
First edition in May 2021
Book number: 135066·1680350
Copyright reserved
-rKaeerkca-
Infringements will be investigated3—2021
elessification
gencra
floweringPeriucd
briefIntroduction
Striug
Striug
Striug
String
String
Example value
Round-leaved Nanyangsen, Round-leaved Phlox, Money Tree Shrubs and Flowers
Plant KingdomAngiosperms
Autumn and Winter
Money Tree is named after its leaves that look like a net liver bag
Return status code: After requesting data, the system returns the status code and its description. Example 9:
Return status code
6Verification method
Missing name parameter
No data found
Request parameter does not exist
Requests are too frequent. Please try again later
Access token parameter cannot be used
The IP has been banned
The merchant interface call is abnormal, please try again later. Access token token is invalid
Failed to call API gateway, please contact customer service
Blooming period
E-commerce or e-commerce data trading software testing agencies shall check whether the data interface method provided by the data trading platform complies with the requirements of Chapter 46.1
, and make rectifications to the data trading platform that does not meet the requirements until it complies with the requirements of Chapter 46.2 E-commerce or e-commerce data trading software testing agencies shall check whether the identity authentication file interface and API interface provided by the data trading platform comply with the requirements of 5.1~5.3. The data trading platform shall check whether the file interface and API interface provided by the data provider comply with the requirements of 5.2 and 5.3. If they do not meet the requirements, the data provider shall make rectifications until they meet the requirements of 5.2 and 5.3. -rKaeerkAca-
References
GB/T40094.3—2021
GB/T18391.12009 Information technology Metadata annotation system (MDR) Part 1: Framework
GB/T32670—2016 E-commerce transaction product information description Clothing
GB/T35408—2017
E-commerce quality management
-rrKaeerKAca-
GB/T40094.3-2021
Scan the code
Authentic service to
People's Republic of China
National Standard
E-commerce data transaction
Part 3: Data interface specification
GB/T 40091.32021
Published by China Standards Press
No. 2, Hepingli West Street, Xieyang District, Beijing (10(:029) No. 16, Shenghe North Street, Xicheng District, Beijing (100045) Website: spc.org.cn
Service hotline: 100-168-0010
First edition in May 2021
Book number: 135066·1680350
Copyright reserved
-rKaeerkca-
Infringements will be investigated3—2021
elessification
gencra
floweringPeriucd
briefIntroduction
Striug
Striug
Striug
StringbZxz.net
String
Example value
Round-leaved Nanyangsen, Round-leaved Phlox, Money Tree Shrubs and Flowers
Plant KingdomAngiosperms
Autumn and Winter
Money Tree is named after its leaves that look like a net liver bag
Return status code: After requesting data, the system returns the status code and its description. Example 9:
Return status code
6Verification method
Missing name parameter
No data found
Request parameter does not exist
Requests are too frequent. Please try again later
Access token parameter cannot be used
The IP has been banned
The merchant interface call is abnormal, please try again later. Access token token is invalid
Failed to call API gateway, please contact customer service
Blooming period
E-commerce or e-commerce data trading software testing agencies shall check whether the data interface method provided by the data trading platform complies with the requirements of Chapter 46.1
, and make rectifications to the data trading platform that does not meet the requirements until it complies with the requirements of Chapter 46.2 E-commerce or e-commerce data trading software testing agencies shall check whether the identity authentication file interface and API interface provided by the data trading platform comply with the requirements of 5.1~5.3. The data trading platform shall check whether the file interface and API interface provided by the data provider comply with the requirements of 5.2 and 5.3. If they do not meet the requirements, the data provider shall make rectifications until they meet the requirements of 5.2 and 5.3. -rKaeerkAca-
References
GB/T40094.3—2021
GB/T18391.12009 Information technology Metadata annotation system (MDR) Part 1: Framework
GB/T32670—2016 E-commerce transaction product information description Clothing
GB/T35408—2017
E-commerce quality management
-rrKaeerKAca-
GB/T40094.3-2021
Scan the code
Authentic service to
People's Republic of China
National Standard
E-commerce data transaction
Part 3: Data interface specification
GB/T 40091.32021
Published by China Standards Press
No. 2, Hepingli West Street, Xieyang District, Beijing (10(:029) No. 16, Shenghe North Street, Xicheng District, Beijing (100045) Website: spc.org.cn
Service hotline: 100-168-0010
First edition in May 2021
Book number: 135066·1680350
Copyright reserved
-rKaeerkca-
Infringements will be investigated
Tip: This standard content only shows part of the intercepted content of the complete standard. If you need the complete standard, please go to the top to download the complete standard document for free.