The present document specified the Application Programming Interface (API) for enabling the MSGin5G Service over MSGin5G-2/3/4 interfaces. The application layer architecture, functional requirements, procedures and information flows necessary for MSGin5G Service are contained in TS 23.554
. The requirements for MSGin5G are specified in TS 22.262
The following documents contain provisions which, through reference in this text, constitute provisions of the present document.
References are either specific (identified by date of publication, edition number, version number, etc.) or non-specific.
For a specific reference, subsequent revisions do not apply.
For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same Release as the present document.
: "Vocabulary for 3GPP Specifications".
: "Application architecture for MSGin5G Service".
: "Message Service within the 5G System".
: "5G System; Technical Realization of Service Based Architecture; Stage 3".
: "5G System; Common Data Types for Service Based Interfaces Stage 3".
: "Functional architecture and information flows to support Common API Framework for 3GPP Northbound APIs; Stage 2".
: "Common API Framework for 3GPP Northbound APIs; Stage 3".
: "5G System; Principles and Guidelines for Services Definition; Stage 3".
"Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing".
"Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content".
"Hypertext Transfer Protocol (HTTP/1.1): Conditional Requests".
"Hypertext Transfer Protocol (HTTP/1.1): Range Requests".
"Hypertext Transfer Protocol (HTTP/1.1): Caching".
"Hypertext Transfer Protocol (HTTP/1.1): Authentication".
"Hypertext Transfer Protocol Version 2 (HTTP/2)".
: "Technical Specification Group working methods".
: "Study on security aspects of the Message Service for MIoT over the 5G System (MSGin5G)".
: "Security architecture and procedures for 5G system".
"The OAuth 2.0 Authorization Framework".
: "Security Aspects of Common API Framework for 3GPP Northbound APIs".
: "5G System; Network Exposure Function Northbound APIs; Stage 3".
: "T8 reference point for northbound APIs".
For the purposes of the present document, the terms given in TR 21.905
and the following apply. A term defined in the present document takes precedence over the definition of the same term, if any, in TR 21.905
For the purposes of the present document, the following terms and its definitions given in TS 23.554
Legacy 3GPP Message Gateway
Non-3GPP Message Gateway
Legacy 3GPP UE
For the purposes of the present document, the following symbols apply:
For the purposes of the present document, the abbreviations given in TR 21.905
and the following apply. An abbreviation defined in the present document takes precedence over the definition of the same abbreviation, if any, in TR 21.905
Common API Framework
The MSGin5G Service is designed and optimized for massive IoT device communication including thing-to-thing communication and person-to-thing communication and provides messaging capability in 5GS with messaging communication models including Point-to-Point, Application-to-Point/Point-to-Application, Group and Broadcast messaging.
3GPP TS 23.554
has specified the application layer architecture, architectural requirements, procedures, information flows and some APIs, in order to support the MSGin5G Service. Various features are defined to ensure the efficient use and deployment of MSGin5G Service, including configuration, registration, message delivery, message aggregation, segmentation and reassembly.
The present document specifies MSGin5G Services offered by MSGin5G Servers and MSGin5G Gateway, and APIs in detail, needed over MSGin5G-2/3/4 interfaces for interworking between MSGin5G Server and Legacy 3GPP UE, Non-3GPP UE or Application Server, with following functionalities need to be supported:
Server-side functionality with the sending and receiving of messages to/from Application Servers and/or other MSGin5G Service endpoints on other UEs, provided by MSGin5G Server.
Interconnecting two different messaging delivery mechanisms and assure the message integrity between different message delivery mechanisms, provided by Message Gateway.
And the definition of APIs specified in TS 23.554, clause 9
is introduced in present document.