Αναζήτηση ονόματος καλούντος

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

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

Αίτημα

Χρησιμοποιήστε τον ενεργοποιημένο λογαριασμό σας API από την επιτρεπόμενη διεύθυνση IP προέλευσης. Φυλάσσετε τα διαπιστευτήρια σε χώρο αποθήκευσης μυστικών στον διακομιστή. Το παράδειγμα χρησιμοποιεί μεταβλητές περιβάλλοντος και έναν πλασματικό αριθμό Βόρειας Αμερικής· μην τοποθετείτε διαπιστευτήρια σε URL ή σε δημόσια προσβάσιμο κώδικα του προγράμματος περιήγησης.

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

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

Απόκριση

Οι τιμές είναι μόνο ενδεικτικές· το κόστος δεν αποτελεί προσφορά τιμής.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550123",
    "name": "EXAMPLE NAME",
    "cost": 0.0037,
    "balance": 9.9963
  }
}

Πεδία αναζήτησης ονόματος καλούντος
Πεδίο	Σημασία
number	Ο αριθμός που ζητήθηκε.
name	Το διαθέσιμο όνομα ή το εναλλακτικό κείμενο. Δεν αποτελεί επαλήθευση ταυτότητας.
cost	Η τιμή αναζήτησης που έχει ρυθμιστεί για τον λογαριασμό ή την υπηρεσία και αναφέρεται από αυτή τη διαδρομή εκτέλεσης. Χρησιμοποιήστε την τρέχουσα χρέωση του λογαριασμού, όχι την ενδεικτική τιμή.
balance	Το υπόλοιπο που υπολογίστηκε για την απόκριση. Δεν αποτελεί νέα συναλλακτική αναζήτηση του υπολοίπου του λογαριασμού.

Χρεώσεις και συμφωνία στοιχείων

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

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

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

Σφάλματα και επαναλήψεις προσπαθειών

Ελέγξτε τόσο την κατάσταση HTTP όσο και το status.code/status.msg στην απόκριση JSON. Ο κωδικός API 403 μπορεί να σημαίνει ανεπαρκές προπληρωμένο υπόλοιπο, απαγόρευση αγορών, πρόβλημα εξουσιοδότησης του λογαριασμού ή ότι δεν βρέθηκε όνομα καλούντος. Η διαδρομή χωρίς όνομα μπορεί να επιστρέψει τον κωδικό ως συμβολοσειρά. Εξετάστε το μήνυμα αντί να θεωρείτε κάθε 403 ένδειξη λανθασμένων διαπιστευτηρίων. Οι διενέξεις ρυθμίσεων ενδέχεται να επιστρέψουν κωδικό API 500.

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

Άλλες λειτουργίες αριθμών

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