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.
OpenAPI Version: 3.0.0
Version: '1.0.0'
Title: 'Nsmsf_SMService Service API'
Description: 'SMSF SMService Service API'
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.
- oAuth2ClientCredentials:
- nsmsf-sms
- {}
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':
Description: 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':
Description: UE Context for SMS is updated in SMSF
'400':
Description: Invalid Service Request
Content:
application/problem+json:
Schema:
Reference: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
'403':
Description: Unable to create/update UE Context for SMS in SMSF
Content:
application/problem+json:
Schema:
Reference: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
'404':
Description: 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':
Description: 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':
Description: UE Context for SMS is deleted from SMSF
'400':
Description: Invalid Service Request
Content:
application/problem+json:
Schema:
Reference: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
'404':
Description: Unable to found UE Context for SMS in SMSF
Content:
application/problem+json:
Schema:
Reference: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
'503':
Description: 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':
Description: SMS payload is received by SMSF, and is being delivered out
Content:
Application/JSON:
Schema:
Reference: '#/components/schemas/SmsRecordDeliveryData'
'400':
Description: Invalid Service Request
Content:
application/problem+json:
Schema:
Reference: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
'403':
Description: Unable to deliver SMS at SMSF
Content:
application/problem+json:
Schema:
Reference: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
'404':
Description: Unable to found UE Context for SMS in SMSF
Content:
application/problem+json:
Schema:
Reference: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
'503':
Description: Service Unavailable
Content:
application/problem+json:
Schema:
Reference: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
securitySchemes:
oAuth2ClientCredentials:
Type: oauth2
Flows:
clientCredentials:
tokenUrl: '{nrfApiRoot}/oauth2/token'
scopes:
nsmsf-sms: Access to the nsmsf-sms API
schemas:
UeSmsContextData:
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
SmsRecordData:
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'
RecordId:
Type: string
SmsRecordDeliveryData:
Type: object
Required:
- smsRecordId
- deliveryStatus
Properties:
smsRecordId:
Reference: '#/components/schemas/RecordId'
deliveryStatus:
Reference: '#/components/schemas/SmsDeliveryStatus'
SmsDeliveryStatus:
Type: string
enum:
- SMS_DELIVERY_PENDING
- SMS_DELIVERY_COMPLETED
- SMS_DELIVERY_FAILED
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/'