Τεκμηρίωση REST API
REST API αναζήτησης δρομολόγησης LRN
Αναζητήστε τον αριθμό δρομολόγησης και τις διαθέσιμες πληροφορίες φορέα για έναν τηλεφωνικό αριθμό της Βόρειας Αμερικής με σταθερή τιμή.
Επιλέξτε το 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.
Αναζητήστε έναν αριθμό
Το GET /v3/lrn/{number} δέχεται τον αριθμό προορισμού στη διαδρομή. Ένας προαιρετικός αριθμός προέλευσης μπορεί να δοθεί ως /v3/lrn/{number}/{ani} για πληροφορίες που εξαρτώνται από την προέλευση. Χρησιμοποιήστε βορειοαμερικανικά ψηφία με τον κωδικό χώρας όπου ισχύει· τα παραδείγματα χρησιμοποιούν δεσμευμένους φανταστικούς αριθμούς.
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/lrn/12025550123"curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/lrn/12025550123/12025550124"Η εκτέλεση αναζήτησης με έγκυρα διαπιστευτήρια είναι χρεώσιμη. Η τιμή είναι 0,00025 $ ανά αναζήτηση: 0,25 $ ανά 1.000 ή 250 $ ανά εκατομμύριο. Δεν υπάρχουν εκπτώσεις όγκου. Αυτή είναι αναζήτηση πληροφοριών δρομολόγησης· δεν πραγματοποιεί τηλεφωνική κλήση.
Διαβάστε το αποτέλεσμα
{
"status": {
"code": 200,
"msg": "Success"
},
"response": {
"lrn": "12025550123",
"ported": 0,
"ocn": "",
"lata": "",
"rc": "",
"cost": "$0.00025"
}
}Αυτό το επινοημένο παράδειγμα δείχνει μόνο τη μορφή της απόκρισης· δεν είναι μετρημένο αποτέλεσμα δρομολόγησης. Ελέγξτε το status.code πριν χρησιμοποιήσετε το response. Το πεδίο cost είναι συμβολοσειρά με πρόθεμα νομίσματος, όχι αριθμός JSON.
| Πεδίο | Σημασία |
|---|---|
lrn | Αριθμός δρομολόγησης τοποθεσίας που χρησιμοποιείται για την αναγνώριση του προορισμού δρομολόγησης. |
ported | Δείκτης φορητότητας που παρέχεται από αυτή την αναζήτηση: συνήθως 0 ή 1. Μην τον χρησιμοποιείτε ως απόδειξη ιδιοκτησίας ή επιλεξιμότητας υπηρεσίας. |
ocn | Αριθμός τηλεπικοινωνιακής εταιρείας (Operating Company Number), όταν παρέχεται. |
lata | Περιοχή Τοπικής Πρόσβασης και Μεταφοράς, όταν παρέχεται. |
rc | Κέντρο τιμολόγησης, όταν παρέχεται. |
city, state, lec, lectype, jurisdiction, local | Πρόσθετες λεπτομέρειες τοποθεσίας, παρόχου ή σχετικές με την προέλευση, όταν είναι διαθέσιμες. Μπορεί να απουσιάζουν ή να είναι κενές. |
Μην απαιτείτε να υπάρχουν όλα τα πεδία δρομολόγησης. Ειδικότερα, τα αποτελέσματα για αριθμούς δωρεάν κλήσης μπορεί να παραλείπουν λεπτομέρειες τοπικού κέντρου τιμολόγησης και κωδικού παρόχου. Ένα επιστρεφόμενο LRN δεν αποτελεί εγγύηση προσβασιμότητας σε πραγματικό χρόνο ούτε δοκιμή ποιότητας κλήσης.
Χρησιμοποιήστε τις αναζητήσεις στη ροή δρομολόγησής σας
- Επικυρώστε και κανονικοποιήστε τον ζητούμενο αριθμό πριν τον στείλετε.
- Ελέγξτε την κατάσταση HTTP και εφαρμογής. Διατηρήστε ανωνυμοποιημένο αρχείο του αριθμού, του χρόνου και του αποτελέσματος για αντιμετώπιση προβλημάτων.
- Χρησιμοποιήστε μόνο τα πεδία που αφορούν τον κανόνα δρομολόγησής σας και διαχειριστείτε ρητά τις τιμές που απουσιάζουν.
- Οριοθετήστε τις επαναλήψεις μετά από αβέβαιη απόκριση. Η επανάληψη μιας αναζήτησης μπορεί να προκαλέσει άλλη χρέωση· αυτό το τελικό σημείο δεν έχει τεκμηριωμένο κλειδί ταυτοδυναμίας.
Δείτε το προϊόν LRN και την ενιαία τιμολόγηση. Η δημόσια διαδρομή OpenAPI περιλαμβάνει τμήμα ANI· η αναπτυγμένη υλοποίηση LRN δέχεται επίσης το συντομότερο αίτημα χωρίς ANI. Το lrninfo είναι ξεχωριστή λειτουργία και δεν πρέπει να αντικαθιστά αυτό το τελικό σημείο.
Διαχείριση σφαλμάτων και επαναλήψεων
- Αποτυχία ελέγχου ταυτότητας ή δικαιωμάτων
- Ελέγξτε την κατάσταση ενεργοποίησης του διαπιστευτηρίου API, την επιτρεπόμενη υπηρεσία και τον περιορισμό IP προέλευσης. Ένα cookie συνεδρίας πύλης δεν αποτελεί διαπιστευτήριο ενοποίησης.
- Ανεπαρκές υπόλοιπο ή μη εκπληρωμένη έγκριση
- Τακτοποιήστε το υπόλοιπο του λογαριασμού, την έγκριση αποστολής ή την απαίτηση εγγράφων πριν επαναλάβετε τη λειτουργία.
- Χωρίς αποτέλεσμα
- Διαχειριστείτε το κενό απόθεμα ή ένα όνομα καλούντος που λείπει ως συνηθισμένο αποτέλεσμα. Μην υποθέτετε ότι ένας συντακτικά έγκυρος αριθμός διαθέτει κάθε υπηρεσία.
- Λήξη χρονικού ορίου δικτύου ή αποτυχία υπηρεσίας
- Για αναγνώσεις, χρησιμοποιήστε περιορισμένο αριθμό επαναλήψεων με σταδιακά αυξανόμενη καθυστέρηση. Για αγορά, αποστολή ή εγγραφή, ελέγξτε πρώτα την κατάσταση της λειτουργίας· η επανάληψη ενός αποδεκτού αιτήματος μπορεί να διπλασιάσει μια χρεώσιμη ενέργεια.
Η υποστήριξη ταυτοδυναμίας ανήκει σε κάθε οικογένεια API. Το API έκτακτης ανάγκης υποστηρίζει κλειδιά επανάληψης· αυτό δεν καθιστά τα αυθαίρετα αιτήματα v3 ταυτοδύναμα. Διατηρήστε χρονικές σημάνσεις, επιστρεφόμενα αναγνωριστικά και ανωνυμοποιημένες αποκρίσεις για την υποστήριξη.
Συνεχίστε με την αναφορά του λογαριασμού σας
Η αναφορά μετά τη σύνδεση φιλτράρει τις λειτουργίες ανάλογα με τα δικαιώματά σας και τις ενεργοποιημένες υπηρεσίες. Χρησιμοποιήστε ακριβώς τον κεντρικό υπολογιστή (host), τον τύπο διαπιστευτηρίων, τα πεδία αιτήματος και το σχήμα απόκρισης που εμφανίζονται εκεί. Οι κονσόλες μπορούν να εκτελέσουν πραγματικές λειτουργίες, συμπεριλαμβανομένων αγορών και μηνυμάτων.