SMS GATEWAY API INTEGRATION GUIDE

Size: px

Start display at page:

Download "SMS GATEWAY API INTEGRATION GUIDE"

Berniece Casey
5 years ago
Views:

1 SMS GATEWAY API INTEGRATION GUIDE For PHP Developers Are you a developer or bulk SMS reseller? You can interface your application, website or system with our 247 reliable messaging gateway by using our very flexible HTTP API connection. Nigerian Bulk SMS

2 SMS Gateway API Are you a developer or bulk SMS reseller? You can interface your application, website or system with our 247 reliable messaging gateway by using our very flexible HTTP API connection. Once you are connected, you will be able to deliver SMS messages and check your balance. Text Message -- welcome&mobiles= , Example Responses: Success Response: {"status":"ok","count":1,"price":2} Failed Response: {"error":"login denied.","errno":"103"} Other optional Parameter 1. contacts = The list of contact ids to send the message 2. groups = The list of group ids to send the message 3. numbers = The list of number ids to send the message 4. type = The type (text, call, tts ) of the message 5. message = message text or audio reference number Page 2

3 Error Codes: 000 = Request successful 100 = Incomplete request parameters 101 = Request denied 110 = Login status failed 111 = Login status denied 120 = Message limit reached 121 = Mobile limit reached 122 = Sender limit reached 130 = Sender prohibited 131 = Message prohibited 140 = Invalid price setup 141 = Invalid route setup 142 = Invalid schedule date 150 = Insufficient funds 151 = Gateway denied access 152 = Service denied access 160 = File upload error 161 = File upload limit 162 = File restricted 190 = Maintenance in progress 191 = Internal error Page 3

4 HTML Sample Code: <html> <head><meta http-equiv="content-type" content="text/html; charset=windows-1252"> <title>php SMS API Test</title></head> <body> <p><align="center">php SMS GATEWAY API</H2></p> <form method="post" action="sent.php"> <a href=" then type your "Username" and "Password" in the space below.<br><br> Username:< input type="text" name="username" value="enter your Username"> Password:<input type="password" name="password" value="password"> SenderID:<input type="text" name="senderid" value="your SenderID"> <br>send To Number(s):</td> For more than a phone number separate with blank space<br> <input type="text" name="recipient" value="080x xxx xxxx" size="55"> Message:<br> <textarea rows="5" name="message" cols="52"></textarea> input type="submit" value="send" name="sent_button"> </form></body> </html> Page 4

5 Register on then type your "Username" and "Password" in the space below. Username: Enter your Password: ******** SenderID: Your Send Send To Number(s): For more than a phone number separate with blank space. 080x xxx xxxx Message: Send NOTE: Username and Password field as shown in the above interface should be deleted or set on hidden in your application with your username and password on default value of the field Page 5

6 For PHP Developers: <?php if (isset($_post['sent_button'])) { $a=urlencode($_post['username']); //Note: urlencode must be added for username and $b=urlencode($_post['password']); // password as encryption code for security purpose. $c=$_post['message']; $d=$_post['senderid']; $e=$_post['recipient']; $url = " ".$c."&sender=".$d."&mobiles=".$e; $ch = curl_init(); curl_setopt($ch,curlopt_url, $url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); curl_setopt($ch, CURLOPT_HEADER, 0); $resp = curl_exec($ch); echo $resp; // Add double slash or delete echo echo "<br>thank you for using Nigerian Bulk SMS API"; // Your notification message here curl_close($ch); }?> Recap on the common editing point: 1. Username and Password field as shown in the above interface should be deleted or set on hidden in your application with your username and password on default value of the field 2. urlencode must be added for username and password as encryption code for security purpose (i.e. To make username and password invisible on the browser). 3. echo $resp; should be make inactive or comment by adding double slash to prevent it showing Success Response: {"status":"ok","count":1,"price":2} 4. Then echo "<br>thank you for using Nigerian Bulk SMS API"; should be replace with your own Notification or Congratulatory message. Page 6

7 NIGERIAN BULK SMS Website: Mobile: , , Page 7

Connect Media Bulk SMS API Documentation

Connect Media Bulk SMS API Documentation All requests are submitted through the POST Method Base URL: http://www.connectmedia.co.ke/user-board/?api Information About Parameters: PARAMETERS username Your