This document provides a reference for all features available to you via the HTTP interface for sending SMS.
The HTTP API allows you to integrate your Application (Client) to easysms (Gateway) using the HTTP protocol to send SMS. HTTPS is specifically supported for all transactions using SSL encryption.
General info
The Client issues a HTTP GET request to the easysms HTTP interface supplying a list of required parameters. easysms issues back a HTTP Response which indicates the success of the transaction
Note that the delimiter used in many cases below in returned data, '|', is the pipe character (ASCII 124). Please remember to URL-encode all parameters passed.
The commands available in this version of the easysms API follows below.
Sending SMS
URL: https://www.net2sms.gr/srvauth/index?cmd=easysms&action=send_sms
Accepted Parameters
| Parameter | Description | Presence |
|---|---|---|
text |
Message to be sent. Must be URL encoded. | Mandatory |
mobile_number |
MSIDSN of the recipient that the message will be sent to. Eg: 49175123456 | Mandatory |
originator |
Sender ID (if alphanumeric, max 11 characters, numeric max 16 digits) | Optional |
flash |
Set true to send Flash SMS | Optional |
request_delivery |
Set true to get a delivery report | Optional |
Returns
return_code | sms_id | balance
| Description | |
|---|---|
return_code |
1 for message sent, otherwise message send failed |
sms_id |
the message id, delivery reports are given on message ids |
balance |
the balance of the account |
Example Request to send SMS
To text 'Hello World' to '49175123456' shown as sent by 'MyCompany' you should use:
https://www.net2sms.gr/srvauth/index?cmd=easysms&action=send_sms&text=Hello%20World&mobile_number=49175123456&originator=MyCompany
The gateway will respond something like:
1|456123789|112
Which translates to sms has been queued successfully with id 456123789 and your balance is 112