1. INTRODUCTION

 

SMS Service API sends SMS messages to one mobile number in a single request. Mobile numbers of any carrier can be selected. API contains the method to send SMS messages to selected mobile users. Mobile number of the receiver should be entered separately.

 

1.1 SYSTEM ACCESS CREDENTIALS 

 

 

Following URL should be used to access the SMS operation.

 

URL of SMS Operation

 

“SEND SMS” operation sends the SMS message to a mobile number. 

 

1.1.1 SMS REQUEST

 

Token access URL

POST /mobitel-dev/uat-check/OneSMS/sendsms HTTP/1.1

 

Headers

accept: application/json

Content-Type : application/x-www-form-urlencoded

x-ibm-client-id: YOUR_CLIENT _ID

 

Form parameters

Parameter Sample Value

sendsms-req {"msg":"testMessage","receiver":"071xxxxxxx","sender":"mobitelAPI"}

 

 

 

 

 

Parameter Description

 

The request body is a JSON object

“msg”: the text needs to send 

“receiver”: the Mobitel number of the receiver

“sender”: Senders name or the ID, which will be displayed to the client  

1.1.2 SMS RESPONSE

 

 

 

Sample Response

 

{"status": "1000","reference": "2016091416573500161"}

 

 

 

“status” => status of the message

“reference” = >  reference number of the transaction

 

 

 

1.1.3 RESPONSE STAUS

 

1000 Succeeded with a reference number according to the transaction  

1001 Not enough balance

1002 Invalid connection type

1003 Operation nit supported

1004 Invalid account

1005 Operation failed