If you are not interested in sending Bulk SMS messages from our website, but you want to have the ability to send SMS messages through your own Web site or Application, you can use the HTTP SMS API. All you need is some basic knowledge of web development and programming.
The basic functions provided by HTTP SMS API are:
You can easily send SMS messages in any language with up to 100 recipients per call. After each SMS API usage our system will reply by giving you information about your message.
This function can give you information about the status of your outgoing SMS messages. All you need is the ID of your outgoing message.
If you want you can schedule the next message sending via the SMS API any time you want in the future. The scheduled sending is very easy to use and can be canceled just as easily.
The user of HTTP SMS API can learn the balance of his/her account and use it regarding his/her needs in order to develop his/her own application.
For greater security through the servers of smsbox, the user can make use of sesskey. The process is simple, instead of sending to every slope the username and the password, it sends them once, then the server returns the sesskey which afterwards is used to communicate with each other.
Using our HTTP SMS API you can connect to our gateway and send SMS messages from your web page or application very simply. You can use the HTTP SMS API in any programming language or dynamic web pages.
To send an SMS you have to call a url like the following:
http://www.smsbox.gr/httpapi/sendsms.php?username=x&password=x&text=x&from=x&to=x You can also send the parameters using the post method at the same url:
http://www.smsbox.gr/httpapi/sendsms.php by using the POST method.
The 'username' parameter is the username of your smsbox account, the 'password' is your password, 'text' is the text of the SMS, 'from' is the sender's id and 'to' is the recipient's mobile phone number.
For example if we call the following url:
http://www.smsbox.gr/httpapi/sendsms.php?username=user&password=passwd&text=my+first+sms %21&from=mysite&to=6941231231 we will send an SMS to the mobile phone number 306941231231 with the text “my first SMS!” and sender's id “mysite”. The username is “user” and the password is “password”.
The parameters must be url encoded. So the black space is converted to + and the ! to %21. The programming languages have functions to convert a string to a url endcoded string. For more info you can visit: http://en.wikipedia.org/wiki/Percent-encoding
The sender's id can be up to 11 latin characters or 13 digits. Only the latin characters (a-z, A-Z), the digits 0-9 and the following characters ! ( ) * # % . , ? - = + ; & are permitted.
The text can be up to 612 characters long. The following characters: [ , ], { , } , ~ , ^ , | , \ and € need 2 bytes so they are count as 2 characters. If the text is more than 612 characters long, the server returns a message to you and the SMS is not delivered. If the text is up to 160 characters long you are charged 1 SMS, from 161 to 306 characters you are charged as 2 SMS messages (long SMS), from 307 to 459 as 3 SMS messages and from 460 up to 612 you are charged as 4 SMS messages.
The GSM 7-bit format is used for text. For more info you can visit: https://en.wikipedia.org/wiki/SMS
Using this format you can send an SMS of up to 160 characters (1 SMS cost). If you use unicode format then you can write any character in any language, but each SMS can be up to 70 characters.
So if you want to use gsm 7-bit format you must convert every character of your text to latin characters. For exampe the character ä must be converted to a , the á to a and the ň to n. The euro character (€) should be converted into %80. The Greek letters are supported using the following conversion (see gsm 7bit table):
Γ %13
Δ %10
Θ %19
Λ %14
Ξ %1Α
Π %16
Σ %18
Φ %12
Ψ %17
Ω %15
€ %80
So if we want to send an SMS with the text “it costs 10€” we have to call the following url:
http://www.smsbox.gr/httpapi/sendsms.php?
username=user&password=passwd&text=TO+%16P
%15TO+MOY+MHNYMA %21&from=mysite&to=6941231231 The new line character is the %0D%0A and it counts for 2 characters. You can send up to 100 SMS with one HTTP call. The mobile phone numbers should be separated by commas:
http://www.smsbox.gr/httpapi/sendsms.php?
username=user&password=passwd&text=my+second+SMS
%21&from=mysite&to=306941231231,306971231231,306931231231,306941231231 When you make a HTTP call like above, the server processes the data and returns to you a reply. This reply is important, you should read it first, and then you should make another call to send more SMS. That means that you should not call the url more than once at the same time, but wait the server's response and then make another HTTP call.
The server's response for the first SMS is like the following:
20 9534538 306941231231 The first number (20) is the status of SMS, the second (9534538) is the SMS id (unique for each SMS) and the third is the number you sent.
If you send more than 1 SMS(like the second example) the response will be like the following:
20 9534538 306941231231
20 9534539 306971231231
20 9534540 306931231231
41 9534541 0941231231 Each line concerns one SMS (one mobile phone number).
20: the SMS is accepted from our gateway
40: no SMS available at your smsbox account
41: the number is wrong (wrong digits number of unknown prefix)
42: unknown prefix
43: temporarily no routing
44: spam sms
52: black list
60: SMS rejected
Your account is charged only if the SMS status is 20.
You can be informed when an SMS status changes, using our call back url functionality. In order to use it with your account, you should give us a url, where we will send you the SMS id and its new status, when an SMS status changes. The url might be like the following :
http://yourserver.gr/getsmsstatus.php So, when the first SMS will be delivered to the mobile phone, we will call a url :
http://yourserver.gr/getsmsstatus.php?id=9534538&status=1
The number 9534538 is the SMS id that the server returns when you send the SMS and the status 1 means that the SMS was delivered to the mobile phone.
The possible SMS statuses that you can get with the delivery reports are the following:
1: the SMS has been delivered to the mobile phoneExcluding the previous way to get the delivery reports, you can also request from the server the status of a specific SMS that you have sent by the HTTP SMS API.
You call a url like the following:
www.smsbox.gr/httpapi/getreports.php?
username=username&password=password&ids=42841532,42837170
The ids parameter is the sms id that the server returns when we send the sms. They can be up to 100 sms id, separated by commas.
The server response is like the following:
42837170 1 306947576421
42841532 1 306947992731
In each line there is the sms id, the sms status and the mobile phone number of the recipient. The sms status will be stored in our server for at least one year from the date it has been sent.
You can schedule the sms messages not to be sent at the time you call the HTTP SMS API, but at a certain
time in the future. To schedule an sms message, you call the api as before and you just add one
more parameter, the “datetosend”. The parameter “datetosend” will have as value
the date/time that you want the sms to be sent. The date/time must be in the
future and in the following format: datetosend=2018-10-29-11:51 . That means
year-month-day-hour-minutes. If the date is not in the future, the sms is not sent
and the server returns : “past date”.
For example
http://www.smsbox.gr/httpapi/sendsms.php?
username=user&password=passwd&text=my+second+sms%21&from=mysite&to
=6971231231,306991231231,6931231231,6941231231&datetosend=2013-11-26-
10:26
The server response will be like the following:
Sessionid 231055
10 49858279 306971231231
10 49858280 306991231231
10 49858281 306931231231
10 49858282 306941231231
At the first line there is the “Sessionid”. This is a unique number, and it concerns all the SMS of the same url call (1-100). It is used if the user wants to cancel this scheduled sending. The next lines have the number 10, followed by the SMS id and the mobile number. The status “10” means that the SMS have been scheduled correctly.
To cancel any scheduled messages, without of course to be charged for them, you must have saved the sessionid mentioned above.
To cancel these messages you have to call the following url:
http://www.smsbox.gr/httpapi/cancelsms.php?
username=user&password=passwd&sessionid=231055 The server returns 1 if cancellation is done and 0 if not (ie wrong sessionid or already canceled or SMS)
You can also see the scheduled SMS if you login at your account from the web (www.smsbox.gr) and click on "scheduled SMS". From there you can also cancel the scheduled SMS by pressing the “X” button.
You can check the balance of your account by calling the following url:
http://www.smsbox.gr/httpapi/getbalance.php?
username=user&password=pass where 'user' is your user name and 'pass' your password. The server will return your account balance.
You have the ability not to put the username and password in each call to sendsms.php.
To do this, you must first call auth.php using the username and password parameters:
https://www.smsbox.gr/httpapi/auth.php?username=&password= The server will return a key (sesskey) in the format: OK ab23523c90349d2340v0a09
ab23523c90349d2340v0a09 is the sesskey. This key is active for 2 hours.
Then you can send sms messages simply by using sesskey instead of username and password on sendsms.php, ie:
http://www.smsbox.gr/httpapi/sendsms.php?
sesskey=ab23523c90349d2340v0a09&text=x&from=x&to=x You can do the same using sesskey with getbalance.php and getreports.php. Each time one of them is called, the 2-hour time for the key is renewed.