GB/T 40094.3-2021Electronic commerce data transaction—Part 3: Data interface specification (English PDF)
电子商务数据交易 第3部分：数据接口规范
This is a limited preview
Buy now to download the full PDF (15 pages)
Need quotation for your management?
Get a formal quotation for GB/T 40094.3-2021 in 30 minutes.
Issued by
SAMR; SAC
Level / Type
National · Recommended
Issue date
May 21, 2021
Implementation date
December 1, 2021
Scope
GB/T 40094.3-2021 is the English-translated version of 电子商务数据交易 第3部分：数据接口规范.
GB/T 40094.3-2021, Part 3 of the GB/T 40094 series on e-commerce data transactions, specifies the data interface modes, the data interface requirements and the verification method for e-commerce data transaction platforms.
It recognises two modes, both running over HTTP or HTTPS: a file interface, through which a purchased data file is downloaded from an address, and an API interface, which is called to obtain the data.
Before obtaining data, the data demander has to pass identity authentication and receives an identity token. For each mode the standard lists what the interface description shall contain, such as the download address, file type and file size, or the interface name, address and request method.
It applies to data acquisition between transaction subjects on these platforms. It was issued on 21 May 2021 and has applied since 1 December 2021.
Found what you need?
Document preview — GB/T 40094.3-2021
National Standard of the People's Republic of China
- ICS
- 35.240.01
- Classification
- A 10
Issued by: State Administration for Market Regulation; Standardization Administration of the PRC
Contents
- Foreword3
- 1 Scope4
- 2 Normative references4
- 3 Terms, definitions, and abbreviations4
- 4 Data interface mode5
- 5 Data interface requirements5
- 6 Verification method8
- References10
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; […]
......
This preview omits tables, figures, formulas and parts of the technical clauses. The complete document — 15 pages — is available in the English PDF.
Referenced standards
Similar standards
How to Download GB/T 40094.3-2021
- 1
Add to cart
Click "Download PDF" on this page and choose "Buy this standard". You can add more standards before checkout.
- 2
Checkout
Enter your email and billing details. Payment is processed securely by Stripe (cards or bank transfer). Prefer bank details? Request a quotation (min. order $300).
- 3
Instant delivery (0–9 sec)
Delivery is automatic: within seconds of payment you'll receive an email with a secure download link. The link stays valid for 72 hours.
- 4
Invoice included
A tax invoice is attached to the confirmation email. Need a custom invoice? Contact us.
Related Standards
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
GB/T 40094.4-2021 — Electronic commerce data transaction—Part 4: Privacy protection specification
Secure payment via Stripe
Payments accepted
GB/T 40094.3-2021
$150.00