FOR API DEVELOPERS
You can integrate SMS into your website or application using our HTTP API
Our API is effective and yet simple to use.
With a few parameters, you can start using sms in your application
[IMPORTANT NOTE] It is compulsory that you send a standard international format to us via this gateway. e.g 2348029037890 or +2348029037890
| HTTP POST and GET API parameters |
| Parameter |
Interpretation |
| SMS Balance check |
| username |
(Required) The email address to your MagicBULK account e.g pat@example.com |
| password |
(Required) The password to your MagicBULK account |
| |
|
| Send SMS |
| username |
(Required) The email address to your MagicBULK account e.g pat@example.com |
| password |
(Required) The password to your MagicBULK account |
| destination |
(Required) Recipients separated by commas, You can send SMS to 1 user or many users at the same time. There is no limit on the number of recipients when sending via POST method. |
| message |
(Required) The message to be sent |
| source |
(Required) The sender id or phone number that sent an sms. This should not exceed 11 characters, if it does, it will be truncated |
| type |
(Optional) This parameter detemines whether the message displays directly on the phoe screen of the recipient or in box |
| |
|
| API link |
| http://api.magicbulk.com/ |
Whenever you make a request, the status of the sent message will be returned per each request.
Please contact us if you will like us to forward message send status to your webpage as they become available.
Sample HTTP GET code
http://api.magicbulk.com/?username=pat@example.com&password=myPassword
http://api.magicbulk.com/?username=pat@example.com&password=myPassword&destination=08029037890,08034611116&message=Hello there, how are you doing&source=MagicBULK
Usage Sample
<?php
//build the url
$url=
"http://api.magicbulk.com/?username=pat@example.com&password=myPassword&destination=08029037890,08034611116&message=Hello there, how are you doing&source=magicbulk";
//make the request via any method, here we are using PHP's file_get_contents()
, you can also use cURL etc
//it is advisable to use cURL when sending messages to more than 20 users using the POST method.
$status=file_get_contents($url);
//$status should contain the status of the sent SMS.
?>
