Τεκμηρίωση REST API
REST API για SMS και MMS
Στείλτε εγκεκριμένα μηνύματα εφαρμογής και διαχειριστείτε την αποδοχή, τα συμβάντα παράδοσης, την τμηματοποίηση και τις χρεώσεις.
Επιλέξτε το API και το διαπιστευτήριο μαζί
Οι εγκεκριμένοι λογαριασμοί για Προγραμματιστές & Αυτοματισμό, Επιχειρήσεις και Παρόχους επικοινωνιών μπορούν να ενσωματώσουν ενεργοποιημένες υπηρεσίες. Ένας μεμονωμένος προγραμματιστής δεν χρειάζεται να προσποιείται ότι είναι εταιρεία. Τα SMS/MMS εφαρμογών απαιτούν την αντίστοιχη έγκριση αποστολής και εγγραφή. Η υπηρεσία για Ιδιώτες & οικογένειες δεν παρέχει API έναρξης αποστολής μηνυμάτων προσβάσιμο στους πελάτες.
| Οικογένεια API | Βασική διεύθυνση URL | Έλεγχος ταυτότητας και αποτέλεσμα |
|---|---|---|
| Επικοινωνίες v3 | https://api.multitel.net/v3 | Εγκεκριμένα διαπιστευτήρια Basic· μόνο επιλέξιμα παρεχόμενα διακριτικά για λειτουργίες που τα υποστηρίζουν. JSON status και response. |
| Καταχώριση έκτακτης ανάγκης | https://api.multi.tel/emergency | Εγκεκριμένα διαπιστευτήρια Basic ή ειδικά παρεχόμενη πρόσβαση bearer. JSON code, message και data. |
| Ενοποιήσεις REST της πύλης | Ο κεντρικός υπολογιστής και η λειτουργία εμφανίζονται στην αναφορά προγραμματιστή του λογαριασμού σας | Χρησιμοποιήστε το τεκμηριωμένο διαπιστευτήριο, τα πεδία εφαρμογής και το σχήμα αυτής της λειτουργίας. Τα αιτήματα συνεδρίας προγράμματος περιήγησης αποτελούν ξεχωριστή επιφάνεια. |
Ορίστε τα MULTITEL_API_USERNAME και MULTITEL_API_PASSWORD μέσω της διαμόρφωσης μυστικών του διακομιστή σας πριν χρησιμοποιήσετε τα παραδείγματα. Μην τα ενσωματώνετε ποτέ σε δημόσια JavaScript προγράμματος περιήγησης, διευθύνσεις URL ή έλεγχο πηγαίου κώδικα. Τα ειδικά διαπιστευτήρια διαχειρίζονται στις ρυθμίσεις ενοποίησης API.
Προετοιμάστε ένα αίτημα SMS
Χρησιμοποιήστε εγκεκριμένο αριθμό αποστολής με δυνατότητα SMS που ανήκει στον λογαριασμό, παραλήπτη που έχει συναινέσει στο μήνυμα και την απαιτούμενη επαλήθευση επωνυμίας/καμπάνιας ή αριθμού δωρεάν κλήσης. Το παρακάτω παράδειγμα στέλνει πραγματικό μήνυμα όταν συμπληρωθεί με έγκυρα διαπιστευτήρια και αριθμούς· δεν είναι περιβάλλον δοκιμών.
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
--request POST \
--header "Content-Type: application/json" \
--data '{"from":"YOUR_APPROVED_NUMBER","to":"YOUR_CONSENTED_RECIPIENT","text":"Your requested update is ready."}' \
"https://api.multitel.net/v3/sendsms"Αντικαταστήστε τα σύμβολα κράτησης θέσης αποστολέα και παραλήπτη με διεθνή ψηφία συμπεριλαμβανομένου του κωδικού χώρας. Για MMS, δώστε την υποστηριζόμενη δημόσια ανακτήσιμη διεύθυνση URL μέσου στο media και επαληθεύστε πρώτα την επιλεξιμότητα και την τιμολόγηση MMS.
Η αποδοχή δεν είναι παράδοση
Ελέγξτε τόσο την εξωτερική κατάσταση εφαρμογής όσο και το επιστρεφόμενο αποτέλεσμα μηνυμάτων. Καταγράψτε το αναγνωριστικό μηνύματος που παρέχει η υπηρεσία και παρακολουθήστε την κατάσταση παράδοσης και τα γεγονότα webhook. Μια επιτυχής υποβολή δεν μπορεί να αποδείξει ότι η συσκευή του παραλήπτη έλαβε το μήνυμα.
Η χρέωση SMS γίνεται ανά τμήμα. Η κωδικοποίηση και το μήκος του μηνύματος μπορεί να δημιουργήσουν πολλά τμήματα· οι χρεώσεις μέσων και οι σχετικές με τον πάροχο μπορεί να διαφέρουν από τα SMS. Διαβάστε την τρέχουσα τιμή πώλησης του λογαριασμού πριν από την αποστολή. Μην επαναλαμβάνετε ποτέ τυφλά μια αποστολή που έληξε χρονικά: ελέγξτε πρώτα το καταγεγραμμένο αποτέλεσμά της.
Διαχείριση σφαλμάτων και επαναλήψεων
- Αποτυχία ελέγχου ταυτότητας ή δικαιωμάτων
- Ελέγξτε την κατάσταση ενεργοποίησης του διαπιστευτηρίου API, την επιτρεπόμενη υπηρεσία και τον περιορισμό IP προέλευσης. Ένα cookie συνεδρίας πύλης δεν αποτελεί διαπιστευτήριο ενοποίησης.
- Ανεπαρκές υπόλοιπο ή μη εκπληρωμένη έγκριση
- Τακτοποιήστε το υπόλοιπο του λογαριασμού, την έγκριση αποστολής ή την απαίτηση εγγράφων πριν επαναλάβετε τη λειτουργία.
- Χωρίς αποτέλεσμα
- Διαχειριστείτε το κενό απόθεμα ή ένα όνομα καλούντος που λείπει ως συνηθισμένο αποτέλεσμα. Μην υποθέτετε ότι ένας συντακτικά έγκυρος αριθμός διαθέτει κάθε υπηρεσία.
- Λήξη χρονικού ορίου δικτύου ή αποτυχία υπηρεσίας
- Για αναγνώσεις, χρησιμοποιήστε περιορισμένο αριθμό επαναλήψεων με σταδιακά αυξανόμενη καθυστέρηση. Για αγορά, αποστολή ή εγγραφή, ελέγξτε πρώτα την κατάσταση της λειτουργίας· η επανάληψη ενός αποδεκτού αιτήματος μπορεί να διπλασιάσει μια χρεώσιμη ενέργεια.
Η υποστήριξη ταυτοδυναμίας ανήκει σε κάθε οικογένεια API. Το API έκτακτης ανάγκης υποστηρίζει κλειδιά επανάληψης· αυτό δεν καθιστά τα αυθαίρετα αιτήματα v3 ταυτοδύναμα. Διατηρήστε χρονικές σημάνσεις, επιστρεφόμενα αναγνωριστικά και ανωνυμοποιημένες αποκρίσεις για την υποστήριξη.
Συνεχίστε με την αναφορά του λογαριασμού σας
Η αναφορά μετά τη σύνδεση φιλτράρει τις λειτουργίες ανάλογα με τα δικαιώματά σας και τις ενεργοποιημένες υπηρεσίες. Χρησιμοποιήστε ακριβώς τον κεντρικό υπολογιστή (host), τον τύπο διαπιστευτηρίων, τα πεδία αιτήματος και το σχήμα απόκρισης που εμφανίζονται εκεί. Οι κονσόλες μπορούν να εκτελέσουν πραγματικές λειτουργίες, συμπεριλαμβανομένων αγορών και μηνυμάτων.