HTTP GET API
Το smsme HTTP GET API έχει ως στόχο να δώσει στους προγραμματιστές ένα εύκολο και γρήγορο τρόπο να αποκτήσουν πρόσβαση στην πλατφόρμα του smsme μέσα από τις δικές τους εφαρμογές.
Σε κάθε λειτουργία ελέγχονται τα στοιχεία εισόδου Usename και Password. Εάν δημιουργήσατε το account σας μέσω του https://www.smsme.gr τότε το Username σας είναι το email που μας έχετε δηλώσει. Οι λειτουργίες που υποστηρίζει το HTTP GET API είναι οι παρακάτω:
Περιεχόμενα
Υπόλοιπο Λογαριασμού
Έλεγχος υπολοίπου
https://webservice.smsme.gr/login.aspx?Username=###&Password=####
Μεταβλητές : Username, Password
Υποχρεωτικά Πεδία: Username, Password
Επιστρέφει: Υπόλοιπο Λογαριασμού σε ευρώ με 3 δεκαδικά ψηφία ή Κείμενο Σφάλματος
Μηνύματα Λάθους:
BAD USER (δεν βρέθηκε ο χρήστης με το συγκεκριμένο username και password) ERROR PASSWORD (δεν δόθηκε password) ERROR USERNAME (δεν δόθηκε username)
Παράδειγμα:
Request
https://webservice.smsme.gr/login.aspx?Username=user&Password=passwd
Response
0,932
Τιμοκατάλογος
https://webservice.smsme.gr/PriceList.aspx?Username=###&Password=####
Μεταβλητές : Username, Password
Υποχρεωτικά Πεδία: Username, Password
Επιστρέφει: Πίνακες με τις τιμές σε ευρώ για τις χώρες που παρέχουμε στο χρήστη σε μορφή XML ή Κείμενο Σφάλματος
Μηνύματα Λάθους:
BAD USER (δεν βρέθηκε ο χρήστης με το συγκεκριμένο username και password) ERROR PASSWORD (δεν δόθηκε password) ERROR USERNAME (δεν δόθηκε username)
Παράδειγμα:
Request
https://webservice.smsme.gr/PriceList.aspx?Username=user&Password=passwd
Response
<?xml version="1.0" encoding="utf-8"?>
<Smsme>
<PriceList>
<Operator>COSMOTE</Operator>
<mccmnc>20201</mccmnc>
<Price>0.010</Price>
<CountryName>Greece</CountryName>
<CountryCode>30</CountryCode>
</PriceList>
<PriceList>
<Operator>VODAFONE</Operator>
<mccmnc>20205</mccmnc>
<Price>0.010</Price>
<CountryName>Greece</CountryName>
<CountryCode>30</CountryCode>
</PriceList>
<PriceList>
<Operator>Q-TELECOM</Operator>
<mccmnc>20209</mccmnc>
<Price>0.010</Price>
<CountryName>Greece</CountryName>
<CountryCode>30</CountryCode>
</PriceList>
<PriceList>
<Operator>WIND</Operator>
<mccmnc>20210</mccmnc>
<Price>0.010</Price>
<CountryName>Greece</CountryName>
<CountryCode>30</CountryCode>
</PriceList>
</Smsme>
Αναφορές Παράδοσης
https://webservice.smsme.gr/Reports.aspx?Username=###&Password=####&Sdate=####&Edate=####&Originator=####&Mobile=####
Μεταβλητές : Username, Password, Sdate, Edate, Originator, Mobile
Sdate : Ημερομηνία από την οποία θα ξεκινήσουν οι αναφορές – START DATE (yyyy-MM-dd HH:mm:ss)
Edate : Ημερομηνία στην οποία θα τελειώσουν οι αναφορές – END DATE (yyyy-MM-dd HH:mm:ss)
Originator : O αποστολέας του μηνύματος (αλφαριθμητικό μέχρι 11 χαρακτήρες)
Mobile : O παραλήπτης του μηνύματος (αριθμητικό υποχρεωτικά με πρόθεμα χώρας )
ReportID: Ο κωδικός αναφοράς που προήλθε από απλή η μαζική αποστολή sms
Υποχρεωτικά Πεδία: Username, Password, Sdate, Edate
Προαιρετικά Πεδία: Originator, Mobile
Επιστρέφει: Πίνακα με τις αναφορές από τις αποστολές που πραγματοποίησε ο πελάτης για ένα συγκεκριμένο χρονικό διάστημα σε μορφή XML ή Κείμενο Σφάλματος
Μηνύματα Λάθους:
BAD USER (δεν βρέθηκε ο χρήστης με το συγκεκριμένο username και password) ERROR PASSWORD (δεν δόθηκε password) ERROR USERNAME (δεν δόθηκε username) ERROR START DATE (δεν δόθηκε ημερομηνία από την οποία θα ξεκινήσουν οι αναφορές) ERROR END DATE (δεν δόθηκε ημερομηνία στην οποία θα τελειώσουν οι αναφορές) ERROR DATE FORMAT (μία ή και οι δύο ημερομηνίες που δόθηκαν στα πεδία Sdate,Edate δεν έχει τη σωστή μορφή - yyyy-mm-dd HH:mm:ss) ERROR Mobile (Η μεταβλητή Mobile - παραλήπτης είτε δεν είναι αριθμητική είτε έχει μικρό σύνολο χαρακτήρων)
Παράδειγμα:
Request
https://webservice.smsme.gr/Reports.aspx?Username=user&Password=passwd&Sdate=2013-01-01%2000:00&Edate=2013-01-02%2000:00
Response
<?xml version="1.0" encoding="utf-8"?>
<Reports>
<Report>
<ReportDate>2013-01-01T14:37:03+02:00</ReportDate>
<ReportStatus>Delivered</ReportStatus>
<Mobile>306912345678</Mobile>
<Cost>0.010</Cost>
<Operator>WIND</Operator>
<mccmnc>20210</mccmnc>
</Report>
</Reports>
Μαζική Αποστολή SMS
https://webservice.smsme.gr/SendBulkSmsRequest.aspx?Username=###&Password=####&Originator=####&Mobile=####&Body=####&smsDate=####
Μεταβλητές : Username, Password, Originator, Mobile, Body, smsDate
Originator : O αποστολέας του μηνύματος (αλφαριθμητικό μέχρι 11 χαρακτήρες)
Mobile : Oι παραλήπτες του μηνύματος (αριθμητικό υποχρεωτικά με πρόθεμα χώρας π.χ. 30 για Ελλάδα ) *οι παραλήπτες θα πρέπει να είναι χωρισμένοι με κόμμα (,)
Body : To μήνυμα (μέχρι 160 χαρακτήρες)
smsDate : Ημερομηνία και ώρα αποστολής του μηνύματος. - σε περίπτωση που δεν σταλεί η μεταβλητή το μήνυμα θα αποστολή άμεσα. - yyyy-mm-dd HH:mm:ss)
Υποχρεωτικά Πεδία: Username, Password, Originator, Mobile, Body
Προαιρετικά Πεδία: smsDate
Επιστρέφει: ΟΚ , αριθμός μηνυμάτων που εστάλησαν και λίστα με τον παραλήπτη και τον κωδικό αναφοράς για κάθε SMS
Μηνύματα Λάθους:
BAD USER (δεν βρέθηκε ο χρήστης με το συγκεκριμένο username και password) ERROR PASSWORD (δεν δόθηκε password) ERROR USERNAME (δεν δόθηκε username) ERROR ORIGINATOR (δεν δόθηκε αποστολές μηνύματος) ERROR Mobile (δεν δόθηκε παραλήπτης) ERROR BODY (δεν δόθηκε περιεχόμενο μηνύματος) NOT ENOUGH CREDITS (Ο πελάτης δεν έχει αρκετά χρήματα στο λογαριασμό του) EXEPTION ERROR (παρουσιάστηκε πρόβλημα κατά την αποστολή παρακαλώ δοκιμάστε ξανά.) WRONG NUMBER (Ο αριθμός παραλήπτη που δόθηκε δεν ήταν σωστός) NO CREDITS (Ο πελάτης δεν έχει χρήματα στο λογαριασμό του) BAD ORIGINATOR (ο αποστολές δεν είναι σωστός - πάνω απο 11 χαρακτήρες) BAD DATE (η ημερομηνία που δόθηκε στο πεδίο smsDate δεν έχει τη σωστή μορφή - yyyy-mm-dd HH:mm:ss)
Παράδειγμα:
Request
https://webservice.smsme.gr/SendBulkSmsRequest.aspx?Username=user&Password=passwd&Originator=test&Mobile=306912345678,306912345679,306912345670&Body=this%20is%20a%20test
Response
OK: 3 306912345678:12345 306912345679:12346 306912345670:12347
Απλή αποστολή SMS
https://webservice.smsme.gr/SendSmsRequest.aspx?Username=###&Password=####&Originator=####&Mobile=####&Body=####&smsDate=####
Μεταβλητές: Username, Password, Originator, Mobile, Body, smsDate Originator: O αποστολέας του μηνύματος (αλφαριθμητικό μέχρι 11 χαρακτήρες) Mobile: Oι παραλήπτες του μηνύματος (αριθμητικό υποχρεωτικά με πρόθεμα χώρας π.χ. 30 για Ελλάδα ) *οι παραλήπτες θα πρέπει να είναι χωρισμένοι με κόμμα (,) Body: To μήνυμα (μέχρι 160 χαρακτήρες) smsDate: Ημερομηνία και ώρα αποστολής του μηνύματος. - σε περίπτωση που δεν σταλεί η μεταβλητή το μήνυμα θα αποστολή άμεσα. - yyyy-mm-dd HH:mm:ss)
Υποχρεωτικά Πεδία: Username, Password, Originator, Mobile, Body
Προαιρετικά Πεδία: smsDate
Επιστρέφει: ΟΚ , αριθμός μηνυμάτων που εστάλησαν και λίστα με τον παραλήπτη και τον κωδικό αναφοράς για κάθε SMS
Μηνύματα Λάθους:
BAD USER (δεν βρέθηκε ο χρήστης με το συγκεκριμένο username και password) ERROR PASSWORD (δεν δόθηκε password) ERROR USERNAME (δεν δόθηκε username) ERROR ORIGINATOR (δεν δόθηκε αποστολές μηνύματος) ERROR Mobile (δεν δόθηκε παραλήπτης) ERROR BODY (δεν δόθηκε περιεχόμενο μηνύματος) NOT ENOUGH CREDITS (Ο πελάτης δεν έχει αρκετά χρήματα στο λογαριασμό του) EXEPTION ERROR (παρουσιάστηκε πρόβλημα κατά την αποστολή παρακαλώ δοκιμάστε ξανά.) WRONG NUMBER (Ο αριθμός παραλήπτη που δόθηκε δεν ήταν σωστός) NO CREDITS (Ο πελάτης δεν έχει χρήματα στο λογαριασμό του) BAD ORIGINATOR (ο αποστολές δεν είναι σωστός - πάνω απο 11 χαρακτήρες) BAD DATE (η ημερομηνία που δόθηκε στο πεδίο smsDate δεν έχει τη σωστή μορφή - yyyy-mm-dd HH:mm:ss) ----
Παράδειγμα:
Request
https://webservice.smsme.gr/SendSmsRequest.aspx?Username=user&Password=passwd&Originator=test&Mobile=306912345678&Body=this%20is%20a%20test
Response
ReportID: 12345
