SMS API Διασύνδεσης Εξωτερικών Web Εφαρμογών
Αποστολή SMS από εξωτερικές εφαρμογές, μέσω του gateway του bestsms.gr

H bestsms.gr προσφέρει σε ανεξάρτητες web εφαρμογές τη δυνατότητα της μαζικής αποστολής sms μέσω του δικού της sms gateway.

Η υπηρεσία είναι ιδιαίτερα εύχρηστη και υποστηρίζει :



Οδηγίες Χρήσης του Bestsms.gr API

Αρχικά, θα πρέπει να εγγραφείτε ως μέλος στο bestsms.gr και να αγοράσετε μονάδες αποστολής μηνυμάτων (sms).

Για να κάνετε μία μαζική αποστολή sms, χρειάζεται να στείλετε ένα request στο url:



http://www.bestsms.gr/send_sms_api.php


Οι παράμετροι που πρέπει να στέλνετε είναι οι εξής :

username
Το όνομα χρήστη του λογαριασμού σας στο bestsms.gr

password
Ο κωδικός του λογαριασμού σας στο bestsms.gr

message
Το μήνυμα προς αποστολή urlencoded απαραίτητα.
Το μήνυμα μπορεί να έχει εώς 459 χαρακτήρες, αφού υποστηρίζονται αποστολές μεγάλου μήκους μηνυμάτων.

Συγκεκριμένα:
Εώς 160 χαρακτήρες : 1 sms
Από 160 εώς 306 χαρακτήρες : 2 sms
Από 306 εώς 459 χαρακτήρες : 3 sms

Δε χρειάζεται να 'σπάσετε' εσείς το μήνυμα σε περισσότερα requests για να κάνετε την αποστολή όταν έχει πολλούς χαρακτήρες. Η δική μας εφαρμογή το αναλαμβάνει αυτό.
Προσοχή στα ειδικά σύμβολα : Υπολογίζονται για 2 χαρακτήρες,ίσως και 3 χαρακτήρες

from
Το όνομα του αποστολέα του μηνύματος., urlencoded επίσης.
Θα πρέπει να αποτελείται εώς 11 χαρακτήρες. Διαφορετικά θα λάβετε κωδικό σφάλματος.
Αυτό, μπορείτε να το στείλετε και στα ελληνικά, αλλά θα πρέπει να γνωρίζετε ότι η εφαρμογή μας θα το μετατρέψει σε greeklish. Το όνομα του αποστολέα, δε θα πρέπει να περιέχει ειδικούς χαρακτήρες.

to
Ο αιθμός του κινητού του παραλήπτη του μηνύματος. Θα πρέπει να σταλεί με το πρόθεμα της χώρας από μπροστά , 30 για την Ελλάδα. π.χ 306912345789 .

Αν το μήνυμά σας προορίζεται για πολλούς παραλήπτες, δώστε στην παράμετρο αυτή ένα string που περιέχει όλους τους αριθμούς χωρισμένους με κόμμα.

π.χ to = '306912345789,306942345789,306972345789 '.


Το αρχείο από όπου θα κάνετε τις κλήσεις θα πρέπει να είναι κωδικοποιημένο σε UTF-8.

H bestsms θα απαντήσει στο request με έναν κωδικό που δηλώνει την κατάσταση της κλήσης σας


Κωδικός Επεξήγηση

1 =Δε δώσατε στοιχεία λογαριασμού (username και/ή password)
2 =Τα στοιχεία λογαριασμού (username, password)δεν αντιστοιχούν σε χρήστη του bestsms.gr
3 =Δεν έχετε δηλώσει αποστολέα (from)
4 =Δεν έχετε δηλώσει παραλήπτη (to)
5 =Δεν έχετε δηλώσει κείμενο μηνύματος (message)
6 =Το όνομα αποστολέα (from) είναι μεγαλύτερο των 11 χαρακτήρων
7 =Το όνομα αποστολέα περιλαμβάνει απαγορευμένους ειδικούς χαρακτήρες
8 =Δεν έχετε αρκετά credits για την αποστολή
9 =Υπήρξε σφάλμα στην αποστολή
Int
xxxxxxxxxx
=ΙD αποστολής
Η αποστολή ήταν επιτυχημένη και επιστρέφεται το ID της.


Παρακολούθηση κατάστασης μηνύματος

Για να δείτε την κατάσταση ενός σταλμένου sms, καλείτε το url:


http://www.bestsms.gr/sms_status_api.php


Οι παράμετροι που πρέπει να στέλνετε είναι οι εξής :

username
Το όνομα χρήστη του λογαριασμού σας στο bestsms.gr

password
Ο κωδικός του λογαριασμού σας στο bestsms.gr

sid
Το id της αποστολής

to
O παραλήπτης του μηνύματος

To bestsms.gr απαντά με έναν κωδικό που δηλώνει την κατάσταση του μηνύματος.


Κωδικός Επεξήγηση

-1 =Δε δώσατε στοιχεία λογαριασμού (username και/ή password)
-2 =Τα στοιχεία λογαριασμού (username, password)δεν αντιστοιχούν σε χρήστη του bestsms.gr
-0 =Σε αναμονή (Δεν έχει σταλεί ακόμη)
1 =Παραδόθηκε
2 =Απέτυχε
4 =Δρομολογήθηκε
8 =Εστάλει
16 =Απορρίφθηκε
-3 =Δε βρέθηκε μήνυμα με αυτά τα στοιχεία

Τα requests μπορεί να είναι είτε POST, είτε GET, συστήνουμε POST.



:: Best sms :: Μαζική αποστολή sms ( bulksms ) απο τον υπολογιστή σας μέσω Internet, με ενιαία χρέωση προς όλα τα δίκτυα Εύκολα γρήγορα και φθηνά. bulk sms, bulk mms