GB/T 38963-2020 in English
VALIDPersonal health information code-Application interface
- Issued on:2020-04-29
- Implemented on:2020-04-29
- File Format:PDF
- Delivery:Via email within 1~3 business days
$301.00
| Standard No: | GB/T 38963-2020 |
| Document status: | VALID |
| Title in English: | Personal health information code-Application interface |
| Title in Chinese: | 个人健康信息码 应用接口 |
| Language: | English |
| File Format: | Electronic (PDF) |
| Delivery: | Via email within 1~3 business days |
| Issued on: | 2020-04-29 |
| Implemented on: | 2020-04-29 |
| ICS Classification: | 35.240.99-IT applications in other fields |
| Chinese Classification: | L65-System equipment interface |
| Professional Classification: | GB-National Standard |
| Related Topics: | health information
Analyze application health health declaration personal information personal information personal health personal health information GBT38963 GB/T 38963-2020 The role of personal information standard contract Healthy Space Technology Application |
《GB/T 38963-2020个人健康信息码 应用接口》由TC28(全国信息技术标准化技术委员会)归口,TC28SC28(全国信息技术标准化技术委员会办公机器、外围设备和耗材分会)执行,主管部门为国家标准化管理委员会。
Introduction
Standard Background and Significance
As a technical specification urgently formulated during the epidemic prevention and control period, this standard solves the problem of mutual recognition of health code systems in various places. Through a unified interface protocol, the intercommunication of health data of 31 provincial administrative regions across the country is achieved, supporting more than 1 billion calls per day.
Core Interface Specifications
| Interface Type | Calling Method | Key Parameters | Return Code |
|---|---|---|---|
| Code Request Interface | RESTful Web | authMode(verification mode), bizExtData(encrypted data) | B110205(generation failed) |
| Code Verification Request Interface | HTTPS POST | qrCode(QR code string), photoData(portrait data) | B110304(invalid barcode) |
| Information Error Correction Interface | JSON-RPC | ErrorType(error classification), Description(problem description) | 12(parameter is empty) |
Key technology implementation
Data encryption scheme
Use asymmetric encryption to process sensitive information. Example:
Plain text format: "Name|ID number|CHN^20200320"
Encrypted output: Base64 encoding after RSA public key encryption is stored in the BizExtData field
Risk level determination
Implemented through the three-color code system:
00 (green code) - low risk | 01 (yellow code) - medium risk | 10 (red code) - high risk
The basis for judgment includes:
- Travel trajectory within 14 days (fxdj field)
- Body temperature data (Temperature field)
- Contact history (IsPatientContactRisk field)
Implementation suggestions
- System connection: G100 resident network identity coding mode is preferred, compatible with the Ministry of Public Security CTID system
- Exception handling: An automatic retry mechanism needs to be established for B120200 system exception codes
- Performance optimization: It is recommended to cache administrative division codes (Xzqhdm) to reduce the query frequency of GB/T2260
Evolution direction
The standard will be expanded in the future:
1. Vaccination data interface
2. Mutual recognition of nucleic acid test results
3. Cross-border health code interoperability mechanism
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

Loading PDF document...
Error loading PDF. Please make sure the file is valid and try again.