Τεκμηρίωση REST API
REST API τηλεφωνικών αριθμών
Ανακαλύψτε διαθέσιμες χώρες και αριθμούς, εξετάστε την πλήρη προσφορά και διαχειριστείτε τους αριθμούς που κατέχετε.
Επιλέξτε το 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.
Διαβάστε τον διαθέσιμο κατάλογο χωρών
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/getcountries"Η απόκριση v3 περιέχει status και έναν πίνακα response. Οι εγγραφές χωρών περιλαμβάνουν isocode, name, countrycode, πληροφορίες δυνατοτήτων και next_function. Η διαθεσιμότητα εξαρτάται από τον λογαριασμό και το απόθεμα· μια χώρα δεν αποτελεί υπόσχεση ότι κάθε πρόθεμα ή τύπος αριθμού είναι διαθέσιμος.
{
"status": {
"code": 200,
"msg": "Results: 1"
},
"response": [
{
"countrycode": "1",
"name": "United States",
"description": "United States",
"isocode": "US",
"is_mobile": 0,
"sms_coverage": 1,
"latitude": "37.0902",
"longitude": "-95.7129",
"next_function": "v3/getareas/US"
}
]
}Από την ανακάλυψη στην ενεργοποίηση
- Επιλέξτε τη χώρα, την υποδιαίρεση όπου απαιτείται, την περιοχή και τον τύπο αριθμού χρησιμοποιώντας τις αντίστοιχες λειτουργίες γεωγραφίας.
- Διαβάστε τις τιμές εγκατάστασης, μηνιαίες και χρήσης, τα κανάλια, το περιλαμβανόμενο όριο και τις απαιτήσεις καταχώρισης του επιλεγμένου αριθμού.
- Υποβάλετε τα απαιτούμενα έγγραφα τελικού χρήστη και ελέγξτε την κατάστασή τους. Ένας αριθμός μπορεί να παραμείνει σε εκκρεμότητα μέχρι την έγκριση.
- Παραγγείλετε μία φορά με την ακριβή επιλογή αποθέματος/τιμής. Εάν η απόκριση είναι αβέβαιη, ελέγξτε το απόθεμά σας πριν υποβάλετε άλλη παραγγελία.
- Διαμορφώστε ανεξάρτητα τη δρομολόγηση φωνής και την παράδοση μηνυμάτων και, στη συνέχεια, δοκιμάστε την πλήρη προβλεπόμενη διαδρομή.
Διαχείριση σφαλμάτων και επαναλήψεων
- Αποτυχία ελέγχου ταυτότητας ή δικαιωμάτων
- Ελέγξτε την κατάσταση ενεργοποίησης του διαπιστευτηρίου API, την επιτρεπόμενη υπηρεσία και τον περιορισμό IP προέλευσης. Ένα cookie συνεδρίας πύλης δεν αποτελεί διαπιστευτήριο ενοποίησης.
- Ανεπαρκές υπόλοιπο ή μη εκπληρωμένη έγκριση
- Τακτοποιήστε το υπόλοιπο του λογαριασμού, την έγκριση αποστολής ή την απαίτηση εγγράφων πριν επαναλάβετε τη λειτουργία.
- Χωρίς αποτέλεσμα
- Διαχειριστείτε το κενό απόθεμα ή ένα όνομα καλούντος που λείπει ως συνηθισμένο αποτέλεσμα. Μην υποθέτετε ότι ένας συντακτικά έγκυρος αριθμός διαθέτει κάθε υπηρεσία.
- Λήξη χρονικού ορίου δικτύου ή αποτυχία υπηρεσίας
- Για αναγνώσεις, χρησιμοποιήστε περιορισμένο αριθμό επαναλήψεων με σταδιακά αυξανόμενη καθυστέρηση. Για αγορά, αποστολή ή εγγραφή, ελέγξτε πρώτα την κατάσταση της λειτουργίας· η επανάληψη ενός αποδεκτού αιτήματος μπορεί να διπλασιάσει μια χρεώσιμη ενέργεια.
Η υποστήριξη ταυτοδυναμίας ανήκει σε κάθε οικογένεια API. Το API έκτακτης ανάγκης υποστηρίζει κλειδιά επανάληψης· αυτό δεν καθιστά τα αυθαίρετα αιτήματα v3 ταυτοδύναμα. Διατηρήστε χρονικές σημάνσεις, επιστρεφόμενα αναγνωριστικά και ανωνυμοποιημένες αποκρίσεις για την υποστήριξη.
Συνεχίστε με την αναφορά του λογαριασμού σας
Η αναφορά μετά τη σύνδεση φιλτράρει τις λειτουργίες ανάλογα με τα δικαιώματά σας και τις ενεργοποιημένες υπηρεσίες. Χρησιμοποιήστε ακριβώς τον κεντρικό υπολογιστή (host), τον τύπο διαπιστευτηρίων, τα πεδία αιτήματος και το σχήμα απόκρισης που εμφανίζονται εκεί. Οι κονσόλες μπορούν να εκτελέσουν πραγματικές λειτουργίες, συμπεριλαμβανομένων αγορών και μηνυμάτων.