GB/T 40094.3-2021 PDF in English
GB/T 40094.3-2021 (GB/T40094.3-2021, GBT 40094.3-2021, GBT40094.3-2021)
| Standard ID | Contents [version] | USD | STEP2 | [PDF] delivered in | Name of Chinese Standard | Status |
| GB/T 40094.3-2021 | English | 170 |
Add to Cart
|
0-9 seconds. Auto-delivery.
|
Electronic commerce data transaction - Part 3: Data interface specification
| Valid |
Standards related to: GB/T 40094.3-2021
PDF Preview
GB/T 40094.3-2021: PDF in English (GBT 40094.3-2021) GB/T 40094.3-2021
GB
NATIONAL STANDARD OF THE
PEOPLE’S REPUBLIC OF CHINA
ICS 35.240.01
A 10
Electronic commerce data transaction - Part 3: Data
interface specification
ISSUED ON: MAY 21, 2021
IMPLEMENTED ON: DECEMBER 1, 2021
Issued by: State Administration for Market Regulation;
Standardization Administration of PRC.
Table of Contents
Foreword ... 3
1 Scope ... 4
2 Normative references ... 4
3 Terms, definitions, and abbreviations ... 4
4 Data interface mode ... 5
5 Data interface requirements ... 5
6 Verification method ... 8
References ... 10
Electronic commerce data transaction - Part3: Data
interface specification
1 Scope
This part of GB/T 40094 specifies the data interface modes, data interface requirements,
and verification method of the e-commerce data transaction platform.
This part applies to data acquisition between transaction subjects of e-commerce data
transaction platforms.
2 Normative references
The following documents are essential to the application of this document. For the dated
documents, only the versions with the dates indicated are applicable to this document;
for the undated documents, only the latest version (including all the amendments) is
applicable to this standard.
GB/T 40094.1-2021 Electronic commerce data transaction - Part 1: Criteria
GB/T 40094.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/T 40094.1-2021, GB/T 40094.2-2021, and the
following apply to this document.
3.1.1 data file
The file that is used for data transfer of e-commerce data transaction platform.
3.2 Abbreviations
The following abbreviations apply to this document.
API: Application Programming Interface
URL: Uniform Resources Locator
4 Data interface mode
The data interface modes provided by the data transaction platform shall include but
are not limited to:
a) File interface: Based on the network service of Hypertext Transfer Protocol
(HTTP) or Hypertext Transfer Protocol Secure (HTTPS) network protocol, a way
to transmit data and exchange information in the form of electronic files;
b) API interface: Based on the network service of HTTP or HTTPS network protocol,
a way that is used between transaction subjects to obtain data through the call on
the API interface.
5 Data interface requirements
5.1 Identity authentication
The data demander shall obtain data according to the data interface defined by the data
transaction platform or data provider after passing the identity authentication. Relevant
requirements shall include but not be limited to:
a) The data demander requests the data transaction platform for identity
authentication through the username/password;
b) After the data demander passes the authentication, the data transaction platform
provides an identity token for the data demander;
c) The data demander obtains data according to the requirements of the interface
mode and interface description provided by the data transaction platform or the
data provider. For specific interface requirements, see 5.2 and 5.3.
5.2 File interface
5.2.1 Overview
The file interface is the download address provided by the data transaction platform
after the data demander purchases the data, and the purchased data file can be obtained
through the download address.
5.2.2 Requirements for file interface description
The file interface description shall include but not be limited to:
a) File download address: the URL address by which the data file can be obtained;
Example 1: http://file.XXXjiaoyi.com/common_flowers/download?name=Money-
Pocket&access_token=YOUR-ACCESSTOKEN.
b) File type: the description of the storage format of the data file;
Example 2: Files in the format of .xls.
c) File size: the description of the storage space size required by the data file or the
amount of the data;
Example 3: 5 MB.
d) Additional notes: other description of the data file.
5.3 API interface
5.3.1 Overview
The API interface is the data acquisition method offered by the data provider through
the data transaction platform, and the data demander obtains the purchased data by
calling the API interface defined by the data provider.
5.3.2 Requirements for API interface description
API interface description shall include but not be limited to:
a) Interface name: a brief and general description of the subject content of the traded
data; the name shall highlight the object pointed to by the data content and the
salient characteristics of the object, such as time characteristics, geographical
characteristics, and industry characteristics;
Example 1: Common flower data query.
b) Interface description: functional description of the interface;
Example 2: The interface provides a common flower data query, and the dimensions include
name, Latin name, alias, classification, family, genus, blooming period, and introduction.
c) Interface address: the calling address of the interface;
Example 3: http://api.XXXjiaoyi.com/common_flowers/query.
d) Request method: the type that is used for the operation of the data, such as GET
or POST;
Example 4: http GET.
e) Request example: an example of the request for the interface address of the data;
......
Source: Above contents are excerpted from the PDF -- translated/reviewed by: www.chinesestandard.net / Wayne Zheng et al.
|