Valid

GB/T 38963-2020Personal health information code-Application interface (English PDF)

个人健康信息码 应用接口

Preview 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. 1

    Add to cart

    Click "Download PDF" on this page and choose "Buy this standard". You can add more standards before checkout.

  2. 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. 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. 4

    Invoice included

    A tax invoice is attached to the confirmation email. Need a custom invoice? Contact us.

Related Standards

English PDF
17 pages
Fast delivery
Invoice included
View Cart

Secure payment via Stripe

Payments accepted

VisaMastercardAmerican ExpressApple PayGoogle PayStripe

GB/T 38963-2020

$300.00