Prerequisite

To start sending SMS using given APIs, you need:

1. API_KEY :-- This is your account authentication id and is unique for every user account. It is generated after signup. You can get the API_KEY from dashboard menu link "Get API key" once you are logged in to alcodes. You can also change the ApiKey as and when required using the "Re-Generate Api Key" Option

2. SENDER_ID :-- Sender ID is your identity from which the message is sent. For example, when you receive a general SMS from your friend, their name is displayed. Similarly, in case of Sender ID, the ID that you choose on the panel, or the one that is given to you, serves as your identity while sending messages.

Sender ID for Promotional SMS is numeric and fixed from the operator.But for sending Transactional and OTP Sms, You need to Apply for a valid Sender Id from the dashboard Menu 'Sender Ids'.

Sender ID is 6 character, alphabetic in India,example NOTIFY, MSGIND. You also need to upload a valid document explaining the use of the sender Id, For example If you are applying sender Id for use in a school, you can upload the school registration or identity document, Or if you are using it in your application for sending transaction notifications or OTP to users, you can upload your company registration or service document. This is just to ensure that your sender Id is not a copy of some other product or service and will be used solely by you for the mentioned purpose.

The default sender Id for all users is AUTHMS, which can be used for OTP verification SMS.

CURL

 
curl -X POST \
  https://www.alcodes.com/api/sms-compose \
  -H 'authorization: Enter basic authorization here' \
  -H 'cache-control: no-cache' \
  -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
  -H 'postman-token: 6d0a2902-c284-3b44-5b30-8749debaa086' \
  -F countryCode=IN \
  -F smsSenderId=AUTHMS \
  -F is_otp=true \
  -F message=test-sms \
  -F phoneNumbers=8949537689
  
		

PHP

<?php

PostSmsAlcodes([mobileno],'test sms');  // write 10 digit mobile number (without country code), separate multiple mobile numbers with comma.

function PostSmsAlcodes($phone,$message)
{
    $username='[API_KEY]'; // write your api key here
    $passwd='passwd'; // keep this as constant to passwd

    ## CALL ALCODES API usinf POST

    $data = array(
    'countryCode' => 'IN',
    'smsSenderId' => '[SENDERID]',  // write your sender Id here
    'is_otp' => 'false',       // set to true for otp messages
    'message' => $message,
    'phoneNumbers' => $phone  
    );

    $auth_token = base64_encode($username . '-' . $passwd);

    $location="https://www.alcodes.com/api/sms-compose";

    $ch = curl_init();
    curl_setopt($ch,CURLOPT_URL,$location);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_USERPWD, $username . ':' . $passwd);

    $headers = array('Authorization=Basic ' . $auth_token);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
    curl_setopt($ch,CURLOPT_RETURNTRANSFER,1);
    curl_setopt($ch, CURLOPT_TIMEOUT, 10); //times out after 10s
    curl_setopt($ch,CURLOPT_FOLLOWLOCATION,1);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);

    $response = curl_exec($ch);
    $err = curl_error($ch);
    curl_close($ch);


    if ($err) {
        echo "cURL Error #:" . $err;
    } else {
        echo $response;
    }
}
?>

C#

	 
response = sendSmsusingPOST(to, message);

if (response.Contains("success"))
	MessageBox.Show("Successfully sent message");
else
	MessageBox.Show(response);

private string sendSmsusingPOST(string to, string message)
	{
		WebClient client = new WebClient();
		string baseURL,senderId, isOtp, apiKey, response;

		baseURL = "https://www.alcodes.com/api/sms-compose";
		apiKey = "[API_KEY]"; //use your apikey here
		senderId = "[SENDERID]";	// write your sender Id here
		isOtp = "false";	// set to true for otp messages

		NameValueCollection nvc = new NameValueCollection();
		nvc.Add("smsSenderId", senderId);
		nvc.Add("phoneNumbers", to);
		nvc.Add("message", message);
		nvc.Add("is_otp", isOtp);
		nvc.Add("countryCode", "IN");

		ServicePointManager.SecurityProtocol = (SecurityProtocolType)768 | (SecurityProtocolType)3072; //768 for TLS 1.1 and 3072 for TLS 1.2

		string credentials = Convert.ToBase64String(Encoding.ASCII.GetBytes(apiKey + ":passwd"));
		client.Headers[HttpRequestHeader.Authorization] = "Basic " + credentials;
		try
		{
			response = Encoding.ASCII.GetString(client.UploadValues(baseURL, nvc));
		}
		catch (Exception ex)
		{
			response = ex.Message.ToString();
		}
		return response;
	}
		

JAVA

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW");
RequestBody body = RequestBody.create(mediaType, "------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"countryCode\"\r\n\r\nIN\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"smsSenderId\"\r\n\r\AUTHMS\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"is_otp\"\r\n\r\ntrue\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"message\"\r\n\r\ntest-sms\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"phoneNumbers\"\r\n\r\n8949537689\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--");
Request request = new Request.Builder()
  .url("https://www.alcodes.com/api/sms-compose")
  .post(body)
  .addHeader("content-type", "multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW")
  .addHeader("cache-control", "no-cache")
  .addHeader("authorization", "Enter basic authorization here")
  .addHeader("postman-token", "fc379460-276a-64cd-699a-bb58cd33b4f1")
  .build();

Response response = client.newCall(request).execute();

	

JAVASCRIPT

 
var form = new FormData();
form.append("countryCode", "IN");
form.append("smsSenderId", "AUTHMS");
form.append("is_otp", "true");
form.append("message", "test-sms");
form.append("phoneNumbers", "8949537689");

var settings = {
  "async": true,
  "crossDomain": true,
  "url": "https://www.alcodes.com/api/sms-compose",
  "method": "POST",
  "headers": {
    "cache-control": "no-cache",
    "authorization": "Enter basic authorization here",
    "postman-token": "235bd36d-5eb3-cbc8-84ff-b2da87381b39"
  },
  "processData": false,
  "contentType": false,
  "mimeType": "multipart/form-data",
  "data": form
}

$.ajax(settings).done(function (response) {
  console.log(response);
});

	

NODE JS

var request = require("request");

var options = { method: 'POST',
  url: 'https://www.alcodes.com/api/sms-compose',
  headers: 
   { 'postman-token': '23657c18-c0d2-dc58-c20f-0c5e72398a3e',
     authorization: 'Enter basic authorization here',
     'cache-control': 'no-cache',
     'content-type': 'multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' },
  formData: 
   { countryCode: 'IN',
     smsSenderId: 'AUTHMS',
     is_otp: 'true',
     message: 'test-sms',
     phoneNumbers: '8949537689' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

PYTHON

 
import requests

url = "https://www.alcodes.com/api/sms-compose"

payload = "------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"countryCode\"\r\n\r\nIN\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"smsSenderId\"\r\n\r\AUTHMS\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"is_otp\"\r\n\r\ntrue\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"message\"\r\n\r\ntest-sms\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"phoneNumbers\"\r\n\r\n8949537689\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--"
headers = {
    'content-type': "multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW",
    'cache-control': "no-cache",
    'authorization': "Enter basic authorization here",
    'postman-token': "25303984-1446-5a56-d74c-e344975f2a79"
    }

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)