SMS API

.NET API Code

using System; 
using System.Net; 
using System.Web;


public class Program 
{ 
public static void Main() 
{ 
string MyUsername = "userxxx"; //Your Username 
string MyPassword = "92***"; //Your Password 
string toNumber = "923****"; //Recepient cell phone number with country code 
string Masking = "SMS Alert"; //Your Company Brand Name 
string MessageText = "SMS Sent using .Net"; 
string jsonResponse = SendSMS(Masking, toNumber, MessageText, MyUsername , MyPassword); 
Console.Write(jsonResponse); 
//Console.Read(); //to keep console window open if trying in visual studio 
} 
public static string SendSMS(string Masking, string toNumber, string MessageText, string MyUsername , string MyPassword) 
{ 
String URI = "sms.pksol.com" + 
"/web_distributor/api/sms.php?" + 
"username=" + MyUsername + 
"&password=" + MyPassword + 
"&sender=" + Masking + 
"&mobile=" + toNumber + 
"&message=" + Uri.UnescapeDataString(MessageText); // Visual Studio 10-15 
"//&message=" + System.Net.WebUtility.UrlEncode(MessageText);// Visual Studio 12 
try 
{ 
WebRequest req = WebRequest.Create(URI); 
WebResponse resp = req.GetResponse(); 
var sr = new System.IO.StreamReader(resp.GetResponseStream()); 
return sr.ReadToEnd().Trim(); 
} 
catch (WebException ex) 
{ 
var httpWebResponse = ex.Response as HttpWebResponse; 
if (httpWebResponse != null) 
{ 
switch (httpWebResponse.StatusCode) 
{ 
case HttpStatusCode.NotFound: 
return "404:URL not found :" + URI; 
break; 
case HttpStatusCode.BadRequest: 
return "400:Bad Request"; 
break; 
default: 
return httpWebResponse.StatusCode.ToString(); 
} 
} 
} 
return null; 
} 
}

API Parameters

Return Response and their Meanings

Dynamic SMS HTTP API

sms.pksol.com/web_distributor/api/personalized.php?username=&password=***&sender=BrandName&url=sms.pksol.com/dynamic_sample.csv&message=Dear Parents!Your Son %23B%23 Got %23C%23 Marks In %23D%23, Your Son Result Is %23E%23 Please Contact With School For More Details

<?php
$username = "";///Your Username
$password = "password";///Your Password
$sender = "SenderID";
$url = "sms.pksol.com/dynamic_sample.csv";
$message = "Dear Parents! Your Son #B# Got #C# Marks In #D#, Your Son Result Is #E# Please Contact With School For More Details.";

////sending sms

$post = "sender=".urlencode($sender)."&url=".$url."&message=".urlencode($message)."";
$url = "sms.pksol.com/web_distributor/api/personalized.php?username=&password=***";
$ch = curl_init();
$timeout = 30; // set to zero for no timeout
curl_setopt($ch, CURLOPT_USERAGENT, 'Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1)');
curl_setopt($ch, CURLOPT_URL,$url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,$post);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt ($ch, CURLOPT_CONNECTTIMEOUT, $timeout);
$result = curl_exec($ch); 
/*Print Responce*/
echo $result; 
?>

Parameter For Dynamic SMS API

Return Response and their Meanings

HTTP API For Delivery Reports

sms.pksol.com/web_distributor/api/delivery.php?username=&password=***&id=***

<?php

$username = "";///Your Username
$password = "password";///Your Password
$id = '***';////unique message id

////Getting Delivery Reports

$post = "id=".$id." ";
$url = "sms.pksol.com/web_distributor/api/delivery.php?username=".$username."&password=".$password.""; 
$ch = curl_init();
$timeout = 30; // set to zero for no timeout
curl_setopt($ch, CURLOPT_USERAGENT, 'Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1)');
curl_setopt($ch, CURLOPT_URL,$url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,$post);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt ($ch, CURLOPT_CONNECTTIMEOUT, $timeout);
$result = curl_exec($ch); 
/*Print Responce*/
echo $result; 
?>

API Parameters

Delivery Report Documentation

Examples

Each Message Returns A Unique Identifier in The Form Of Transaction ID.

URL To Get Single Message Delivery

http:/sms.futuresol.net/web_distributor/api/delivery.php?username=&password=***&id=a2371b64-4da5-44d5-9955-34c82682c8d0

JSON Success Response

{"success":"true","results":[{"id":"260","api_id":"a2371b64-4da5-44d5-9955-34c82682c8d0","delivery":"Sent","sender":"SMS Alert","mobile":"923101234567","length":"11","price":"1","operator":"Zong (Paktel)","country":"Pakistan","date":"15:41:06 PM 19-09-17"}]}

URL To Get Multiple Message Delivery

sms.pksol.com/web_distributor/api/delivery.php?username=&password=***&id=a2371b64-4da5-44d5-9955-34c82682c8d0,89936c10-79ba-4252-84d5-e0c555405713

JSON Success Response

{"success":"true","results":[{"id":"260","api_id":"a2371b64-4da5-44d5-9955-34c82682c8d0","delivery":"Sent","sender":"DD Labs","mobile":"923001234567","length":"11","price":"1","operator":"Zong (Paktel)","country":"Pakistan","date":"15:41:06 PM 19-09-17"},{"id":"256","api_id":"89936c10-79ba-4252-84d5-e0c555405713","delivery":"Sent","sender":"DD Labs","mobile":"923101234567","length":"4","price":"1","operator":"Zong (Paktel)","country":"Pakistan","date":"12:46:23 PM 19-09-17"}]}

JSON ERROR Response

{"success":"false","results":[{"status":"5","error":"Invalid Message ID"}]}

Error Codes Descriptions

ERROR Codes

Success Response Description

HTTP API For Balance

sms.pksol.com/web_distributor/api/balance_check.php?username=&password=***

<?php
$username = '';///Your Username
$password = 'password';///Your Password
$url = "sms.pksol.com/web_distributor/api/balance_check.php?username=".$username."&password=".$password.""; 
$ch  =  curl_init();
$timeout  =  30;
curl_setopt ($ch,CURLOPT_URL, $url) ;
curl_setopt ($ch,CURLOPT_RETURNTRANSFER, 1);
curl_setopt ($ch,CURLOPT_CONNECTTIMEOUT, $timeout) ;
$response = curl_exec($ch) ;
curl_close($ch) ; 
//Write out the response
echo $response ;
?>

API Parameters

Return Response and their Meanings