Help?

API

The SmsNative API User Application

The SmsNative Api provides the features and functionality of the SmsNative Platform for use in your own messaging application(s).The SmsNative HTTP API is simple and flexible and can be easily integrated with any website or application. Anyone with an SmsNative Account can use the API.We have made this API code available online so you can start using it in your apps now!

Features

The SmsNative HTTP API has a number of application features that serve a wide range of uses. With the Api, you can;

    • Send SMS to single mobile number
    • Send SMS to multiple mobile numbers
    • Schedule SMS
    • Send Unicode SMS
    • Send SMS to SMS Groups –NEW!*

Parameters

The full HTTP API string is as follows below;

http://www.smsnative.com/sendsms.php?user=xxx&password=yyy&mobile=256XXXXXXX,256XXXXXX&group_id=1,2&senderid=JOHN&message=hello world&unicode=1&&schedule=yyyy:mm:dd:hh:mm:ss       

The table below gives a description of the parameters used in the the API setup above.

No

Field name

Field Value

Field Description

Mandatory

1

user

Username

The login name for your SMS account e.g John

Yes

2

password

Password

The login password for your SMS account

Yes

3

Mobile

Mobile No.

The target mobile numbers separated with a Comma.  e.g. 256750123456,256701123456

Yes 

4

Senderid

Sender Name

The sender name that will show as from address e.g. JOHN

Yes

5

Message

Your Message

The actual text message to send to the target mobile number e.g. Gooday

Yes

6

Schedule

Scheduled Sending Time

This is to schedule the SMS at a future date. The format should be yyyy:mm:dd:hh:mm:ss  e.g. 2012:01:31:14:20:10

-

7

Unicode

1 or 2

This is used for send Unicode Sms via SMS HTTP API.

Unicode=1 – You can directly send the Unicode characters.

Unicode = 2 – You can send Unicode converted as hex

-

8

group_id

group_id=1,2

The Group id in SmsNative ‘My Groups’ Page.

-

 

How to Test the API 

The Following is a Step by Step example of how to test a simplified version of the API containing only a few select variables.

STEP 1. Copy the API text in the Box below and paste it in Word or Notepad or directly to your browser. 

STEP 2. Edit the parameters shown below in orange by replacing them with your SmsNative Username,password,mobile number (in the format shown) and message parameters.

STEP 3. Copy and paste on your browser and press Enter/Go to test.    

STEP 4. If details are input correctly you will receive an Sms in the mobile numbers inputed and a "1111-Success"  Response Code on your Browser page.

http://www.smsnative.com/sendsms.php?user=John&password=pass123&mobile=256750123456,256772700700&senderid=MEETING&message=hello world

Response Codes

The following are response codes for messages sent via the API

CODE

Response

1111

:SUCCESS:SMS Submitted Successfully

1001

:ERROR:Invalid URL

1005

:ERROR:Invalid value in username or password field

1010

:ERROR:Account expired

1015

:ERROR:Insufficient SMS Credits

1020

:ERROR:Invalid Sender

1025

:ERROR:Invalid Schedule Time

1050

:ERROR:Other error messages

1030

:ERROR:Account doesn’t exist

1035

:ERROR:Character count is greater than x

1040

:ERROR:You are not allowed to Send Unicode Messages

1045

:ERROR:Groups Not Found for Given Group Id(s)

 

Notes and Abbreviations;

  1. Messages longer than 158 characters will automatically be concatenated to up to 2 SMS with 158 Characters each for a total length of 316 characters. Each part in a concatenated message is debited as one SMS.
  2.  API: Noun: application programming interface (plural application programming interfaces) (API) a particular set of rules and specifications that software programs can follow to communicate with each other.
  3. HTTP: Hypertext Transfer Protocol, the protocol used most commonly to transfer web pages and accompanying data over the Internet

Useful Links;

1. To Register a NEW account click the following link; http://bit.ly/2HB6EZ8

2. To Tour the Site Features; http://bit.ly/1kQYCZu

3. To Contact Us online; http://bit.ly/1nSMoVN

4. To access our frequently asked questions; http://bit.ly/1gj4TgD

5. To visit the smsnative Facebook page; http://on.fb.me/1eIxXA2

To receive more information about how smsnative can serve your needs, send an email with your name, address and telephone contact to the contacts below OR fill the online form here.

Contacts;

We would be happy to hear from you;

Emmanuel. M

Sales & Support (Uganda)

+256-750-123-456

Email:This email address is being protected from spambots. You need JavaScript enabled to view it. / This email address is being protected from spambots. You need JavaScript enabled to view it.

Web: http://www.smsnative.com

Skype: smsnative


Robert. N

Services & Support SmsNative (East Africa)

+256-701-924-791

Email: This email address is being protected from spambots. You need JavaScript enabled to view it. / sThis email address is being protected from spambots. You need JavaScript enabled to view it.

Web: http://www.smsnative.com

Skype: smsnative