Μετάβαση σε: πλοήγηση, αναζήτηση

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