Use Case: Get subscription Information, activate the SIM and get activation status

This use case shows how to flip the status of a given subscription (from Active to Pause or vice versa) by checking its initial status, change it, and then verifying the final status. This is done by implementing a sample application flow in NodeRed® which combines three IoT Accelerator APIs. The sample flows are available and downloadable from the "Available resources" section of this page.

The flow orchestrates the three IoT Accelerator native API calls and assembles their result into a single body response.

 

API in scope
API exposed by the sample flow Activate SIM & Get Info
Method GET
IoTA APIs in scope
Endpoint http://localhost:1880/get_sim_info/activate_sim?customerNo=XXX&filterKey=imsi&subscriptionStatus=Activate
Headers
  • username
  • password
  • filterValue – value of the filterKey set in the parameters
Parameters
  • customerNo - a string value that denotes the customer number
  • filterKey: imsi|msisdn
  • subscriptionStatus = Activate|Pause
REQUEST
GET /get_sim_info/activate_sim?customerNo=06000270&filterKey=imsi&subscriptionStatus=Activate HTTP/1.1
Host: localhost:1880
X-Username: xxxxx
X-Password: xxxxx
filterValue: 238208700343991
RESPONSE
{
"2020-01-31Z": {
"serviceRequestId": "REQ200109151575",
"statusRequestResponse": "Completed"
},
"SIMStatus": "Active",
"SIMInfo": {
"customerLabel": [
"xxxxx"
],
"msisdn": [
"xxxxx"
],
"imsi": [
"xxxxx"
],
"icc": [
"xxxxx"
],
"pin1": [
"0000"
],
"pin2": [
"xxxxx"
],
"puk1": [
"xxxxx"
],
"puk2": [
"xxxxx"
],
"imei": [
"xxxxx"
],
"assignedImei": [
""
],
"customerNo": [
"xxxxx"
],
"accessControlClass": [
"0002"
],
"roamProfileName": [
"1438"
],
"deviceTerminalType": [
""
],
"simSubscriptionStatus": [
"Active"
],
"simCardDescription": [
"Plug85 TRIO SIM"
],
"simSpecification": [
"GEM_TSA008_TSG005_TRIO_EP0013"
],
"priceProfileName": [
"PP100017447"
],
"productOfferName": [
"7000562575-20170605_SP_02"
],
"pdpContextProfileName": [
"PDPCP (1614) for TeliaSonera"
],
"tenantId": [
"91"
],
"userProfileId": [
"TSM1614"
],
"firstActivationDate": [
"2018-02-08T18:57:27.450Z"
],
"gprs": [
"true"
],
"lte": [
"true"
],
"smsMo": [
"true"
],
"smsMt": [
"true"
],
"csd": [
"false"
],
"voice": [
"false"
],
"clip": [
"false"
],
"consumerConnectivity": [
"false"
],
"apns": [
{
"apn": [
{
"name": [
"lpwa.telia.iot"
],
"description": [
"Customized APN (1591), TeliaSonera"
]
}
]
}
],
"installationDate": [
"2018-04-19T12:01:30.160Z"
],
"lastSubscriptionDateChange": [
"2020-01-30T10:37:57.039Z"
],
"moveToPermitted": [
"true"
],
"freezeDuration": [
"0"
],
"chargeCodeForPPMove": [
"false"
],
"chargeCodeNonPPMove": [
"false"
],
"customerName": [
"DCP Trial One"
],
"subscriptionPackageDescription": [
"World VI. (Zone A1+A2+B+C+D+E+F+G+H)100 MB & 20 SMS"
],
"operatorId": [
"06000001"
]
}
}
AVAILABLE RESOURCES

NodeRed® Flows

The described flow is available for download, ready to be imported and used in your NodeRed® client. If you want to know more about how to import flows in NodeRed, visit the dedicated instructions available here.

Download