Sling API Documentation
If you have any questions that are beyond the scope of this documentation, please feel free to email via [email protected].
Introduction
Sling API uses header authentication. Get your api token from your dashboard and fuse it to use the API. Kindly follow the documentation promptly.
Base URL
https://v2.sling.com.ng/api/v1
Headers:
Accept application/json
Authorization Bearer {API TOKEN}
Replace {API TOKEN} with the API Token in your dashboard
Send SMS
Send SMS URL
POST REQUEST
https://v2.sling.com.ng/api/v1/send-sms
Headers:
Accept application/json
Content-type application/x-www-form-urlencoded
Authorization Bearer {API TOKEN}
Replace {API TOKEN} with the API Token in your dashboard
URL REQUEST
https://v2.sling.com.ng/api/v1/send-sms?api_token=$api_token&to=$phone&message=$message
Accepted Parameters
| Parameter | Description | ||||
|---|---|---|---|---|---|
to |
Recipient Phone Number 11 Digit phone or with country code 234 without the + |
||||
message |
Message to be sent Max of 3 pages |
||||
On success 200 OK:
{
"status": "success",
"message_id": "2bajqzt5tw",
"sender": "Sling",
"message": "Hello, from Sling",
"recipient": "2349123772222",
"credit_used": 1
}
Error Samples 400 Bad Request:
Insufficient Credit
{
"status": "fail",
"credit_used": "0",
"details": "insufficient credit"
}
Incomplete Parameters
{
"status": "fail",
"credit_used": "0",
"details": "Incorrect Param"
}
Check SMS Status
Check SMS Status URL
GET REQUEST
https://v2.sling.com.ng/api/v1/status/{message_id}
Headers:
Accept application/json
Content-type application/x-www-form-urlencoded
Authorization Bearer {API TOKEN}
Replace {API TOKEN} with the API Token in your dashboard
Replace {message_id} with the Message ID of your message
On success 200 OK:
{
"status": "success",
"message_id": "0btn9fbaeg",
"credit_used": "1",
"sender": "13290",
"recipient": "2349123772222"
}
Error Samples 400 Bad Request:
Missing Message ID
{
"status": "fail",
"details": "Message ID is required"
}
Invalid Message ID
{
"status": "fail",
"details": "Invalid Message ID"
}
Available Credit
Available Credit URL
GET REQUEST
https://v2.sling.com.ng/api/v1/balance
Headers:
Accept application/json
Content-type application/x-www-form-urlencoded
Authorization Bearer {API TOKEN}
Replace {API TOKEN} with the API Token in your dashboard
URL REQUEST
https://v2.sling.com.ng/api/v1/balance?api_token=$api_token
On success 200 OK:
{
"status": "success",
"balance": "339"
}
Fequently Asked Questions
| How does your system work? | |
|
We use SenderID, Long Code and Shot Code to deliver Messsages |
|
| Can I send SMS using my phone number? | |
|
Yes you can. You will have to send us your SIM Card. Kindly contact us for more info |
|
| Can I get SMS at a cheaper rate? | |
|
We send SMS at a very low rate. But resellers and corporate entities will get a good discount! |
|
Thank you!
Once again, thank you so choosing Sling. We appreciate it very much. We wish you all the best with your upcoming projects! Feel free to drop us a message on [email protected] or via any of our social media accounts.
Have a great day and happy coding!