Tech-invite 3GPPspace IETFspace

21 22 23 24 25 26 27 28 29 31 32 33 34 35 36 37 38 4‑5x

Content for TS 29.540 Word version: 18.4.0

1… 5…

5.1 Introduction 5.2 Nsmsf_SMService Service 6.1 Nsmsf_SMService Service API

5 Services offered by the SMSF p. 8

5.1 Introduction p. 8

5.2 Nsmsf_SMService Service p. 8

5.2.1 Service Description p. 8

5.2.2 Service Operations p. 9

5.2.2.1 Introduction p. 9

5.2.2.2 Activate p. 9

5.2.2.2.1 General p. 9

5.2.2.2.2 Registration procedure using Activate service operation p. 9

5.2.2.2.3 Modify UE Context in SMSF using HTTP PATCH Method |R17| p. 10

5.2.2.3 Deactivate p. 11

5.2.2.3.1 General p. 11

5.2.2.3.2 De-Registration procedure to remove SMS service authorization from SMSF p. 12

5.2.2.3.3 De-Registration procedure to remove SMS service authorization from SMSF for one of the registered Access Type p. 12

5.2.2.4 UplinkSMS p. 13

5.2.2.4.1 General p. 13

5.2.2.4.2 Procedures of sending SMS payload in uplink direction using UplinkSMS service operation p. 13

5.2.2.5 MtForwardSm |R17| p. 14

5.2.2.5.1 General p. 14

5.2.2.5.2 Procedures of sending SMS payload in downlink direction using MtForwardSm service operation p. 14

6 API Definitions p. 15

6.1 Nsmsf_SMService Service API p. 15

6.1.1 API URI p. 15

6.1.2 Usage of HTTP p. 15

6.1.2.1 General p. 15

6.1.2.2 HTTP standard headers p. 15

6.1.2.2.1 General p. 15

6.1.2.2.2 Content type p. 15

6.1.2.2.3 ETag p. 16

6.1.2.2.4 If-Match p. 16

6.1.2.3 HTTP custom headers p. 16

6.1.2.3.1 General p. 16

6.1.2.4 HTTP multipart messages p. 16

6.1.3 Resources p. 16

6.1.3.1 Overview p. 16

6.1.3.2 Resource: UEContexts (Store) p. 18

6.1.3.2.1 Description p. 18

6.1.3.2.2 Resource Definition p. 18

6.1.3.2.3 Resource Standard Methods p. 19

6.1.3.3 Resource: UEContext (Document) p. 19

6.1.3.3.1 Description p. 19

6.1.3.3.2 Resource Definition p. 19

6.1.3.3.3 Resource Standard Methods p. 19

6.1.3.3.4 Resource Custom Operations p. 24

6.1.3.3.4.1 Overview p. 24

6.1.3.3.4.2 Operation: sendsms p. 24

6.1.3.3.4.2.1 Description p. 24

6.1.3.3.4.2.2 Operation Definition p. 24

6.1.3.3.4.3 Operation: send-mt-sms p. 25

6.1.3.3.4.3.1 Description p. 25

6.1.3.3.4.3.2 Operation Definition p. 25

6.1.4 Custom Operations without associated resources p. 26

6.1.5 Notifications p. 26

6.1.6 Data Model p. 27

6.1.6.1 General p. 27

6.1.6.2 Structured data types p. 27

6.1.6.2.1 Introduction p. 27

6.1.6.2.2 Type: UeSmsContextData p. 28

6.1.6.2.3 Type: SmsRecordData p. 29

6.1.6.2.4 Void

6.1.6.2.5 Type: SmsRecordDeliveryData p. 29

6.1.6.3 Simple data types and enumerations p. 29

6.1.6.3.1 Introduction p. 29

6.1.6.3.2 Simple data types p. 29

6.1.6.3.3 Enumeration: SmsDeliveryStatus p. 29

6.1.6.4 Binary data p. 30

6.1.6.4.1 Introduction p. 30

6.1.6.4.2 SMS Payload Information p. 30

6.1.7 Error Handling p. 30

6.1.7.1 General p. 30

6.1.7.2 Protocol Errors p. 30

6.1.7.3 Application Errors p. 30

6.1.8 Feature negotiation p. 30

6.1.9 Security p. 31

6.1.10 HTTP redirection |R16| p. 31

A (Normative) OpenAPI specification p. 32

A.1 General p. 32

A.2 Nsmsf_SMService API p. 32

B HTTP Multipart Messages p. 40

B.1 Example of HTTP multipart message p. 40

B.2 Void

B.3 Example HTTP multipart message with SMS binary data p. 40

$ Change history p. 42