OpenAPI
OpenAPI Version: 3.0.0
The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
The Nsmsf_SMService service provides the service capability for the NF Service Consumer (for example, AMF) to authorize SMS and activate SMS for a service user on SMSF. The following are the key functionalities of this NF service:
Activation or deactivation of SMS service for a given service user, which results in creating/updating/deleting an UE Context for SMS in SMSF.
Send SMS payload in uplink direction to SMSF.
Reference: 3GPP TS 29.540 version 15.0.0 Release 15
OpenAPI Version: 3.0.0
Version: '1.0.0'
Title: 'Nsmsf_SMService Service API'
Description: 'SMSF SMService Service API'
Description: 3GPP TS 29.540 V15.2.0; 5G System; SMS Services; Stage 3
URL: 'http://www.3gpp.org/ftp/Specs/archive/29_series/29.540/'
URL: '{apiRoot}/nsmsf-sms/v1'
Variables:
API Root:
Default: https://example.com
Description: apiRoot as defined in subclause subclause 4.4 of 3GPP TS 29.501.
put:
Summary: Activate SMS Service for a given UE
Operation ID: SMServiceActivation
Tags:
- UEContext (Document)
Parameters:
- name: supi
In: path
Required/Optional: true
Description: Subscriber Permanent Identifier (SUPI)
Schema:
Type: string
Request Body:
Content:
Application/JSON:
Schema:
Reference: '#/components/schemas/UeSmsContextData'
Required/Optional: true
Responses:
'201' UE Context for SMS is created in SMSF
Content:
Application/JSON:
Schema:
Reference: '#/components/schemas/UeSmsContextData'
Headers:
Location:
Description: 'Contains the URI of the newly created resource, according to the structure: {apiRoot}/nsmsf-sms/v1/ue-contexts/{supi}'
Required/Optional: true
Schema:
Type: string
'204' UE Context for SMS is updated in SMSF
'400' Invalid Service Request
Content:
application/problem+json:
Schema:
Reference: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
'403' Unable to create/update UE Context for SMS in SMSF
Content:
application/problem+json:
Schema:
Reference: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
'404' Unable to found subscription for service user or UE Context for SMS in SMSF
Content:
application/problem+json:
Schema:
Reference: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
'503' Service Unavailable
Content:
application/problem+json:
Schema:
Reference: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
default:
Description: Unexpected error
Content:
application/problem+json:
Schema:
Reference: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
delete:
Summary: Deactivate SMS Service for a given UE
Operation ID: SMServiceDeactivation
Tags:
- UEContext (Document)
Parameters:
- name: supi
In: path
Required/Optional: true
Description: Subscriber Permanent Identifier (SUPI)
Schema:
Type: string
Responses:
'204' UE Context for SMS is deleted from SMSF
'400' Invalid Service Request
Content:
application/problem+json:
Schema:
Reference: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
'404' Unable to found UE Context for SMS in SMSF
Content:
application/problem+json:
Schema:
Reference: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
'503' Service Unavailable
Content:
application/problem+json:
Schema:
Reference: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
Method: Post
Summary: Send SMS payload for a given UE
Operation ID: SendSMS
Tags:
- UEContext (Document)
Parameters:
- name: supi
In: path
Required/Optional: true
Description: Subscriber Permanent Identifier (SUPI)
Schema:
Type: string
Request Body:
Content:
Application/JSON:
Schema:
Reference: '#/components/schemas/SmsRecordData'
Required/Optional: true
Responses:
'200' SMS payload is received by SMSF, and is being delivered out
Content:
Application/JSON:
Schema:
Reference: '#/components/schemas/SmsRecordDeliveryData'
'400' Invalid Service Request
Content:
application/problem+json:
Schema:
Reference: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
'403' Unable to deliver SMS at SMSF
Content:
application/problem+json:
Schema:
Reference: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
'404' Unable to found UE Context for SMS in SMSF
Content:
application/problem+json:
Schema:
Reference: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
'503' Service Unavailable
Content:
application/problem+json:
Schema:
Reference: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
Type: oauth2
Flows:
clientCredentials:
tokenUrl: '{nrfApiRoot}/oauth2/token'
scopes:
nsmsf-sms: Access to the nsmsf-sms API
Type: object
Required:
- supi
- amfId
- accessType
Properties:
supi:
Reference: 'TS29571_CommonData.yaml#/components/schemas/Supi'
pei:
Reference: 'TS29571_CommonData.yaml#/components/schemas/Pei'
amfId:
Reference: 'TS29571_CommonData.yaml#/components/schemas/NfInstanceId'
guamis:
Type: array
Items:
Reference: 'TS29571_CommonData.yaml#/components/schemas/Guami'
minItems: 1
accessType:
Reference: 'TS29571_CommonData.yaml#/components/schemas/AccessType'
gpsi:
Reference: 'TS29571_CommonData.yaml#/components/schemas/Gpsi'
ueLocation:
Reference: 'TS29571_CommonData.yaml#/components/schemas/UserLocation'
ueTimeZone:
Reference: 'TS29571_CommonData.yaml#/components/schemas/TimeZone'
traceData:
Reference: 'TS29571_CommonData.yaml#/components/schemas/TraceData'
backupAmfInfo:
Type: array
Items:
Reference: 'TS29571_CommonData.yaml#/components/schemas/BackupAmfInfo'
minItems: 1
udmGroupId:
Reference: 'TS29571_CommonData.yaml#/components/schemas/NfGroupId'
routingIndicator:
Type: string
Type: object
Required:
- smsRecordId
- smsPayloads
Properties:
smsRecordId:
Reference: '#/components/schemas/RecordId'
smsPayloads:
Type: array
Items:
Reference: 'TS29571_CommonData.yaml#/components/schemas/RefToBinaryData'
accessType:
Reference: 'TS29571_CommonData.yaml#/components/schemas/AccessType'
gpsi:
Reference: 'TS29571_CommonData.yaml#/components/schemas/Gpsi'
pei:
Reference: 'TS29571_CommonData.yaml#/components/schemas/Pei'
ueLocation:
Reference: 'TS29571_CommonData.yaml#/components/schemas/UserLocation'
ueTimeZone:
Reference: 'TS29571_CommonData.yaml#/components/schemas/TimeZone'
Type: string
Type: object
Required:
- smsRecordId
- deliveryStatus
Properties:
smsRecordId:
Reference: '#/components/schemas/RecordId'
deliveryStatus:
Reference: '#/components/schemas/SmsDeliveryStatus'
Type: string
enum:
- SMS_DELIVERY_PENDING
- SMS_DELIVERY_COMPLETED
- SMS_DELIVERY_FAILED