Στη σελίδα αυτή περιγράφονται όλες οι διαθέσιμες λειτουργίες που παρέχονται για την επικοινωνία με το sms gateway.
To HTTP API σας επιτρέπει να προσθέσετε εύκολα στις εφαρμογές σας την δυνατότητα αποστολής SMS χρησιμοποιώντας το πρωτόκολλο HTTP. Για την ακρίβεια χρησιμοποιείται αποκλειστικά το HTTPS πρωτόκολλο για απόλυτη ασφάλεια στην επικοινωνία.
Γενικά
Το πρόγραμμα κάνει μια HTTP GET κλήση στο easysms HTTP interface παρέχοντας την λίστα με τις απαραίτητες παραμέτρους. Το easysms απαντάει στην κλήση όπως περιγράφεται στη συνέχεια
Σημειώστε οτι ο διαχωριστικός χαρακτήρας στα επιστρεφόμενα δεδομένα είναι η κάθετος, '|', (ASCII 124). Όλες οι κλήσεις θα πρέπει να είναι URL-encoded.
Ακολουθεί περιγραφή των διαθέσιμων εντολών.
Αποστολή SMS
URL: https://www.net2sms.gr/srvauth/index?cmd=easysms&action=send_sms
Παράμετροι
| Παράμετρος | Περιγραφή | Παρουσία |
|---|---|---|
text |
Κείμενο του μηνύματος. Πρέπει να είναι URL encoded. | Υποχρεωτικό |
mobile_number |
Αριθμός κινητού τηλεφώνου του παραλήπτη του μηνύματος. Πχ: 306944777888 | Υποχρεωτικό |
originator |
Αποστολέας του μηνύματος (για αλφαριθμητικούς μέχρι 11 χαρακτήρες, για αριθμητικούς μέχρι 16 ψηφία. Για αποστολή σε Ελληνικά δίκτυα επιτρέπονται μόνο οι αλφαριθμητικοί αποστολείς) | Προαιρετικό |
flash |
True για αποστολή Flash sms | Προαιρετικό |
request_delivery |
True για αναφορά παράδοσης του μηνύματος | Προαιρετικό |
Επιστρέφει
κωδικός κατάστασης | κωδικός sms | υπόλοιπο λογαριασμού
| Περιγραφή | |
|---|---|
κωδικός κατάστασης |
1 για επιτυχημένη αποστολή, διαφορετικά η αποστολή απέτυχε |
κωδικός sms |
ο κωδικός του μηνύματος, οι αναφορές παράδοσης δίνονται με βάση αυτόν |
υπόλοιπο λογαριασμού |
το υπόλοιπο του λογαριασμού |
Παράδειγμα αποστολής SMS
Για να στείλετε 'Hello World' στον αριθμό '49175123456' με αποστολέα 'MyCompany' θα πρέπει να κάνετε την κλήση:
https://www.net2sms.gr/srvauth/index?cmd=easysms&action=send_sms&text=Hello%20World&mobile_number=49175123456&originator=MyCompany
Το gateway θα απαντήσει στην κλήση κάπως έτσι:
1|456123789|112
Το οποίο μεταφράζεται σε το μήνυμα στάλθηκε επιτυχώς με κωδικό 456123789 και το υπόλοιπο του λογαριασμού είναι 112