Τρόποι διασύνδεσης, παροχή ΑΡΙ για αποστολή SMS
Το iSMS.gr παρέχει αρκετούς τρόπους διασύνδεσης με τις εφαρμογές και τα websites σας.
Παρακάτω παραθέτουμε περισσότερες λεπτομέρειες και στοιχεία για το API που προσφέρουμε.
Για οποιαδήποτε διευκρίνηση, μη διστάσετε να επικοινωνήσετε μαζί μας.
Έλεγχος διαθέσιμων credits
SMS API για έλεγχο διαθέσιμου υπολοίπου
Κάνετε μια κλήση στο παρακάτω URL:
http://cp.isms.gr/api/http/credits.php
Οι παράμετροι για αυτό το request είναι:
- username (απαιτείται), το όνομα χρήστη
- password (απαιτείται), ο κωδικός χρήστη
Παράδειγμα ενός request:
http://cp.isms.gr/api/http/credits.php?username=YourUSERNAME&password=YourPASSWORD
Το request αυτό μπορεί να επιστρέψει τα εξής μηνύματα:
Επιτυχία (success):
π.χ. Credits:3948.47
Errors:
Error: Authentication error.
HTTP API για αποστολή SMS
Ο πιο απλός και συνιθισμένος τρόπος διασύνδεσης για μαζική αποστολή SMS.
- Υποστηρίζει κείμενο, UTF8 και flash μηνύματα.
- Υποστηρίζει όλες τις γλώσσες με ειδικούς χαρακτήρες (Αραβικά, Ελληνικά, Κινέζικα κτλ)
- Υποστήριξη ενοποιημένων μηνυμάτων (concatenated, long SMS)
- Υποστήριξη μαζικών αποστολών
- Δυνατότητα ορισμού ταυτότητας αποστολέα
- Αναφορές
- Εύκολο στη χρήση
Πως να συνδεθείτε μέσω ΗΤΤΡ
Ανοίξτε ένα λογαριασμό απο εδώ. Χρησιμοποιήστε τα δωρεάν credits που σας προσφέρουμε για να πραγματοποιήσετε τις δοκιμές σας.
Προδιαγραφές HTTP API:
Για την αποστολή SMS χρειάζεται να γίνει ένα get request στο παρακάτω URL:
http://cp.isms.gr/api/http/send.php
Οι παράμετροι για αυτό το request είναι:
username (απαιτείται), το όνομα χρήστη
password (απαιτείται), ο κωδικός χρήστη
from (απαιτείται), η ταυτότητα αποστολέα του μηνύματος
to (απαιτείται), οι παραλήπτες του μηνύματος χωρισμένοι με κόμμα χωρίς κενά
message (προαιρετικό), το κείμενο του μηνύματος
coding (προαιρετικό), η κωδικοποίηση με την οποία θα σταλεί το μήνυμα. Δυνατές επιλογές: GSM, UTF-8. Προεπιλεγμένη μορφή: GSM.
flash (προαιρετικό), αν το μήνυμα θα είναι flash sms ή όχι. Δυνατές τιμές: 0 ή 1. Προεπιλεγμένη τιμή: 0.
Όλες οι τιμές των παραπάνω παραμέτρων θα πρέπει να είναι url encoded
Παράδειγμα ενός request:
Κάθε επιτυχής κλήση επιστρέφει ένα ID
π.χ. ID:I7I5R4HTAA Το αναγνωριστικό του μηνύματος αυτού
Το request αυτό μπορεί να επιστρέψει τα εξής μηνύματα λάθους:
Error: Authentication error.
Error: No recipients.
Error: Invalid sender identity.
Error: Insufficient credits.
Error: Invalid scheduling date.
Προγραμματισμός SMS μέσω HTTP API
Στο τελος της HTTP κλήσης σας προσθέστε την παράμετρο schedule:
πχ : &schedule=SCHEDULE_DATE_TIME
Παραδείγματα για το SCHEDULE_DATE_TIME:
2017-07-17
2017-05-11 14:40
2017-04-22 17:47:55
11 June 2017 11:00:00
+1 day
+1 week
+1 week 2 days 4 hours 2 seconds
next Thursday
last Monday
Εάν υπάρχει κάποιο λάθος στην παράμετρο schedule το σύστημα θα επιστρέψει:
Error: Invalid scheduling date.
Δηλώστε το URL στο οποίο θα σας επιστρέφει η αναφορά παράδοσης
Στο τελος της HTTP κλήσης σας προσθέστε την παράμετρο dlr-url
πχ : &dlr-url=ENCODED_URL
Η τιμή dlr-url θα πρέπει να είναι url encoded
Έλεγχος κατάστασης απεσταλμένου μηνύματος
Για τον έλεγχο της κατάστασης ενός μηνύματος χρειάζεται να γίνει ένα get request στο παρακάτω URL:
http://cp.isms.gr/api/http/query.php
Οι παράμετροι για αυτό το request είναι:
username (απαιτείται), το όνομα χρήστη
password (απαιτείται), ο κωδικός χρήστη
mid (απαιτείται), το αναγνωριστικό του ερωτήματος
mobile (απαιτείται), το τηλέφωνο του παραλήπτη
Όλες οι τιμές των παραπάνω παραμέτρων θα πρέπει να είναι url encoded
Παράδειγμα ενός request:
http://cp.isms.gr/api/http/query.php?username=xxx&password=xxx&mid=0008FABD&mobile=306912345678
Το request αυτό μπορεί να επιστρέψει τα εξής μηνύματα:
Status: Queued
Status: Pending
Status: Delivered
Status: Failed
Το request αυτό μπορεί να επιστρέψει τα εξής μηνύματα λάθους:
Error: Authentication error.
Error: No message ID defined.
Error: No mobile defined.
Error: No such message or recipient.
SOAP API για αποστολή SMS
SOAP ΑΡΙ για αποστολή SMS
Το SOAP είναι ένα απλό πρωτόκολλο βασισμένο σε τεχνολογίες XML σχεδιασμένο να επιτρέπει την ανταλλαγή πληροφοριών μέσω ΗΤΤΡ.
Το SOAP παρέχει μια λύση για την επικοινωνία μεταξύ των εφαρμογών που εκτελούνται σε διαφορετικά λειτουργικά συστήματα, χρησιμοποιώντας διαφορετικές τεχνολογίες και γλώσσες προγραμματισμού.
- Υποστηρίζει κείμενο, UTF8 και flash μηνύματα.
- Υποστηρίζει όλες τις γλώσσες με ειδικούς χαρακτήρες (Αραβικά, Ελληνικά, Κινέζικα κτλ)
- Υποστήριξη ενοποιημένων μηνυμάτων (concatenated, long SMS)
- Υποστήριξη μαζικών αποστολών
- Δυνατότητα ορισμού ταυτότητας αποστολέα
- Αναφορές
- Εύκολο στη χρήση
Πως να συνδεθείτε μέσω SOAP
Ανοίξτε ένα λογαριασμό από εδώ. Χρησιμοποιήστε τα δωρεάν credits που σας προσφέρουμε για να πραγματοποιήσετε τις δοκιμές σας.
Προδιαγραφές SOAP API:
Το SOAP API ορίζει δύο λειτουργίες:
Τη “send” για την αποστολή μηνυμάτων σε πολλαπλούς παραλήπτες
και
την“query” για την επερώτηση της κατάστασης παράδοσης ενός απεσταλμένου μηνύματος σε ένα παραλήπτη.
Η λειτουργία“send” δέχεται τις εξής παραμέτρους:
username (string), το όνομα χρήστη
password (string), ο κωδικός χρήστη
from (string), η ταυτότητα αποστολέα του μηνύματος
to (object), ο/οι παραλήπτης(ες)
coding (string), κωδικοποίηση με την οποία θα αποσταλλεί το μήνυμα. GSM, UTF-8.
flash (boolean), flash sms (true για flash SMS, false για κανονικό SMS)
Η παράμετρος “to” είναι ένα object με ένα property. Το property έχει αναγνωριστικό recipients και είναι ένας πίνακας από strings.
Η λειτουργία “send” επιστρέφει ένα αναγνωριστικό για το μήνυμα που έχει σταλεί.
Εμφανίζει τα εξής exceptions:
Authentication error.
No recipients.
Invalid sender identity.
Insufficient credits.
Η λειτουργία“query” δέχεται τις εξής παραμέτρους:
username: (string), το όνομα χρήστη
password: (string), ο κωδικός χρήστη
message_id: (string), το αναγνωριστικό του μηνύματος
mobile: (string), το κινητό τηλέφωνο του παραλήπτη
Η λειτουργία “query” επιστρέφει την κατάσταση παράδοσης του μηνύματος για τον παραλήπτη αυτό.
Οι πιθανές τιμές είναι:
Queued
Pending
Delivered
Failed
Εμφανίζει τα εξής exceptions:
Authentication error.
No message ID defined.
No mobile defined.
No such message or recipient.
SMPP API
Η SMPP διασύνδεση προσφέρεται σε μεταπωλητές που πραγματοποιούν μεγάλο μηνιαίο όγκο αποστολών sms και απαιτούν τη μέγιστη ταχύτητα.
- Υποστηρίζει ελληνικό, αραβικό, ρώσσικο κείμενο
- Υποστηρίζει flash μηνύματα.
- Υποστήριξη ενοποιημένων μηνυμάτων (πολλά μηνύματα ενωμένα σε ένα)
- Ιδανικό για μαζική αποστολή μηνυμάτων SMS
- Δυνατότητα ορισμού ταυτότητας αποστολέα
- Παροχή αναφορών παράδοσης σε πραγματικό χρόνο
- Εύκολο στη χρήση (SMPP 3.4 protocol)
- Υποστήριξη 700 SMS ανά δευτερόλεπτο για κάθε λογαριασμό.
Πως να συνδεθείτε μέσω SMPP
Επικοινωνήστε μαζί μας για να σας ανοίξουμε ένα λογαριασμό
API για έλεγχο εγκυρότητας τηλεφωνικών αριθμών και εύρεσης δικτύου αριθμού κινητού (HLR lookup API)
Για τον έλεγχο εγκυρότητας ενός αριθμού κινητού τηλεφώνου πρέπει να γίνει ένα request στο παρακάτω url:
http://cp.isms.gr/api/http/hlr.php
Οι παράμετροι για αυτό το request είναι:
username (απαιτείται), το όνομα χρήστη
password (απαιτείται), ο κωδικός χρήστη
mobiles (απαιτείται), οι αριθμοί τους οποίους θέλουμε να ελέγξουμε χωρισμένοι με κόμμα χωρίς κενά
Παράδειγμα ενός request:
http://cp.isms.gr/api/http/hlr.php?username=USERNAME&password=PASSWORD&mobiles=306949876543,306931234567,35712548796
Κάθε επιτυχής κλήση επιστρέφει ένα ID
π.χ. ID:0adgre1
Το request αυτό μπορεί να επιστρέψει τα εξής μηνύματα λάθους:
Error: Authentication error.
Error: No recipients.
Error: Insufficient credits.
Έλεγχος αποτελέσματος για εγκυρότητα αριθμού
Για τον έλεγχο του ερωτήματος πρέπει να γίνει μια κλήση στο:
http://cp.isms.gr/api/http/hlrquery.php
Οι παράμετροι για αυτό το request είναι:
username (απαιτείται), το όνομα χρήστη
password (απαιτείται), ο κωδικός χρήστη
mid (απαιτείται), το αναγνωριστικό του ερωτήματος
mobile (απαιτείται), ο αριθμός τον οποίο θέλουμε να ελέγξουμε
Παράδειγμα ενός request:
http://cp.isms.gr/api/http/hlrquery.php?username=USERNAME&password=PASSWORD&mid=MESSAGE_ID&mobile=306971234567
Κάθε κλήση επιστρέφει:
Queued
Pending
Failed
Delivered
Undelivered
Unknown
Αν το status είναι Pending ή Queued τότε επιστρέφει μόνο το status αλλιώς επιστρέφει:
Status;Country;Operator;IMSI;ServingMSC;ErrorCode
Το request αυτό μπορεί να επιστρέψει τα εξής μηνύματα λάθους:
Error: Authentication error.
Error: No message ID defined.
Error: No mobile defined.
Error: No such message ID or mobile.
API για διαχείριση επαφών κινητών τηλεφώνων
Για να προσθέσετε/διαγράψετε ή να συγχρονίσετε τις επαφές σας με το λογαριασμό σας στο isms.gr παρέχουμε το παρακάτω ΑΡΙ.
Προσθήκη επαφών
Κάνετε μια κλήση στο παρακάτω URL:
http://cp.isms.gr/api/http/savecontact.php
Οι παράμετροι για αυτό το request είναι:
username (απαιτείται), το όνομα χρήστη
password (απαιτείται), ο κωδικός χρήστη
surname (απαιτείται), το επίθετο της επαφής
name (απαιτείται), το όνομα της επαφής
mobile (απαιτείται), το τηλέφωνο της επαφής
comments (απαιτείται), σχόλια για την επαφή
Παράδειγμα ενός request:
Το request αυτό μπορεί να επιστρέψει τα εξής μηνύματα:
Επιτυχία (success):
ΟΚ
Μηνύματα λάθους:
Error: Authentication error.
Error: Mobile number is empty.
Error: Invalid mobile number.
FAILED
Διαγραφή επαφών
Κάνετε μια κλήση στο παρακάτω URL:
http://cp.isms.gr/api/http/deletecontact.php
Οι παράμετροι για αυτό το request είναι:
username (απαιτείται), το όνομα χρήστη
password (απαιτείται), ο κωδικός χρήστη
mobile (απαιτείται), το τηλέφωνο της επαφής
Παράδειγμα ενός request:
Το request αυτό μπορεί να επιστρέψει τα εξής μηνύματα:
Επιτυχία (success):
ΟΚ
Μηνύματα λάθους:
Error: Authentication error.
Error: Mobile number is empty.
Error: Invalid mobile number.
FAILED