Τρόποι διασύνδεσης, παροχή ΑΡΙ για αποστολή SMS
Το iSMS.gr παρέχει αρκετούς τρόπους διασύνδεσης με τις εφαρμογές και τα websites σας.
Παρακάτω παραθέτουμε περισσότερες λεπτομέρειες και στοιχεία για το API που προσφέρουμε.
Για οποιαδήποτε διευκρίνηση, μη διστάσετε να επικοινωνήσετε μαζί μας.
Έλεγχος διαθέσιμων credits
SMS API για έλεγχο διαθέσιμου υπολοίπου
Κάνετε μια κλήση στο παρακάτω URL:
http://cp.isms.gr/api/http/credits.php
Οι παράμετροι για αυτό το request είναι:
- username (απαιτείται), το όνομα χρήστη
- password (απαιτείται), ο κωδικός χρήστη ή key (απαιτείται), API Key χρήστη
Παράδειγμα ενός 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 (απαιτείται), ο κωδικός χρήστη ή key (απαιτείται), API Key χρήστη
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 (απαιτείται), ο κωδικός χρήστη ή key (απαιτείται), API Key χρήστη
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.
SMPP API
Η SMPP διασύνδεση προσφέρεται σε μεταπωλητές που πραγματοποιούν μεγάλο μηνιαίο όγκο αποστολών sms και απαιτούν τη μέγιστη ταχύτητα.
- Υποστηρίζει ελληνικό, αραβικό, ρώσσικο κείμενο
- Υποστηρίζει flash μηνύματα.
- Υποστήριξη ενοποιημένων μηνυμάτων (πολλά μηνύματα ενωμένα σε ένα)
- Ιδανικό για μαζική αποστολή μηνυμάτων SMS
- Δυνατότητα ορισμού ταυτότητας αποστολέα
- Παροχή αναφορών παράδοσης σε πραγματικό χρόνο
- Εύκολο στη χρήση (SMPP 3.4 protocol)
- Υποστήριξη 700 SMS ανά δευτερόλεπτο για κάθε λογαριασμό.
Πως να συνδεθείτε μέσω SMPP
Επικοινωνήστε μαζί μας για να σας ανοίξουμε ένα λογαριασμό
API για διαχείριση επαφών κινητών τηλεφώνων
Για να προσθέσετε/διαγράψετε ή να συγχρονίσετε τις επαφές σας με το λογαριασμό σας στο isms.gr παρέχουμε το παρακάτω ΑΡΙ.
Προσθήκη επαφών
Κάνετε μια κλήση στο παρακάτω URL:
http://cp.isms.gr/api/http/savecontact.php
Οι παράμετροι για αυτό το request είναι:
username (απαιτείται), το όνομα χρήστη
password (απαιτείται), ο κωδικός χρήστη ή key (απαιτείται), API Key χρήστη
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 (απαιτείται), ο κωδικός χρήστη ή key (απαιτείται), API Key χρήστη
mobile (απαιτείται), το τηλέφωνο της επαφής
Παράδειγμα ενός request:
Το request αυτό μπορεί να επιστρέψει τα εξής μηνύματα:
Επιτυχία (success):
ΟΚ
Μηνύματα λάθους:
Error: Authentication error.
Error: Mobile number is empty.
Error: Invalid mobile number.
FAILED