GB/T 38322-2019 PDF English
Search result: GB/T 38322-2019_English: PDF (GB/T38322-2019)
Standard ID | Contents [version] | USD | STEP2 | [PDF] delivered in | Name of Chinese Standard | Status |
GB/T 38322-2019 | English | 190 |
Add to Cart
|
0-9 seconds. Auto-delivery.
|
Information technology -- Information device interconnection -- Interface requirements between third-party smart home electric system and general terminal access service platform
| Valid |
BUY with any currencies (Euro, JPY, GBP, KRW etc.): GB/T 38322-2019 Related standards: GB/T 38322-2019
PDF Preview: GB/T 38322-2019
GB/T 38322-2019: PDF in English (GBT 38322-2019) GB/T 38322-2019
NATIONAL STANDARD OF THE
PEOPLE’S REPUBLIC OF CHINA
ICS 35.110
L 79
Information technology - Information device
interconnection - Interface requirements between
third-party smart home electric system and general
terminal access service platform
ISSUED ON: DECEMBER 10, 2019
IMPLEMENTED ON: JULY 01, 2020
Issued by: State Administration for Market Regulation;
Standardization Administration of the People's Republic of
China.
Table of Contents
Foreword ... 3
1 Scope ... 4
2 Normative references ... 4
3 Terms and definitions ... 4
4 Acronyms ... 4
5 General data formats ... 5
6 Message parameter definitions ... 6
Information technology - Information device
interconnection - Interface requirements between
third-party smart home electric system and general
terminal access service platform
1 Scope
This Standard specifies general data formats as well as message parameter
definitions BETWEEN third-party smart home electric system and terminal AND
service platform.
This Standard is applicable to the design, development and deployment of
application client and service platform of smart home electric system.
2 Normative references
The following referenced documents are indispensable for the application of
this document. For dated references, only the edition cited applies. For undated
references, the latest edition of the referenced document (including any
amendments) applies.
GB/T 37723-2019, Information technology - Information device
interconnection - General technical requirement for smart home electric
system terminal access service platform
3 Terms and definitions
For the purposes of this document, the terms and definitions defined in GB/T
37723-2019 apply.
4 Acronyms
The following acronyms apply to this document.
UTC (Coordinated Universal Time)
UUID (Universally Unique Identifier)
extension Additional information of device status update
account User account identification of the service platform
token The token obtained after logging into the service platform
duration
Inquire the time range of the data, UTC
(s) time. If it is empty, it means to inquire
the latest recorded data
ID dataID Data identification
5.2 General data formats of request interface of service platform
See Table 2 for the general data formats of request interface of service platform.
Table 2 -- General data formats of request interface of service platform
Element Field name Description
Interface name name Fill in separately according to the interface used
Interface type thirdPartyInterface
The service interface that is provided by the
service platform to the third-party smart
home electric system
Request content
intent Operation description
devices deviceID Device identification subscriptionID Subscription identification
6 Message parameter definitions
6.1 Request interface of third-party smart home electric system
6.1.1 Registration information of inquire terminal device of third-party
smart home electric system
6.1.1.1 Function description
The extension function is used for the third-party smart home electric system to
request the service platform to view the bound device registration information.
6.1.1.2 Message parameter definitions
See Table 3 for the message parameter definitions of registration information of
the terminal device that is viewed by the third-party smart home electric system.
Type thirdPartyInterface Yes
The service interface that is
provided by the service platform
to the third-party smart home
electric system
Request
content
system
version Yes Protocol version information
sign Yes Signature value
key Yes
Request source, the identification
value of the key of the third-party
smart home electric system
timestamp Yes Timestamp
request
url Yes
Request source, the domain
name of the third-party smart
home electric system
account Yes Service platform account used by the request source
token Yes Session token obtained after logging in to the service platform
host Yes Request operation source
parameters
deviceID Yes Device identification
attribute
value Yes Set status value
updateTi
me No
Update time of device status
value
extension No Additional information of device status update
notifyUserActionDataID Yes Data identification
6.1.3 Third-party smart home electric system verifying user identity of
service platform
6.1.3.1 Function description
The extension function is used for the third-party smart home electric system to
verify the user identity of the service platform.
6.1.3.2 Message parameter definitions
See Table 5 for the message parameter definitions of the third-party smart home
electric system to verify the user identity of the service platform.
Table 5 -- Message parameter definitions of the third-party smart home
electric system to verify the user identity of the service platform
Element Field name Required Description
Name authenticateAlinkUser Yes Verify the user identity of the service platform
of the third-party smart home
electric system
time Yes Timestamp
request url Yes
Request source, the domain
name of the third-party smart
home electric system
parameters
priv-
account
account Yes
User account identification of
the third-party smart home
electric system
token No
User login token of the third-
party smart home electric
system
alink-
account
account Yes User account identification of the service platform
token No User login token of the service platform
bindUserAccountDataID Yes Data identification
6.1.5 User data reporting of third-party smart home electric system
6.1.5.1 Function description
The extension function is used for the third-party smart home electric system to
request to report the user data to the service platform.
6.1.5.2 Message parameter definitions
See Table 7 for the message parameter definitions of third-party smart home
electric system to report user data.
Table 7 -- Message parameter definitions of third-party smart home
electric system to report user data
Element Field name Required Description
Name postUserDataArray Yes
The third-party smart home
electric system reports user
data
Type thirdPartyInterface Yes
The service interface that is
provided by the service
platform to the third-party
smart home electric system
Request
content system
version Yes Protocol version
sign Yes Signature value
key Yes
Request source, the
identification value of the key
of the third-party smart home
electric system
...... Source: Above contents are excerpted from the PDF -- translated/reviewed by: www.chinesestandard.net / Wayne Zheng et al.
|