GB/T 38963-2020Personal health information code-Application interface (English PDF)
个人健康信息码 应用接口
This is a limited preview
Buy now to download the full PDF (17 pages)
Need quotation for your management?
Get a formal quotation for GB/T 38963-2020 in 30 minutes.
Issued by
SAMR; SAC
Level / Type
National · Recommended
Issue date
April 29, 2020
Implementation date
April 29, 2020
Scope
GB/T 38963-2020 is the English-translated version of 个人健康信息码 应用接口.
GB/T 38963-2020 is the Chinese standard "Personal health information code-Application interface". Its scope clause reads: This standard specifies the interface rules, interface descriptions and interface applications of personal health service interfaces.
This standard is applicable to the design, development and system integration of personal health information related application systems. Its clauses include terms and definitions; abbreviations; interface rules; interface description.
Found what you need?
Document preview — GB/T 38963-2020
National Standard of the People's Republic of China
- ICS
- 35.240.99
- Classification
- L 65
Issued by: State Administration for Market Regulation; Standardization Administration of the PRC
Contents
- Foreword i
- Introduction ii
- 1 Scope
- 2 Normative references
- 3 Terms and definitions
- 4 Abbreviations
- 5 Interface rules
- 5.1 Interface mode
- 5.2 Service type
- 6 Interface description
- 6.1 General
- 6.2 Declaration of user health information
- 6.3 User travel declaration interface
- 6.4 User health information query
- 6.5 Health code calling request interface
- 6.6 Query interface for generating health code
- 6.7 Query interface for verifying health code
- 6.8 Error correction interface of user health information
- 7 Interface application
- 7.1 Application Modes
- 7.2 Linking mode
- Annex A (informative) Operation instructions of BizExtData field in health code
- Annex B (informative) Description of interface return code
- Annex C (informative) Example of calling of health code generation and verification
- Bibliography
1 Scope
This standard specifies the interface rules, interface descriptions and interface applications of personal health service interfaces.
This standard is applicable to the design, development and system integration of personal health information related application systems.
2 Normative references
The following referenced documents are indispensable for the application of this standard. For dated reference, only the edition cited applies. For undated references, the latest edition of the referenced document (including any amendments) applies.
GB/T 2260
Codes for the administrative divisions of the People’s Republic of China
Personal health information code — Reference model
3 Terms and definitions
For the purposes of this document, the terms and definitions given in GB/T 38961-2020 apply.
4 Abbreviations
For the purposes of this document, the following abbreviations apply.
HTTP: HyperText Transfer Protocol
JSON: JavaScript Object Notation
REST: Representational State Transfer
WEB: World Wide Web
5 Interface rules
5.1 Interface mode
2
The personal health information service system shall adopt the Web service conforming to the REST architecture principle when publishing services and receiving requests.
5.2 Service type
See Table 1 for description of service types related to health codes.
Table 1 Description of service type
No.
Service type
Service name
1
1000
Health code calling request interface
2
2000
Health code generation interface
3
3000
Health code verification interface
See Table 2 for the description of the verification mode in the health code generation interface.
Table 2 Description for the verification mode in the health code generation interface
No.
Code
Mode name
1
G100
Code generation of residential identity network identifier
2
G010
Code generation of web certificate data
See Table 3 for the description of the verification mode in the health code verification interface.
Table 3 Description of the verification mode in the verification interface
No.
Code
Mode name
1
V000
Business verification code
2
V033
Identity + business verification code
3
V034
Identity + portrait + business verification code
6 Interface description
6.1 General
See Table 4 for the interface types and descriptions.
3
Table 4 Interface types and descriptions
No.
Interface type
Interface description
1
User health information declaration interface
Upload health data information declared by users
2
User travel information declaration interface
Upload the data information of the user's travel within the specified time range (for example, 14 days)
3
User health information query interface
Query the personal health information and travel information of the user within a certain period of time. The default query period is the time specified by relevant departments (for example, 14 days)
4
Health code calling request interface
Before the client initiates a business application (such as code generation and code for verification, etc.) to the server, it needs to apply for session permission through this interface
5
Query interface for generating health code
Send code generation request to the background of the health code application system
6
Query interface for verifying health code
Send code verification request to the background of the health code application system
7
Error correction interface of user health information
Send a request for correcting relevant information to the background of the health code application system
6.2 Declaration of user health information
6.2.1 Calling mode
The user health information declaration interface shall be called through the Internet or the National E-Government Network.
6.2.2 Parameter requirements
See Table 5 for parameter requirements of user health information declaration interface.
Table 5 Parameter requirements of user health information declaration interface
Category
Parameter
Required or not
Data
Type
Description
Input parameter
AccountId
Yes
Character string
Authorized account
AccessToken
Yes
Character string
Access token
BizExtData
Yes
Character string
See Annex A for the values spliced according to the form determined in 4.2 of GB/T 38961-2020 and encrypted by key
Phone
No
Character string
Contact number (telephone number of direct relatives may be filled in)
21
Bibliography
[1] GB/T 38962-2020 Personal health information code — Data format
___________________________________________________ __________________________________ _________________ __________________________________ _________________ __________________________________ […]
......
This preview omits tables, figures, formulas and parts of the technical clauses. The complete document — 17 pages — is available in the English PDF.
Similar standards
How to Download GB/T 38963-2020
- 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
Fast delivery
After payment you'll receive an email confirmation. The English PDF is sent to the same address, usually within minutes and at the latest within 1 business day.
- 4
Invoice included
A tax invoice is attached to the confirmation email. Need a custom invoice? Contact us.
Related Standards
GB/T 10003-2026 — Biaxially oriented polypropylene (BOPP) film
GB/T 10004-2026 — Plastic/Plastic laminated films and pouches for packaging
GB/T 10007-2026 — Rigid cellular plastics - Determination of shear properties
GB/T 38963-2020
$300.00