Content for TS 29.538 Word version: 19.2.0
5 Services offered by the MSGin5G Servers
6 Services offered by the Message Gateway
7 Common information applicable to several APIs
8 Message Server API definition
9 Message Gateway API definition
10 Security
11 Using Common API Framework
11.1 General
11.2 Security
12 Usage of Network Capabilities
A OpenAPI specification
$ Change history
5 Services offered by the MSGin5G Servers p. 13
5.1 Introduction p. 13
5.2 MSGS_ASRegistration Service p. 14
5.2.1 Service Description p. 14
5.2.2 Service Operations p. 14
5.3 MSGS_MSGDelivery Service p. 16
5.3.1 Service Description p. 16
5.3.2 Service Operations p. 16
5.4 MSGS_TopiclistEvent Service |R18| p. 21
5.4.1 Service Description p. 21
5.4.2 Service Operations p. 22
5.4.2.1 Introduction p. 22
5.4.2.2 MSGS_TopiclistEvent_SubscribeMSGTopiclist p. 22
5.4.2.3 MSGS_TopiclistEvent_UnsubscribeMSGTopiclist p. 23
5.4.2.3.1 General p. 23
5.4.2.3.2 MSGin5G Server Unsubscribing to MSGin5G Messaging Topic List p. 23
5.4.2.4 MSGS_TopiclistEvent_NotifyMSGTopiclist p. 23
5.4.2.5 MSGS_TopiclistEvent_SubscribeMSGTopic p. 24
5.4.2.6 MSGS_TopiclistEvent_UnsubscribeMSGTopic p. 25
6 Services offered by the Message Gateway p. 26
6.1 Introduction p. 26
6.2 MSGG_L3GDelivery Service p. 26
6.2.1 Service Description p. 26
6.2.2 Service Operations p. 26
6.3 MSGG_N3GDelivery Service p. 29
6.3.1 Service Description p. 29
6.3.2 Service Operations p. 29
6.4 MSGG_BGDelivery Service |R18| p. 31
7 Common information applicable to several APIs p. 33
7.1 General p. 33
7.2 Data Types p. 33
7.2.1 General p. 33
7.2.2 Referenced structured data types p. 33
7.2.3 Referenced Simple data types and enumerations p. 33
7.3 Usage of HTTP p. 34
7.4 Content type p. 34
7.5 URI structure p. 34
7.6 Notifications p. 34
7.7 Error Handling p. 34
7.8 Feature negotiation p. 34
7.9 HTTP headers p. 34
7.10 Conventions for Open API specification files p. 34
8 Message Server API definition p. 34
8.1 MSGS_ASRegistration API p. 34
8.1.1 API URI p. 34
8.1.2 Resources p. 35
8.1.2.1 Overview p. 35
8.1.2.2 Resource: AS Registrations p. 35
8.1.2.2.1 Description p. 35
8.1.2.2.2 Resource Definition p. 35
8.1.2.2.3 Resource Standard Methods p. 36
8.1.2.2.3.1 POST p. 36
8.1.2.3 Resource: AS DeRegistration p. 36
8.1.2.3.1 Description p. 36
8.1.2.3.2 Resource Definition p. 36
8.1.2.3.3 Resource Standard Methods p. 37
8.1.2.3.3.1 DELETE p. 37
8.1.3 Custom Operations without associated resources p. 38
8.1.4 Notifications p. 38
8.1.5 Data Model p. 38
8.1.5.1 General p. 38
8.1.5.2 Structured data types p. 39
8.1.5.2.1 Introduction p. 39
8.1.5.2.2 Type: ASRegistration p. 39
8.1.5.2.3 Type: ASRegistrationAck p. 39
8.1.5.2.4 Type: ASProfile p. 39
8.1.5.3 Simple data types and enumerations p. 39
8.1.6 Error Handling p. 39
8.1.6.1 General |R18| p. 39
8.1.6.2 Protocol Errors |R18| p. 39
8.1.6.3 Application Errors |R18| p. 40
8.1.7 Feature negotiation p. 40
8.2 MSGS_MSGDelivery API p. 40
8.2.1 API URI p. 40
8.2.2 Resources p. 40
8.2.3 Custom Operations without associated resources p. 40
8.2.3.1 Overview p. 40
8.2.3.2 Operation: deliver-as-message p. 41
8.2.3.2.1 Description p. 41
8.2.3.2.2 Operation Definition p. 41
8.2.3.3 Operation: deliver-ue-message p. 42
8.2.3.3.1 Description p. 42
8.2.3.3.2 Operation Definition p. 42
8.2.3.4 Operation: deliver-report p. 43
8.2.3.4.1 Description p. 43
8.2.3.4.2 Operation Definition p. 43
8.2.4 Notifications p. 44
8.2.5 Data Model p. 44
8.2.5.1 General p. 44
8.2.5.2 Structured data types p. 46
8.2.5.2.1 Introduction p. 46
8.2.5.2.2 Type: ASMessageDelivery p. 46
8.2.5.2.3 Type:UEMessageDelivery p. 47
8.2.5.2.4 Type: MessageDeliveryAck p. 47
8.2.5.2.5 Type:MessageSegmentParameters p. 48
8.2.5.2.6 Type:StoreAndForwardParameters p. 48
8.2.5.2.7 Type:DeliveryStatusReport p. 48
8.2.5.3 Simple data types and enumerations p. 48
8.2.6 Error Handling p. 49
8.2.6.1 General |R18| p. 49
8.2.6.2 Protocol Errors |R18| p. 49
8.2.6.3 Application Errors |R18| p. 49
8.2.7 Feature negotiation p. 49
8.3 MSGS_TopiclistEvent API |R18| p. 50
8.3.1 API URI p. 50
8.3.2 Resources p. 50
8.3.2.1 Overview p. 50
8.3.2.2 Resource: Topic List Subscriptions p. 50
8.3.2.2.1 Description p. 50
8.3.2.2.2 Resource Definition p. 50
8.3.2.2.3 Resource Standard Methods p. 51
8.3.2.2.3.1 POST p. 51
8.3.2.3 Resource: Individual Topic List Subscription p. 52
8.3.2.3.1 Description p. 52
8.3.2.3.2 Resource Definition p. 52
8.3.2.3.3 Resource Standard Methods p. 52
8.3.2.3.3.1 DELETE p. 52
8.3.3 Custom Operations without associated resources p. 53
8.3.3.1 Overview p. 53
8.3.3.2 Operation: request-topic-subscription p. 54
8.3.3.2.1 Description p. 54
8.3.3.2.2 Operation Definition p. 54
8.3.3.3 Operation: request-topic-unsubscription p. 55
8.3.3.3.1 Description p. 55
8.3.3.3.2 Operation Definition p. 55
8.3.4 Notifications p. 56
8.3.4.2 Topiclist Notification p. 56
8.3.4.2.1 Description p. 56
8.3.4.2.2 Target URI p. 56
8.3.4.2.3 Standard Methods p. 56
8.3.4.2.3.1 POST p. 56
8.3.5 Data Model p. 57
8.3.5.1 General p. 57
8.3.5.2 Structured data types p. 58
8.3.5.2.1 Introduction p. 58
8.3.5.2.2 Type: TopicListSubscription p. 58
8.3.5.2.3 Void
8.3.5.2.4 Void
8.3.5.2.5 Type: TopicListUnsubscriptionAck p. 59
8.3.5.2.6 Type: TopicSubscription p. 59
8.3.5.2.7 Type: TopicSubscriptionAck p. 59
8.3.5.2.8 Type: TopicUnsubscription p. 59
8.3.5.2.9 Type: TopicListNotification p. 59
8.3.5.2.10 Type: MessagingTopic p. 60
8.3.5.3 Simple data types and enumerations p. 60
8.3.6 Error Handling p. 60
8.3.7 Feature negotiation p. 60
9 Message Gateway API definition p. 61
9.1 MSGG_L3GDelivery API p. 61
9.1.1 API URI p. 61
9.1.2 Resources p. 61
9.1.3 Custom Operations without associated resources p. 61
9.1.3.1 Overview p. 61
9.1.3.2 Operation: deliver-message p. 62
9.1.3.2.1 Description p. 62
9.1.3.2.2 Operation Definition p. 62
9.1.3.3 Operation: deliver-report p. 62
9.1.3.3.1 Description p. 62
9.1.3.3.2 Operation Definition p. 63
9.1.4 Notifications p. 63
9.1.5 Data Model p. 63
9.1.5.1 General p. 63
9.1.5.2 Structured data types p. 65
9.1.5.3 Simple data types and enumerations p. 66
9.1.6 Error Handling p. 66
9.1.6.1 General |R18| p. 66
9.1.6.2 Protocol Errors |R18| p. 66
9.1.6.3 Application Errors |R18| p. 66
9.1.7 Feature negotiation p. 66
9.2 MSGG_N3GDelivery API p. 66
9.2.1 API URI p. 66
9.2.2 Resources p. 67
9.2.3 Custom Operations without associated resources p. 67
9.2.3.1 Overview p. 67
9.2.3.2 Operation: deliver-message p. 67
9.2.3.2.1 Description p. 67
9.2.3.2.2 Operation Definition p. 67
9.2.3.3 Operation: deliver-report p. 68
9.2.3.3.1 Description p. 68
9.2.3.3.2 Operation Definition p. 68
9.2.4 Notifications p. 69
9.2.5 Data Model p. 69
9.2.5.1 General p. 69
9.2.5.2 Structured data types p. 70
9.2.6 Error Handling p. 71
9.2.6.1 General |R18| p. 71
9.2.6.2 Protocol Errors |R18| p. 71
9.2.6.3 Application Errors |R18| p. 71
9.2.7 Feature negotiation p. 71
9.3 MSGG_BGDelivery API |R18| p. 71
9.3.1 API URI p. 71
9.3.2 Resources p. 71
9.3.3 Custom Operations without associated resources p. 71
9.3.3.1 Overview p. 71
9.3.3.2 Operation: deliver-message p. 72
9.3.3.2.1 Description p. 72
9.3.3.2.2 Operation Definition p. 72
9.3.4 Notifications p. 73
9.3.5 Data Model p. 73
9.3.5.1 General p. 73
9.3.5.2 Structured data types p. 74
9.3.5.3 Simple data types and enumerations p. 74
9.3.6 Error Handling p. 75
9.3.7 Feature negotiation p. 75
10 Security p. 75
11 Using Common API Framework p. 75
11.1 General p. 75
11.2 Security p. 76
12 Usage of Network Capabilities p. 76
A (Normative) OpenAPI specification p. 78
A.1 General p. 78
A.2 MSGS_ASRegistration API p. 78
A.3 MSGS_MSGDelivery API p. 80
A.4 MSGG_L3GDelivery API p. 85
A.5 MSGG_N3GDelivery API p. 88
$ Change history p. 97
