Summary of Ginota SMS APIs
Here is a summarized list of Ginota SMS API available for easy integration anytime, anywhere.
To Send A Single SMS
| Sample Request |
|---|
https://www.ginota.com/gemp/sms/json?apiKey=GinotaAPIKey&apiSecret=GinotaAPISecret&srcAddr=Ginota&dstAddr=60123456789&content=Hello+Ginota |
| API URL | Parameter(s) |
|---|
| https://www.ginota.com/gemp/sms/json? |
apiKey *HTTP URL friendly. Do not require further encoding
|
|
apiSecret *required to be URL encoded
|
|
srcAddr
|
|
dstAddr
|
|
content *required to be UTF-8 and URL encoded
|
|
type
|
|
udh
|
|
url
|
|
flash
|
|
dlr
|
|
txnRef
|
|
ttl
|
|
at
|
|
channel
|
To Send Bulk SMS
| Sample Request |
|---|
https://www.ginota.com/gemp/bulk/sms/json?apiKey=GinotaAPIKey&apiSecret=GinotaAPISecret&srcAddr=Ginota&dstAddrs=60123456789%2C60173871877%2C60173871878&content=Hello+Ginota |
| API URL | Parameter(s) |
|---|
| https://www.ginota.com/gemp/bulk/sms/json? |
apiKey *HTTP URL friendly. Do not require further encoding
|
|
apiSecret *required to be URL encoded
|
|
srcAddr
|
dstAddrs *required to be UTF-8 and URL encoded
For multiple MSISDNs, each destination numbers must be separated with commas (,)
|
|
content *required to be UTF-8 and URL encoded
|
|
type
|
|
udh
|
|
url
|
|
flash
|
|
dlr
|
|
txnRef
|
|
ttl
|
|
at
|
|
channel
|
To check Ginota account credit balance
| Sample Request |
|---|
https://www.ginota.com/gemp/balance?apiKey=GinotaAPIKey&apiSecret=GinotaAPISecret |
| API URL | Parameter(s) |
|---|
| https://www.ginota.com/gemp/balance? |
apiKey *HTTP URL friendly. Do not require further encoding
|
|
apiSecret *required to be URL encoded
|
To check Discover Mobile Status
| Sample Request |
|---|
https://www.ginota.com/gemp/otp/discoverMobileStatus?apiKey=GinotaAPIKey&apiSecret=GinotaAPISecret&userId=support@ginota.com |
| API URL | Parameter(s) |
|---|
| https://www.ginota.com/gemp/otp/discoverMobileStatus? |
apiKey *HTTP URL friendly. Do not require further encoding
|
|
apiSecret *required to be URL encoded
|
|
userId *email address of the subscriber
|
To check Discover Mobile Number
| Sample Request |
|---|
https://www.ginota.com/gemp/otp/discoverMobile?apiKey=GinotaAPIKey&apiSecret=GinotaAPISecret&email=support@ginota.com&sName=Support |
| API URL | Parameter(s) |
|---|
| https://www.ginota.com/gemp/otp/discoverMobile? |
apiKey *HTTP URL friendly. Do not require further encoding
|
|
apiSecret *required to be URL encoded
|
|
email *email address of the subscriber
|
|
sName
|
To send OTP
| Sample Request |
|---|
https://www.ginota.com/gemp/otp/sendOTP?apiKey=GinotaAPIKey&apiSecret=GinotaAPISecret&userId=60122772266 |
| API URL | Parameter(s) |
|---|
| https://www.ginota.com/gemp/otp/sendOTP? |
apiKey *HTTP URL friendly. Do not require further encoding
|
|
apiSecret *required to be URL encoded
|
|
userId *MSISDN of the subscriber
|
|
pinValidity *value in seconds. Default is 300secs (5 mins). No max limit
|
To verify OTP
| Sample Request |
|---|
https://www.ginota.com/gemp/otp/verifyOTP?apiKey=GinotaAPIKey&apiSecret=GinotaAPISecret&requestId=R89Hjkk8999&otp=88990 |
| API URL | Parameter(s) |
|---|
| https://www.ginota.com/gemp/otp/verifyOTP? |
apiKey *HTTP URL friendly. Do not require further encoding
|
|
apiSecret *required to be URL encoded
|
|
requestId *HTTP response request ID from sendOTP API
|
|
otp *value input by customer
|