SMS Warrior HTTP API

SMS Warrior HTTP API

Lexicon Software


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

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

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

            -Μέσω Web Service

            -Μέσω ActiveX

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

Αυτές οι μέθοδοι ενδείκνυνται . Είναι πιθανό να χρησιμοποιήσετε διαφορετικές μεθόδους με τον ίδιο λογαριασμό .

 

Στην περίπτωση αυτή οι χρήστες δε χρειάζεται να εγκαταστήσουν κάποιο software . Στην πραγματικότητα η μεταφορά –μεταβίβαση μηνυμάτων δημιουργήθηκε για να μεταφέρει στο χρήστη τα SMS χρησιμοποιώντας το πρωτόκολλο HTTP. Είναι η καλύτερη λύση για τους πελάτες που θέλουν να στείλουν χιλιάδες μηνύματα απλά και γρήγορα. H εκτέλεση του HTTP POST γίνεται στην σελίδα http://www.lexiconsoftware.gr/sms/warrior.asp

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

To Web Service βρίσκεται στη διεύθυνση http://www.lexiconsoftware.gr/sms/service.asmx
Παρέχει 3 μεθόδους :

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

Όλες τις μεθόδους μπορείτε να τις δείτε επιστεπτόμενοι το παραπάνω URL

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

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

  • message   (το κείμενο σας μέχρι 160 χαρακτήρες για ένα μήνυμα και 306 για 2 μηνύματα)

  • To (μέχρι 13 χαρακτήρες, αριθμό κινητού που θα σταλεί το SMS σε διεθνής μορφή), πχ: +306936158137)

  • From (μέχρι 14 χαρακτήρες για τον αριθμό του αποστολέα σε διεθνές σχήμα, ή μέχρι 11 χαρακτήρες για ένα μικρό κείμενο που θα εμφανιστεί σαν αποστολέας στο κινητό του παραλήπτη με λατινικούς χαρακτήρες μόνο)

  • UserID (το όνομα εισόδου σας)

  • Password (ο κωδικός πρόσβασης στις υπηρεσίες μας)

  • DelayUntil ( η ημερομηνία και η ώρα που θέλετε να παραδοθεί το μήνυμα)

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

OK: xxxxxxxxxxxx Credits:96,15€ ή id : xxxxxxxxxxxx Credits:96,15€

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

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

ERR 001 - Invalid username or password
ERR 002 - Not enough credits
ERR 003 - No mobile number provided
ERR 004 - No sender provided
ERR 005 - Phone number too long
ERR 006 - Empty Message
ERR 007 - Phone number too short
ERR 25 - Λάθος αριθμός τηλεφώνου
ERR 77 - Δεν ήταν δυνατή η επικοινωνία με τον πάροχο αποστολής του μηνύματος. Δεν έχινε χρέωση
ERR 5 - Το μήνυμα είναι στην ουρά και θα σταλεί όταν αυτή ελευθερωθεί. Δεν έχινε χρέωση. Θα χρεωθει όταν παραδοθεί
OK= E1024 - Το μήνυμα είναι στην ουρά και θα σταλεί όταν αυτή ελευθερωθεί. Δεν έχινε χρέωση. Θα χρεωθει όταν παραδοθεί

 

 

Αν επιθυμείτε το μήνυμα να σταλεί σε μια συγκεκριμένη μέρα και ώρα τότε χρησιμοποιήστε την παράμετρο 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)

 

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

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

 

Για να δείτε το υπόλοιπό σας κάντε POST στο παρακάτω url

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

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

 

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%20κείμενό%20σας&to=+306936158137

π.χ http://www.lexiconsoftware.gr/sms/warrior.asp?userid=yourid&password=yourpass&from=sender&message=Toκείμενό%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 ( άγνωστη κατάσταση)