Το παλιό http api, που χρησιμοποιείται ακόμη από υφιστάμενες εγκαταστάσεις που δεν έχουν αναβαθμιστεί στο νέο, μπορείτε να το βρείτε σε αυτή τη σελίδα.
Εμείς συνεχίζουμε να παρέχουμε αυτή την υπηρεσία, για λόγους συμβατότητας, αλλά δεν το εξελίσουμε πλέον και δε προσθέτουμε νέα χαρακτηριστικά σε αυτό. Αν ξεκινάτε τώρα τη χρήση των υπηρεσιών μας, σας συστήνουμε τη χρήση των νέων apis καθώς, εκτός από τα πολλαπλά νέα χαρακτηριστικά προσφέρουν και ασφάλεια μέσω της χρήσης του https προτοκόλλου.
Το url που πρέπει να χρησιμοποιείτε είναι το
http://www.liveall.eu/webservice/sms/sendSMSHTTP.php/
ή το
http://www.liveall.eu/webservice/sms/sendSMSHTTPUTF8.php/
Σε αυτό, με GET request προσθέτουμε και τις απαραίτητες μεταβλητές που είναι οι εξής:
| Μεταβλητή | Περιγραφή |
|---|---|
| username [alphanumeric] | όνομα χρήστη που έχετε στο liveall.eu |
| password [alphanumeric] | κωδικός χρήστη για το liveall.eu |
| destination [alphanumeric] |
Νούμερο κινητού, πχ. για Ελλάδα 306912345678, δηλαδή χωρίς μηδενικά ή το σύμβολο + μπροστά. (Νέο χαρακτηριστικό) Αν θέλουμε να στείλουμε το ίδιο μήνυμα σε περισσότερους αποδέκτες, τότε μπορούμε να βάλουμε τους αριθμούς που θέλουμε χωρισμένους με τελεία [.] Το web-service θα στείλει τόσο SMS όσα και οι αριθμοί και τα αποτελέσματα των αποστολών θα είναι χωρισμένα με το χαρακτήρα [|] πχ. θα είναι: OK ID:1234|OK ID:1235|OK ID:1236 |
| sender [alphanumeric] | Όνομα αποστολέα. Μέγιστο πλάτος 11 χαρακτήρες. Δεν επιτρέπεται να είναι τηλ νούμερο. |
| message [alphanumeric] | Το κείμενο του μηνύματος SMS που θέλετε να στείλετε. Υπόψιν, πως το κείμενο πρέπει να είναι url encoded. Μπορείτε να γράψετε λατινικούς και ελληνικούς χαρακτήρες (πάντα με url encode). |
| batchuserinfo [alphanumeric(64) - προεραιτικό] | Πεδίο που ο χρήστης - αποστολέας καταχωρεί οποιαδήποτε πληροφορία και αυτό χρησιμεύει στα reports. Μέγιστο μήκος 64 χαρακτήρες |
| pricecat [integer - προεραιτικό] | Με αυτή τη μεταβλητή επιλέγετε μεταξύ κανονικής τιμολογιακής κατηγορίας - route και εναλλακτικών τιμ. κατηγοριών (πχ. low cost routing). Αν ορίσετε 0 ή δεν συμπεριλάβετε καθόλου αυτή την παράμετρο, το σύστημα θα στέλνει με την κανονική τιμή. Αν ορίσετε 1, το σύστημα θα στέλνει με την low cost τιμή. Οι προορισμοί που υποστηρίζουν low cost φαίνονται στον τιμοκατάλογο του site και στη σελίδα με τις πληροφορίες σχετικά με τις τιμολογιακές κατηγορίες. |
Ένα παράδειγμα χρήσης φαίνεται παρακάτω:
http://www.liveall.eu/webservice/sms/sendSMSHTTP.php?username=myusername&password=mypass&destination=306912345678&sender=MyName&message=Hello%20there
Επίσης, σε περίπτωση που θέλετε να στείλετε μαζικά SMS (πάνω από 30), θα πρέπει να χρησιμοποιείτε το παρακάτω url αλλά με POST request:
https://www.liveall.eu/webservice/sms/postSMS.php/
Αυτό σημαίνει πως, δε βάζουμε τις μεταβλητές στο url (?username=myusername&password=12345678 κοκ), αλλά τις περνάμε σαν POST μεταβλητές (πάντα url encoded). Ο τρόπος που επιτυγχάνεται αυτό, διαφέρει για κάθε περιβάλλον προγραμματισμου.
Τα παραπάνω requests, σε περίπτωση επιτυχίας, θα μας επιστρέψει:
OK ID:<SMS HTTP request ID>
όπου <SMS HTTP request ID> [integer], είναι το μοναδικό ID που αντιστοιχεί σε αυτό το SMS.
ένα παράδειγμα:
OK ID:1234
ή για την περίπτωση των πολλαπλών αριθμών:
OK ID:1234|OK ID:1235|OK ID:1236
Σε περίπτωση αποτυχίας λαμβάνουμε κάποιο από τα μηνύματα.
http://www.liveall.eu/webservice/sms/getSMSStatus.php/
| Μεταβλητή | Περιγραφή |
|---|---|
| SMSId [integer] | Το ID που μας επέστρεψε το web service κατά την αποστολή του SMS με HTTP API. |
| username [alphanumeric] | Το username που έχετε στο liveall.eu |
| password [alphanumeric] | Το password για το παραπάνω username |
Έτσι, ένα παράδειγμα αποστολής φαίνεται αμέσως παρακάτω:
http://www.liveall.eu/webservice/sms/getSMSStatus.php?SMSId=1111&username=myusername&password=mypass
και σαν απάντηση, σε περίπτωση σφάλματος, θα έχουμε μία από τις παρακάτω τιμές:
Error: 1012 - User authendication failure. Username and/or password mismatch.
Error: 1027 - No SMS ID given.
Error: 1028 - No valid parameters given.
ή ένας πίνακας από τιμές χωρισμένες με τον χαρακτήρα [:], που περιέχει όλα τα στοιχεία της κατάστασης του SMS. Συγκεκριμένα:
<SMSId>:<Submtited On>:<Destination number>:<Delivered On>:<Status number>:<Quantity of SMS>:<Charge amount>
πχ. 2345:20101212152514:306912345678:20101212152519:2048:1:0.057
http://www.liveall.eu/webservice/sms/getAccountBalance.php/
Οι απαραίτητες μεταβλητές για την κλήση αυτού του endpoint είναι:
| Μεταβλητή | Περιγραφή |
|---|---|
| username [alphanumeric] | Το username σας για το LiveAll.eu |
| password [alphanumeric] | Το password |
| countryprefix [alphanumeric] | (προεραιτικό) Το πρόθεμα της χώρας για την οποία θέλετε να ελέγξετε το υπόλοιπο της ποσότητας των sms που μένουν ακόμη στο λογαριασμό σας. πχ. Αν δώσε σαν countryprefix το 30 (πρόθεμα Ελλάδας) και έχετε υπόλοιπο 112.90€ και η τιμή του SMS για Ελλάδα είναι 0.024, τότε το webservice θα σας επιστρέψει 4704 διαθέσιμα SMS |
Οι πιθανές απαντήσεις του webservice είναι:
Status: 1000 - Balance:BalanceInEuro|SmsRemainCount:RemainingSMSCount
σε περίπτωση επιτυχίας, όπου
ενώ σε περίπτωση αποτυχίας οι πιθανές απαντήσεις μπορεί να είναι:
Error: 1001 - No username given.
Error: 1002 - No password given.
Ένα παράδειγμα χρήσης φαίνεται αμέσως πιο κάτω:
http://www.liveall.eu/webservice/sms/getAccountBalance.php?username=myusername&password=pass%40%24&countryprefix=30