Αναζήτηση πληροφοριών δρομολόγησης

Ζητήστε πληροφορίες δρομολόγησης για έναν τηλεφωνικό αριθμό της Βόρειας Αμερικής. Χρησιμοποιήστε τις για να ερμηνεύσετε τα διαθέσιμα δεδομένα δρομολόγησης και παρόχου, όχι ως απόδειξη της ταυτότητας του συνδρομητή, της κυριότητας του αριθμού, της δυνατότητας επικοινωνίας μαζί του ή της διαθεσιμότητάς του για αγορά. Μια αναζήτηση μπορεί να χρεώσει τον λογαριασμό σας.

Αίτημα

Χρησιμοποιήστε τον ενεργοποιημένο λογαριασμό σας API και την επιτρεπόμενη διεύθυνση IP προέλευσης για αυτόν. Δώστε ολόκληρο τον αριθμό σε ψηφία, συμπεριλαμβανομένου του κωδικού χώρας 1. Το παράδειγμα χρησιμοποιεί μεταβλητές περιβάλλοντος και έναν πλασματικό αριθμό. Ο χειριστής δεν κανονικοποιεί τα σημεία στίξης· ελέγξτε την εγκυρότητα της εισόδου πριν από την υποβολή.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/lrn/12025550123

Απόκριση

Παρουσιάζονται μόνο επιλεγμένα πεδία για ενδεικτικούς σκοπούς· η διαθεσιμότητά τους εξαρτάται από την πηγή και τον τύπο του αριθμού.

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": {
    "lrn": "12025550123",
    "ocn": "0000",
    "local": 1,
    "ported": 0,
    "cost": "$0.00025"
  }
}

Η τυπική αναζήτηση μετατρέπει τα ονόματα των πεδίων που επιστρέφονται σε πεζά. Ανάλογα με την πηγή, ενδέχεται να υπάρχουν πεδία παρόχου, τιμολογιακού κέντρου, τοποθεσίας και δικαιοδοσίας. Η απόκριση δεν αποτελεί πλήρη εγγραφή συνδρομητή με σταθερή δομή. Η σημαία local μπορεί να έχει την αριθμητική τιμή 1 ή την τιμή συμβολοσειράς 0. Ο χειριστής υπολογίζει το ported συγκρίνοντας τον αριθμό δρομολόγησης που επιστρέφεται με τον τηλεφωνικό αριθμό που δόθηκε· μην το ερμηνεύετε ως επαληθευμένο πλήρες ιστορικό φορητότητας.

Τιμή και επαναλήψεις αιτημάτων

Ο χειριστής που εξετάστηκε χρεώνει τον λογαριασμό με $0.00025 όταν φτάνει στη διαδρομή ολοκλήρωσης και καταγράφει την αναζήτηση. Το κόστος που επιστρέφεται είναι συνήθως μια συμβολοσειρά που περιλαμβάνει το σύμβολο του δολαρίου, αντί για ένα απλό αριθμητικό ποσό. Δεν παρέχεται κλειδί ιδιοδυναμίας. Η επανάληψη ενός αιτήματος μπορεί να επιφέρει επιπλέον χρέωση.

Για τους προπληρωμένους λογαριασμούς, ο κώδικας ελέγχει αν το υπόλοιπο είναι τουλάχιστον 0.00025. Το μήνυμα ανεπαρκούς υπολοίπου αναφέρει επί του παρόντος $5, ποσό που δεν αντιστοιχεί σε αυτό το όριο. Ερμηνεύστε την αποτυχία ως απόρριψη λόγω υπολοίπου και επιβεβαιώστε τα διαθέσιμα χρήματα στον λογαριασμό πριν δοκιμάσετε ξανά.

Αποτυχίες και ελλιπής επιτυχία

Ελέγξτε τόσο την κατάσταση HTTP όσο και τα πεδία status.code/status.msg του JSON. Ένα κενό αποτέλεσμα τυπικής αναζήτησης επιστρέφει τον κωδικό API 404. Ο κωδικός API 403 μπορεί να υποδηλώνει ανεπαρκές προπληρωμένο υπόλοιπο.

Μια υφιστάμενη διαδρομή σφάλματος για αριθμούς δωρεάν κλήσης μπορεί παρ' όλα αυτά να χρεώσει το ποσό της αναζήτησης και να αναφέρει τον κωδικό API 200 χωρίς χρήσιμα πεδία δρομολόγησης· τα στοιχεία κόστους της ενδέχεται να είναι ελλιπή. Επομένως, ο κωδικός 200 από μόνος του δεν επιβεβαιώνει ότι η αναζήτηση είναι αξιοποιήσιμη. Ελέγξτε την εγκυρότητα των πεδίων που χρειάζεται η εφαρμογή σας, αντιπαραβάλετε τις αβέβαιες χρεώσεις με τα αρχεία χρέωσης του λογαριασμού και επικοινωνήστε με την υποστήριξη για ελλιπή αποτελέσματα.

Στην υλοποίηση που εξετάστηκε, ο χειρισμός των αριθμών δωρεάν κλήσης διαφέρει ανάλογα με το μήκος της εισόδου. Προτιμήστε ολόκληρο τον αριθμό σε ψηφία με διεθνή μορφή και επιβεβαιώστε με την υποστήριξη την απαιτούμενη κάλυψη αριθμών δωρεάν κλήσης. Μην επαναλαμβάνετε αυτόματα το αίτημα όταν το αποτέλεσμα έχει εσφαλμένη μορφή ή είναι ελλιπές και μη βασίζεστε σε μια αναζήτηση δρομολόγησης για να αποφασίσετε ότι η κλήση προς έναν αριθμό είναι ασφαλής ή επιτρέπεται.