Http api

1. The Service

Η υπηρεσία επιτρέπει στους πελάτες να στείλουν χιλιάδες μηνύματα (SMS) σε όλο τον κόσμο. Για να χρησιμοποιήσουν την υπηρεσία οι πελάτες πρέπει να έχουν τη σύνδεση στο Internet. Οι πελάτες μπορούν να διαλέξουν τη λύση (επιλογή) που ταιριάζει καλύτερα στο στόχο τους..

-Στείλετε μέσω XML

-Στείλετε μέσω HTTP

-Μέσω Web Service

-Μέσω ActiveX

-Στείλετε μέσω δικού σας Software

Αυτές οι μέθοδοι ενδείκνυνται . Είναι πιθανό να χρησιμοποιήσετε διαφορετικές μεθόδους με τον ίδιο λογαριασμό . Μια εταιρία μπορεί να χρησιμοποιήσει την υπηρεσία για να στείλει πολλά μηνύματα (π.χ επικοινωνία με πελάτες) και/ή αν θέλει να προσθέσει τη δυνατότητα να στέλνουν δωρεάν μηνύματα από το δικό τους δίκτυο (Wed Site) χρησιμοποιώντας τη μέθοδο POST.

1.2) Στείλτε μέσω – POST HTTP/XML

Στην περίπτωση αυτή οι χρήστες δε χρειάζεται να εγκαταστήσουν κάποιο software. Στην πραγματικότητα η μεταφορά –μεταβίβαση μηνυμάτων δημιουργήθηκε για να μεταφέρει στο χρήστη τα SMS, χρησιμοποιώντας το πρωτόκολλο HTTP.

Είναι η καλύτερη λύση για τους πελάτες που θέλουν να στείλουν χιλιάδες μηνύματα απλά και γρήγορα. Για την αντίληψη της σχέσης οι χρήστες ζητούν ένα HTTP POST από

http://www.lexiconsoftware.gr/sms/warrior.asp

1.3) Στείλετε μέσω δικού σας Software

Είναι πιθανό να επεκτείνετε το software που εφάπτεται ευθέως στο δικό μας SMSC. Είναι απαραίτητο να δημιουργήσετε ένα πρόγραμμα που να μπορεί να στέλνει και να λαμβάνει πληροφορίες μέσω του δικτύου, χρησιμοποιώντας το σωστό πρωτόκολλο. Η λύση αυτή συστήνετε μόνο στους πελάτες που έχουν μια καλή ομάδα ανάπτυξης software, επειδή είναι το πιο δύσκολο και πολύπλοκο.

1.4) Στείλτε μέσω του Web Service
To Web Service βρίσκεται στη διεύθυνση http://www.lexiconsoftware.gr/sms/service.asmx
Παρέχει 3 μεθόδους :
Balance – δέχεται σαν παραμέτρους το username και το password και επιστρέφει το τρέχον υπόλοιπο λογαριασμού
Delivery – δέχεται σαν παράμετρο το msgid και επιστρέφει την κατάσταση ενός μηνύματος
SendSMS – δέχεται σαν παραμέτρους το username, το password, τον αποστολέα, τον παραλήπτη και το κείμενο του μηνύματος και επιστρέφει το msgid της αποστολής το οποίο μπορεί να χρησιμοποιηθεί για την προβολή της κατάστασης του SMS

Επίσης προστέθηκαν νέες μέθοδοι όπως

2. Πως να στείλετε μέσω Post

Για να στείλετε μηνύματα μέσω POST πρέπει να στείλετε μία HTTP ή XML POST αίτηση στο :
http://www.lexiconsoftware.gr/sms/warrior.asp

Στον τομέα των πληροφοριών του POST request πρέπει να καταχωρίσετε αυτές τις μεταβλητές με τις δικές τους τιμές

message (το κείμενο σας μέχρι 160 χαρακτήρες)
To(μέχρι 13 χαρακτήρες, αριθμό κινητού που θα σταλεί το SMS σε διεθνής μορφή), πχ: +306936158137)
From (μέχρι 14 χαρακτήρες για τον αριθμό του αποστολέα σε διεθνές σχήμα, ή μέχρι 11 χαρακτήρες για ένα μικρό κείμενο που θα εμφανιστεί σαν αποστολέας στο κινητό του παραλήπτη)
UserID (το όνομα εισόδου σας)
Password (ο κωδικός πρόσβασης στις υπηρεσίες μας)
Rid (το όνομα εισόδου σας αν στέλνετε εσείς ή το username του πελάτη σας αν κάνετε μεταπώληση)
DelayUntil (η ημερομηνία και η ώρα που θέλετε να παραδοθεί το μήνυμα)

Ο SmsWarrior. θα επικυρώσει την σωστή αποστολή του μηνύματος με το παρακάτω κείμενο

OK: 136982. Credits:96,15€

Το OK: 136982 θα το χρησιμοποιήσετε αργότερα για να δείτε το status του μηνύματος. To Credits είναι το υπόλοιπό σας σε Ευρώ

Σε άλλη περίπτωση θα σας επιστραφεί το ανάλογο κείμενο αν δηλαδή δεν στείλετε αριθμό ή όνομα αποστολέα κλπ.

ERR 001 – Invalid username or password

ERR 25 – Λάθος αριθμός τηλεφώνου
ERR 77 – Δεν ήταν δυνατή η επικοινωνία με τον πάροχο αποστολής του μηνύματος
ERR 5 – Το μήνυμα είναι στην ουρά και θα σταλεί όταν αυτή ελευθερωθεί

Παράδειγμα στο τέλος αυτού του εγγράφου

Μεταχρονολογημένη αποστολή

Αν επιθυμείτε το μήνυμα να σταλεί σε μια συγκεκριμένη μέρα και ώρα τότε χρησιμοποιήστε την παράμετρο DelayUntil

Παράδειγμα: DelayUntil=dd/mm/yyyy hh:mm:ss (Για το κενό ανάμεσα στην ημερομηνία και ώρα βάλτε το %20)
Userid=YourUsername&Password=YourPassword&From=Sender&To=+306936158137&Message=YourMessage&DelayUntil=31/10/2012%2011:00:00

Αναφορά παράδοσης

Μπορείτε να πάρετε αναφορά παράδοσης για το κάθε SMS που στέλνετε χρησιμοποιώντας την παρακάτω σελίδα

http://www.lexiconsoftware.gr/sms/viewstatus.asp

παράμετροι

msgid (το ID που λάβατε κατά την αποστολή. π.χ OK: 136982)

Παράδειγμα στο τέλος αυτού του εγγράφου
Προβολή του υπολοίπου του λογαριασμού σας
Για να δείτε το υπόλοιπό σας κάντε POST στο παρακάτω url

http://www.lexiconsoftware.gr/sms/balance.asp?username=xxxxx&password=xxxxx

όπου xxxx είναι φυσικά τα δικά σας στοιχεία

Δοκιμαστική αποστολή

Για να στείλετε εικονικά δώστε σαν αριθμό τηλεφώνου παραλήπτη τον αριθμό 1111111111 (10 φορές το 1)

Η απάντηση που θα πάρετε είναι το Success και το υπόλοιπο του λογαριασμού σας

Παράδειγμα αποστολής:

POST /sms/warrior.asp HTTP/1.1

Host: www.lexiconsoftware.gr

Content-Length: 94

Content-type: application/x-www-form-urlencoded

Accept-Language: el

Cache-Control: no-cache

userid=yourid&password=yourpass

&from=Sender&message=To κείμενό σας&to=+306936158137

π.χ
http://www.lexiconsoftware.gr/sms/warrior.asp?userid=yourid&password=yourpass&from=sender&message=To%20κείμενό%20σας&to=+306936158137

Δεν χρειάζεται να κάνετε μετατροπή τους Ελληνικούς χαρακτήρες μιας και αναλαμβάνει η υπηρεσίας μας να το κάνει αυτό

Αν στέλνετε από PHP τότε πρέπει να μετατρέψετε το κείμενο σε Windows-1253. γιατί αν δεν γίνει αυτό το ελληνικό κείμενο θα εμφανίζεται σαν Ξ•Ξ›Ξ›Ξ—Ξ�Ξ™Ξ?Ξ‘

Π.χ αν χρησιμοποιείτε UTF-8 τότε χρησιμoποιήστε την συνάρτηση
iconv(“UTF-8″,”Windows-1253”,$message) όπου $message είναι το κείμενο αποστολής.

Παράδειγμα αίτησης αναφοράς

http://www.lexiconsoftware.gr/sms/viewstatus.asp?msgid=ΟΚ:36982

επιστροφή από τον SMSWarrior

delivered (παραδόθηκε)

sent (εστάλει)

pending (δεν έχει παραδοθεί ακόμη)

failed (αποτυχία)

expired (έληξε)

rejected (απορρίφθηκε)

unknown subscriber (άγνωστος παραλήπτης)

Unknown status (άγνωστη κατάσταση)