Έλεγχος κάλυψης του πίνακα εκχωρήσεων
Ελέγξτε αν ένας αριθμός Βόρειας Αμερικής αντιστοιχεί σε κάποιο πρόθεμα στον πίνακα εκχωρήσεων της MultiTEL και ανακτήστε τη σχετική πόλη, πολιτεία και χώρα. Πρόκειται για αναζήτηση σε πίνακα προθεμάτων. Δεν επιβεβαιώνει ότι ένας συνδρομητής είναι ενεργός, ότι ένας αριθμός έχει αποδοθεί, ότι ανήκει στον λογαριασμό σας ή ότι μπορείτε να τον παραγγείλετε.
Αίτημα
Χρησιμοποιήστε τον ενεργοποιημένο λογαριασμό σας API και την επιτρεπόμενη διεύθυνση IP προέλευσης. Το παράδειγμα χρησιμοποιεί διαπιστευτήρια HTTP Basic από μεταβλητές περιβάλλοντος και έναν πλασματικό αριθμό. Δεν απαιτείται σώμα αιτήματος.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/nanpacheck/12025550123Προτιμήστε έναν ενδεκαψήφιο αριθμό Βόρειας Αμερικής που αρχίζει με 1. Ο κώδικας χειρισμού αφαιρεί τους χαρακτήρες που δεν είναι ψηφία και προσθέτει το 1 στην αρχή μιας δεκαψήφιας εισόδου. Οι είσοδοι με διαφορετικό πλήθος ψηφίων απορρίπτονται. Αυτή η κανονικοποίηση δεν ελέγχει όλους τους κανόνες αριθμοδότησης της Βόρειας Αμερικής, επομένως μια επιτυχής αντιστοίχιση στον πίνακα δεν αποτελεί εξαντλητική επαλήθευση αριθμού.
Απόκριση
Οι τιμές των πεδίων είναι μόνο ενδεικτικές· δεν πρόκειται για αποτέλεσμα από τον πίνακα εκχωρήσεων σε λειτουργία.
{
"status": {
"code": 200,
"msg": "12025550123"
},
"response": {
"number": "12025550123",
"npanxx": "1202555",
"city": "Example City",
"state": "DC",
"country": "US"
}
}| Πεδίο | Σημασία |
|---|---|
| number | Κανονικοποιημένη είσοδος που περιέχει μόνο ψηφία. |
| npanxx | Το αποθηκευμένο πρόθεμα που αντιστοιχεί στην είσοδο. Ο κώδικας χειρισμού προτιμά ένα επταψήφιο πρόθεμα χώρας/περιοχής/τηλεφωνικού κέντρου και μπορεί, εναλλακτικά, να χρησιμοποιήσει ένα τετραψήφιο πρόθεμα χώρας/περιοχής· μην θεωρείτε ότι αυτό το πεδίο προσδιορίζει πάντα πλήρως ένα τηλεφωνικό κέντρο. |
| city, state, country | Μεταδεδομένα για το πρόθεμα εκχώρησης που αντιστοιχίστηκε. Αυτά τα πεδία δεν προσδιορίζουν την τρέχουσα φυσική τοποθεσία ενός συνδρομητή ούτε τον τρέχοντα πάροχό του μετά από μεταφορά του αριθμού. |
Σφάλματα
Ελέγχετε το πεδίο status.code της απόκρισης JSON αντί να βασίζεστε μόνο στο HTTP 200. Ο κωδικός API 404 με μήνυμα Not part of NANPA σημαίνει ότι κανένα πρόθεμα δεν αντιστοιχίστηκε στον πίνακα που χρησιμοποιεί η υπηρεσία· δεν αποτελεί οριστική κρίση αρμόδιας αρχής αριθμοδότησης με παγκόσμια ισχύ. Ο κωδικός API 500 χρησιμοποιείται όταν το πλήθος ψηφίων δεν είναι έγκυρο ή όταν λείπει ο αριθμός.
Κόστος και επόμενα βήματα
Ο κώδικας χειρισμού που ελέγχθηκε εκτελεί ένα τοπικό ερώτημα στον πίνακα εκχωρήσεων και δεν περιλαμβάνει χρέωση λογαριασμού ή εξωτερική αναζήτηση. Δεν επιβάλλεται τέλος αναζήτησης από αυτόν τον κώδικα χειρισμού. Χρησιμοποιήστε την αναζήτηση διαθέσιμων αριθμών για να βρείτε διαθέσιμους αριθμούς που μπορούν να παραγγελθούν. Η αναζήτηση ονόματος, η αναζήτηση δρομολόγησης ή η παραγγελία αριθμού είναι διαφορετική λειτουργία, με τη δική της τιμολόγηση για τον λογαριασμό.