SOAP ΑΡΙ για αποστολή SMS
Το SOAP είναι ένα απλό πρωτόκολλο βασισμένο σε τεχνολογίες XML σχεδιασμένο να επιτρέπει την ανταλλαγή πληροφοριών μέσω ΗΤΤΡ.
Το SOAP παρέχει μια λύση για την επικοινωνία μεταξύ των εφαρμογών που εκτελούνται σε διαφορετικά λειτουργικά συστήματα, χρησιμοποιώντας διαφορετικές τεχνολογίες και γλώσσες προγραμματισμού.
- Υποστηρίζει κείμενο, UTF8 και flash μηνύματα.
- Υποστηρίζει όλες τις γλώσσες με ειδικούς χαρακτήρες (Αραβικά, Ελληνικά, Κινέζικα κτλ)
- Υποστήριξη ενοποιημένων μηνυμάτων (concatenated, long SMS)
- Υποστήριξη μαζικών αποστολών
- Δυνατότητα ορισμού ταυτότητας αποστολέα
- Αναφορές
- Εύκολο στη χρήση
Πως να συνδεθείτε μέσω SOAP
Ανοίξτε ένα λογαριασμό από εδώ. Χρησιμοποιήστε τα δωρεάν credits που σας προσφέρουμε για να πραγματοποιήσετε τις δοκιμές σας.
Το 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.
<?php
// create soap client
$client = new SoapClient('http://ez4usms.com/api/soap/sms.wsdl');
// create recipients container
$to = new stdClass();
// add recipients
$to->recipients = array('306991111111', '306941234567');
// send message
$ID = $client->send('username', 'password', 'sender', $to, 'Είμαι το soap API!', 'UTF-8', true);
// check delivery status for each recipient
foreach( $to->recipients as $index => $recipient )
{
echo $client->query('username', 'password', $ID, $recipient);
}
?>