Endpoint:

https://api.esms.com.my/sms/send

Method:

POST, supported content-type are:

• application/x-www-form-urlencoded; charset=utf-8
• application/json; charset=utf-8

* charset behind is necessary when you're sending in Unicode messages, such as Chinese characters.

Parameters:

Response:

Response would be returned in application/json format.

An example of Successful response would be:

{"status":0,"creditDeducted":1,"message":"ok","id":"88ce9c6e-1707-41b8-95a2-91d228001fc7","parts":1,"type":0}

An example of Failed response would be:

{"status":9,"message":"Invalid phone number, please do not include any non-numeric character","id":"c8d6bb1c-bff6-47d5-9e01-dc2596bbdbe7"}

Response Status Code:

SMS Length Calculation:

Note that SMS has their length limitation, for example, an ASCII SMS can only contains up to 160 characters. SMS containing more than 160 characters would be treated as 2 SMS or more.

• We support up to maximum of 10 parts SMS.
• Not all operators support long SMS, certain operator (such as DiGi) may split long SMS to different SMS part, hence you will receive it as 2 or more different SMS message.
• Unicode and ASCII have different maximum character count, kindly refer to table below.

* Certain special characters may be treated as 2 character in ASCII mode, you may refer at table "Basic Character Set Extension" here

Code Sample:

PHP

<?php 
	function sendSmsToEsms() {
		$url = 'https://api.esms.com.my/sms/send';
		
		$data = array('user' => 'yourapikey', 
			'pass' => 'yourapisecret', 
			'to' => '60123456789', 
			'msg' => 'RM0.00 Hello from ESMS');

		$options = array(
			'http' => array(
				'header'  => "Content-type: application/x-www-form-urlencoded; charset=utf-8",
				'method'  => 'POST',
				'content' => http_build_query($data)
			)
		);
		$context  = stream_context_create($options);
		$result = file_get_contents($url, false, $context);
		if ($result === FALSE) { /* Handle error */ }

		var_dump($result);
	}
?>

										

C#

static async void sendSmsToEsms()
{
	var url = "https://api.esms.com.my/sms/send";
	try
	{
		var values = new Dictionary
		{
		   { "user", "yourapikey" },
		   { "pass", "yourapisecret" },
		   { "to", "60123456789" },
		   { "msg", "RM0.00 Hello from ESMS" }
		};

		var content = new FormUrlEncodedContent(values);

		var client = new HttpClient();
		var response = await client.PostAsync(url, content);

		var responseString = await response.Content.ReadAsStringAsync();
		Console.WriteLine("Response: " + responseString);
	}
	catch (Exception ex)
	{
		Console.WriteLine(ex.Message);
		Console.WriteLine(ex.StackTrace);
	}
}

										

VB

Imports System.Text
Imports System.Net
Imports System.IO
Imports System.Web

Module Module1

    Sub Main()
        SendSmsToEsms("RM0.00 Hello from ESMS", "60123456789")
    End Sub

    Private Sub SendSmsToEsms(msg As String, number As String)
        Dim s As HttpWebRequest
        Dim enc As UTF8Encoding
        Dim postdata As String
        Dim postdatabytes As Byte()
        s = HttpWebRequest.Create("https://api.esms.com.my/sms/send")
        enc = New System.Text.UTF8Encoding()

        postdata = "user=yourapikey"
        postdata += "&pass=yourapisecret"
        postdata += "&to=" & number
        postdata += "&msg=" & System.Web.HttpUtility.UrlEncode(msg)

        postdatabytes = enc.GetBytes(postdata)
        s.Method = "POST"
        s.ContentType = "application/x-www-form-urlencoded; charset=utf-8"
        s.ContentLength = postdatabytes.Length

        Using stream = s.GetRequestStream()
            stream.Write(postdatabytes, 0, postdatabytes.Length)
        End Using
        Dim result = s.GetResponse()
        Dim reader As New StreamReader(result.GetResponseStream())
        Dim streamText As String = reader.ReadToEnd()

        Console.WriteLine("Response: " & streamText)
    End Sub

End Module

										

Java

import java.io.*;
import java.net.*;
import java.util.*;

// Other codes

public void sendSmsToEsms() {
	try {
		URL url = new URL("https://api.esms.com.my/sms/send");
		
		Map params = new LinkedHashMap<>();
		params.put("user", "yourapikey");
		params.put("pass", "yourapisecret");
		params.put("to", "60123456789");
		params.put("msg", "RM0.00 Hello from ESMS");

		StringBuilder postData = new StringBuilder();
		for (Map.Entry param : params.entrySet()) {
			if (postData.length() != 0) postData.append('&');
			postData.append(URLEncoder.encode(param.getKey(), "UTF-8"));
			postData.append('=');
			postData.append(URLEncoder.encode(String.valueOf(param.getValue()), "UTF-8"));
		}
		byte[] postDataBytes = postData.toString().getBytes("UTF-8");

		HttpURLConnection conn = (HttpURLConnection)url.openConnection();
		conn.setRequestMethod("POST");
		conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded; charset=utf-8");
		conn.setRequestProperty("Content-Length", String.valueOf(postDataBytes.length));
		conn.setDoOutput(true);
		conn.getOutputStream().write(postDataBytes);

		try (InputStream is = conn.getInputStream()) {
			try (InputStreamReader isr = new InputStreamReader(is, "UTF-8")) {
				try (Reader in = new BufferedReader(isr)) {
					for (int c; (c = in.read()) >= 0;)
						System.out.print((char)c);
				}
			}
		}

	} catch (Exception ex) {
		ex.printStackTrace(System.out);
	}
}

										

NodeJS

var querystring = require('querystring');
var https = require('https');

function SendSmsToEsms() {
  var post_data = querystring.stringify({
      'user' : 'yourapikey',
      'pass': 'yourapisecret',
      'to': '60123456789',
      'msg' : 'RM0.00 Testing'
  });

  // An object of options to indicate where to post to
  var post_options = {
      host: 'api.esms.com.my',
      port: '443',
      path: '/sms/send',
      method: 'POST',
      headers: {
          'Content-Type': 'application/x-www-form-urlencoded; charset=utf-8',
          'Content-Length': Buffer.byteLength(post_data)
      }
  };

  // Set up the request
  var post_req = https.request(post_options, function(res) {
      res.setEncoding('utf8');
      res.on('data', function (chunk) {
          console.log('Response: ' + chunk);
      });
  });

  // post the data
  post_req.write(post_data);
  post_req.end();

}

SendSmsToEsms();

										

HTML Javascript

alert("You must be doing something wrong, please do not call our API from frontend directly.");
alert("You should build a backend API to call us, and serve your frontend with this API you built.");