Τρόποι διασύνδεσης, παροχή ΑΡΙ για αποστολή SMS

Έλεγχος διαθέσιμων 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.

• Υποστηρίζει κείμενο, UTF-8 και flash μηνύματα
• Υποστηρίζει όλες τις γλώσσες με ειδικούς χαρακτήρες (Αραβικά, Ελληνικά, Κινέζικα κ.λπ.)
• Υποστήριξη ενοποιημένων μηνυμάτων (concatenated, long SMS)
• Υποστήριξη μαζικών αποστολών
• Δυνατότητα ορισμού ταυτότητας αποστολέα
• Αναφορές
• Εύκολο στη χρήση

Πώς να συνδεθείτε μέσω HTTP

Ανοίξτε έναν λογαριασμό από εδώ. Χρησιμοποιήστε τα δωρεάν 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:
http://cp.isms.gr/api/http/send.php?username=xxx&password=xxx&from=myself&message=text+at+utf8+format&to=306912345678,306998765432

Κάθε επιτυχής κλήση επιστρέφει ένα ID
π.χ. ID:I7I5R4HTAA — το αναγνωριστικό του μηνύματος

Μηνύματα λάθους:

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.

Έλεγχος κατάστασης απεσταλμένου μηνύματος

GET request στο:

http://cp.isms.gr/api/http/query.php

Παράμετροι:

• username (απαιτείται), το όνομα χρήστη
• password (απαιτείται), ο κωδικός χρήστη ή key (απαιτείται), API Key χρήστη
• mid (απαιτείται), το αναγνωριστικό του μηνύματος
• mobile (απαιτείται), το τηλέφωνο του παραλήπτη

Όλες οι τιμές πρέπει να είναι URL encoded.

Παράδειγμα:
http://cp.isms.gr/api/http/query.php?username=xxx&password=xxx&mid=0008FABD&mobile=306912345678

Πιθανές καταστάσεις:
Status: Queued
Status: Pending
Status: Delivered
Status: Failed

Μηνύματα λάθους:
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 παρέχουμε το παρακάτω API.

Προσθήκη επαφών

URL:
http://cp.isms.gr/api/http/savecontact.php

Παράμετροι:

• username (απαιτείται), το όνομα χρήστη
• password (απαιτείται), ο κωδικός χρήστη ή key (απαιτείται), API Key χρήστη
• surname (απαιτείται), το επίθετο της επαφής
• name (απαιτείται), το όνομα της επαφής
• mobile (απαιτείται), το τηλέφωνο της επαφής
• comments (απαιτείται), σχόλια για την επαφή

Παράδειγμα:
http://cp.isms.gr/api/http/savecontact.php?username=USERNAME&password=PASSWORD&surname=SURNAME&name=NAME&mobile=MOBILE&comments=COMMENTS

Επιτυχία: OK

Μηνύματα λάθους:
Error: Authentication error.
Error: Mobile number is empty.
Error: Invalid mobile number.
FAILED

Διαγραφή επαφών

URL:
http://cp.isms.gr/api/http/deletecontact.php

Παράμετροι:

• username (απαιτείται), το όνομα χρήστη
• password (απαιτείται), ο κωδικός χρήστη ή key (απαιτείται), API Key χρήστη
• mobile (απαιτείται), το τηλέφωνο της επαφής

Παράδειγμα:
http://cp.isms.gr/api/http/deletecontact.php?username=USERNAME&password=PASSWORD&mobile=MOBILE

Επιτυχία: OK

Μηνύματα λάθους:
Error: Authentication error.
Error: Mobile number is empty.
Error: Invalid mobile number.
FAILED