Δημιουργια λογαριασμου
Για να ξεκινήσετε να χρησιμοποιείτε την υπηρεσία θα χρειαστεί να δημιουργήσετε ένα δωρεάν λογαριασμό. Θα είναι έτοιμος αμέσως και θα πιστωθεί με 5 μηνύματα για να δοκιμάσετε την ποιότητα της υπηρεσίας.
IP whitelist για το API
Η χρήση του IP Whitelist συνίσταται για την προστασία του λογαριασμού και των δεδομένων του. Όλοι οι λογαριασμοί έχουν ενεργοποιημένη την IP Whitelist και για την χρήση του API χρειάζεται να προστεθεί η διεύθυνση IP στην λίστα αυτή. Εναλλακτικά μπορείτε να απενεργοποιήσετε την προστασία αυτή από τις Ρυθμίσεις Ασφάλειας του λογαριασμού σας. Όταν είναι ενεργοποιημένη το API επιτρέπει κλήσεις μόνο απο τις συγκεκριμένες IP διευθύνσεις. Σε κάθε άλλη περίπτωση επιστρέφει σφάλμα λάθους στοιχείων σύνδεσης.
Αυθεντικοποιηση
Γίνεται με την χρήση του API key του κάθε λογαριασμού. Μοναδική εξαίρεση η κλήση για τον έλεγχο εγκυρότητας τηλεφώνου api/mobile/check
που είναι ελεύθερη για όλους. Το κλειδί μπορεί να ανανεωθεί με την κλήση api/key/reset
για αυξημένη ασφάλεια.
Δείτε την επίδειξη του SMS API ως "demo" χρήστης
ή εισάγετε το email και τον κωδικό σας
Αυτή είναι η 3η έκδοση του SMS API και είναι υπερσύνολο των προηγούμενων εκδόσεων, οπότε είναι συμβατή τόσο με την 2η έκδοση όσο και με την v.1
- Όλες οι κλήσεις του API μπορούν να γίνονται μέσω https ή http
- Οι παράμετροι μπορούν να στέλνονται με τις μεθόδους GET ή POST
- Χρησιμοποιείται κωδικοποίση UTF-8 για όλες τις κλήσεις
- Οι αριθμοί κινητών τηλεφώνων μορφοποιούνται και αποθηκεύονται σε MSISDN μορφή
api/mobile
Ο έλεγχος αριθμού κινητού τηλεφώνου api/mobile/check
είναι η μόνη κλήση που δεν απαιτεί αυθεντικοποίηση με κλειδί λογαριασμού key
. Είναι ελεύθερη για χρήση από όλους, πολύ αποτελεσματική και γρήγορη. Μπορεί να ελέγξει δεκάδες χιλιάδες τηλέφωνα σε λιγότερο από 1 δευτερόλεπτο
api/mobile/check
api/key
Κλήσεις get
και reset
για ανάκτηση και ανανέωση του API key
api/key/get
api/key/reset
api/sms
Οι πιο δημοφιλείς κλήσεις με διαφορά
- αποστολή απλού μηνύματος
- αποστολή ομαδικού μηνύματος
- προγραμματισμός αποστολής στο μέλλον
- ακύρωση προγραμματισμένης αποστολής
api/sms/bulk
api/sms/cancel
api/sms/send
api/viber
Κλήσεις send
και balance
για αποστολή Viber μηνύματος και ανάκτηση του υπολοίπου
api/viber/send
api/viber/bulk
api/viber/balance
api/me
Κλήσεις διαχείρισης του λογαριασμού
api/me/balance
api/2fa
Κλήσεις send
και check
για αυθεντικοποίηση 2 παραγόντων (2-Factor Authentication).
Είναι ο ίδιος μηχανισμός αυθεντικοποίησης που χρησιμοποιούν οι τράπεζες και βασίζεται στις αρχές:
α. Κάτι που ξέρεις (username, password) και
β. Κάτι που έχεις (κινητό)
api/2fa/send
api/2fa/check
api/contact
Οι κλήσεις api/contact/*
επιτρέπουν στις εφαρμογές σας πλήρη διαχείριση των επαφών των λογαριασμών και των υπο-λογαριασμών
api/contact/add
api/contact/delete
api/contact/get
api/contact/list
api/contact/update
api/group
Οι κλήσεις api/group/*
επιτρέπουν πλήρη διαχείριση των ομάδων επαφών του κάθε λογαριασμού και υπο-λογαριασμών
api/group/add
api/group/addContact
api/group/delete
api/group/deleteAllContacts
api/group/deleteContact
api/group/get
api/group/list
api/history
Δίνει πρόσβαση στο ιστορικό αποστολών κάθε λογαριασμού
api/history/group/list
api/history/single/list
api/hlr
Οι κλήσεις api/hlr/*
εκτελούν απ'ευθείας ερωτήσεις στα δίκτυα κινητής τηλεφωνίας για να επιστρέψουν πληροφορίες φορητότητας αριθμών (portability) ή/και τοποθεσίας (geo location) για κινητά τηλέφωνα.
Το HLR lookup (Home Location Register) είναι χρήσιμο για βελτιστοποίηση δρομολόγησης μηνυμάτων αλλά κυρίως για υπηρεσίες αυθεντικοποίησης και συντήρησης βάσεων δεδομένων.
Η κάθε κλήση της api/hlr/lookup
κοστίζει το 1/10 του μηνύματος, δηλαδή μόνο 0.0035€
api/hlr/lookup
Δέχεται παραμέτρους το API key του λογαριασμού και οποιοδήποτε κινητό τηλέφωνο για το οποίο θα γίνει η ερώτηση.
Η κάθε κλήση της api/hlr/lookup
κοστίζει το 1/10 ενός μηνύματος και αφαιρείται από την ιδιότητα hlrBalance
του λογαριασμού.
To hlrBalance
του κάθε λογαριασμού αρχικά είναι 0.
Μόλις κληθεί η api/hlr/lookup
ελέγχει αν το hlrBalance
είναι τουλάχιστον 1 και αν είναι 0 τότε αφαιρεί 1 SMS από το balance
του λογαριασμού και το μετατρέπει σε 10 hlrBalance
credits.
api/purchase
Δίνει πρόσβαση στο ιστορικό αγορών μηνυμάτων
api/purchase/list
api/status
Επιστρέφει την τρέχουσα κατάσταση των απεσταλμένων μηνυμάτων
api/status/get
api/status/sms
api/user
Διαχείριση λογαριασμού και υπο-λογαριασμών.
Περισσότερες κλήσης θα είναι διαθέσιμες σύντομα:
api/user/delete
api/user/email
api/user/emailAll
api/user/get
api/user/password
api/user/sms
api/user/smsAll
api/user/update
api/user/add
api/user/list
api/user/topup
api/user/comment
api/user/comment/add
api/user/comment/delete
myschool.sch.gr
Στο πεδίο 1. εισάγετε το κλειδί του λογαριασμού σας
Θα το βρείτε μόλις συνδεθείτε με τον λογαριασμό σας στην υπηρεσία
Στο πεδίο 2. εισάγετε τον αποστολέα των μηνυμάτων
Παράδειγμα έγκυρου αποστολέα 11 χαρακτήρων 1Gym-Lamias
Πρέπει να είναι μέχρι 11 λατινικούς χαρακτήρες χωρίς κενά
Επιτρέπονται μόνο τα σύμβολα + - . ! : ;
συν, πλην, τελεία, θαυμαστικό, άνω-κάτω τελεία, ερωτηματικό
api/user/comment/list
Επιστρέφει λίστα με όλα τα σχόλια ενός υπο-λογαριασμού
Απαιτείται IP Whitelist