Ενσωμάτωση CNAM
Αναφορά CNAM REST API
Ζητήστε ένα όνομα καλούντος μέσω HTTPS και διαχειριστείτε το αποτέλεσμα, τη χρέωση και τα σφάλματα.
Επιλέξτε τη συμπεριφορά αναζήτησης
| Επίπεδο | Δημόσια τιμή ανά ερώτημα | Τι κάνει |
|---|---|---|
| Starter | 0,0026 $ | Χρησιμοποιεί ιδιόκτητες πληροφορίες ονομάτων καλούντων και πληροφορίες από την προσωρινή μνήμη (cache). |
| Standard | 0,0037 $ | Πραγματοποιεί αναζήτηση δικτύου σε πραγματικό χρόνο για κάθε ερώτημα. |
| Mixed | 0,004 $ | Δοκιμάζει πρώτα αναζήτηση σε πραγματικό χρόνο και, αν δεν βρεθεί όνομα, καταφεύγει σε δεδομένα Starter. |
Η υπηρεσία που επιλέγετε καθορίζει τη συμπεριφορά αναζήτησης· το Mixed δεν είναι αναζήτηση που ελέγχει πρώτα την προσωρινή μνήμη (cache). Ελέγξτε την τιμή που έχει ανατεθεί στον λογαριασμό σας πριν από τη χρήση σε παραγωγή. Το όνομα καλούντος δεν αποτελεί απόδειξη ταυτότητας ή ιδιοκτησίας.
Στείλτε μια αναζήτηση με έλεγχο ταυτότητας
Endpoint: GET https://api.multitel.net/v3/cnam/NUMBER. Χρησιμοποιήστε διεθνή ψηφία που περιλαμβάνουν τον κωδικό χώρας, χωρίς σημεία στίξης ή αρχικό σύμβολο συν. Εκτελέστε το από τον διακομιστή εφαρμογής σας χρησιμοποιώντας εγκεκριμένα διαπιστευτήρια API.
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/cnam/12025550123"Παρέχετε τις δύο μεταβλητές περιβάλλοντος μέσω ρύθμισης μυστικών στην πλευρά του διακομιστή. Ένα διαπιστευτήριο bearer που έχει παρασχεθεί αποτελεί εναλλακτική μόνο όταν αυτή η πρόσβαση είναι ενεργοποιημένη και πληρούνται οι περιορισμοί IP πηγής. Μην τοποθετείτε ποτέ μυστικό API σε δημόσιο πακέτο (bundle) προγράμματος περιήγησης.
Διαβάστε την απόκριση JSON
Αυτή η απόκριση είναι ενδεικτική. Το όνομα που επιστρέφεται και η χρέωση εξαρτώνται από την αναζήτηση και την επιλεγμένη υπηρεσία.
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"number": "12025550123",
"name": "EXAMPLE CALLER",
"cost": "0.004",
"balance": "24.9960"
}
}status.code- Κωδικός αποτελέσματος εφαρμογής· κανονικοποιήστε τις τιμές συμβολοσειράς/αριθμού πριν τις συγκρίνετε με το 200.
status.msg- Το συνοδευτικό μήνυμα αποτελέσματος ή απόρριψης.
response.number- Ο αριθμός που αναζητήθηκε.
response.name- Το διαθέσιμο όνομα καλούντος.
response.cost- Η χρέωση που αναφέρεται για αυτό το ερώτημα· αντιμετωπίστε την ως δεκαδικό ποσό.
response.balance- Το αναφερόμενο υπόλοιπο λογαριασμού, όταν υπάρχει.
Αποτελέσματα χωρίς όνομα και σφάλματα
Ένα επιτυχές αίτημα δεν εγγυάται χρήσιμο όνομα καλούντος. Διαχειριστείτε ένα κενό όνομα, έναν αριθμό που επιστρέφεται στη θέση ονόματος και μια απορριφθείσα αναζήτηση. Ο κωδικός εφαρμογής 403 μπορεί να περιγράφει ανεπαρκές υπόλοιπο, απαγορευμένη αγορά ή αριθμό χωρίς αποτέλεσμα· ελέγξτε το μήνυμα.
Ελέγξτε τόσο το HTTP status όσο και το status του JSON πριν αποκτήσετε πρόσβαση στο response.name. Το αντικείμενο απόκρισης μπορεί να λείπει σε περίπτωση σφάλματος. Ένα όνομα που λείπει δεν πρέπει να εμποδίζει τη δρομολόγηση της κανονικής κλήσης.
Χρέωση, επαναλήψεις και η διαφορά από την ενημέρωση του αναγνωριστικού καλούντος
Μια νέα αναζήτηση μπορεί να επιφέρει χρέωση ερωτήματος. Αυτές οι διεπαφές αναζήτησης δεν τεκμηριώνουν κλειδί idempotency, επομένως μια νέα επανάληψη μπορεί να αποτελεί δεύτερο χρεώσιμο ερώτημα. Χρησιμοποιήστε περιορισμένο backoff για αστοχίες μεταφοράς/υπηρεσίας, επιλύστε πρώτα τα σφάλματα λογαριασμού και αντιπαραβάλετε τις χρεώσεις ερωτημάτων που αναφέρονται. Αποθηκεύστε σε προσωρινή μνήμη μόνο για διάστημα κατάλληλο για την εφαρμογή σας· τα δεδομένα ονόματος καλούντος μπορούν να αλλάξουν.
Μια αναζήτηση CNAM διαβάζει ένα όνομα. Δεν αλλάζει το όνομα που εμφανίζεται στις εξερχόμενες κλήσεις σας. Μια ενημέρωση ονόματος καλούντος LIDB είναι ξεχωριστή λειτουργία με δικά της πεδία, εξουσιοδότηση, τιμή και επεξεργασία.