Έλεγχος αποθέματος κινητής για ένα τηλεφωνικό κέντρο

Επιλέξτε ένα υποστηριζόμενο πρόθεμα

Χρησιμοποιήστε ένα τρέχον ατομικό πρόθεμα κινητής τηλεφωνίας από την ανακάλυψη. Αυτό το endpoint προορίζεται για τηλεφωνικά κέντρα NANPA: ένα NPA προσδιορίζει τον κωδικό περιοχής και ένα NXX προσδιορίζει το τηλεφωνικό κέντρο. Ένα πρόθεμα μόνο με κωδικό περιοχής είναι πολύ γενικό. Μην στέλνετε ομαδοποιημένα αναγνωριστικά εμφάνισης και μην συμπεραίνετε υποστήριξη για άλλη χώρα επειδή το πρόθεμά της περιέχει αρκετά ψηφία.

Χρησιμοποιήστε την καταμέτρηση ως ένδειξη

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

Διακρίνετε το μηδενικό απόθεμα από μια αποτυχημένη αναζήτηση

Μια επιτυχής καταμέτρηση μηδενός διαφέρει από ένα σφάλμα API. Ελέγξτε το status.code και status.msg καθώς και την κατάσταση HTTP. Θεωρήστε μια λήξη χρόνου ή μια αποτυχημένη αναζήτηση ως άγνωστη διαθεσιμότητα και δοκιμάστε ξανά αργότερα με αναμονή μεταξύ των προσπαθειών (backoff).

Αίτημα

Χρησιμοποιήστε τα διαπιστευτήρια του ενεργοποιημένου λογαριασμού API σας μέσω HTTPS. Υποστηρίζονται η αυθεντικοποίηση Basic και τα διακριτικά φορέα ενεργοποιημένων λογαριασμών API· ισχύουν περιορισμοί λογαριασμού.

Το GET με το αναγνωριστικό του προθέματος στη διαδρομή URL. Δεν υπάρχουν τεκμηριωμένες παράμετροι ερωτήματος ή σώματος.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"

Απάντηση

Ελέγξτε το status.code στο σώμα JSON καθώς και την κατάσταση HTTP. Μια επιτυχής response έχει status.code 200 και status.msg Results. Η response είναι αντικείμενο, όχι λίστα: το count είναι μια ακέραια τιμή στιγμιότυπου αποθέματος· τα npa και nxx είναι συμβολοσειρές τριών χαρακτήρων. Το status.results δεν υπάρχει για αυτό το συσχετιστικό αντικείμενο. Καταμέτρηση 0 σημαίνει ότι η αναζήτηση κάλυψης δεν βρήκε αντίστοιχο τηλεφωνικό κέντρο ή επέστρεψε μηδενικό απόθεμα· δεν αποδεικνύει ότι όλοι οι προμηθευτές ή οι άλλες οδοί ανακάλυψης δεν έχουν αριθμούς.

Ενδεικτική μορφή απάντησης· δεν αποτελεί ζωντανά δεδομένα λογαριασμού ή τρέχουσα προσφορά.

{
  "status": {
    "code": 200,
    "msg": "Results"
  },
  "response": {
    "count": 42,
    "npa": "212",
    "nxx": "555"
  }
}

Σφάλματα

• 404: Ο πάροχος είναι απενεργοποιημένος: η κάλυψη αποθέματος κινητής δεν είναι διαθέσιμη στην υπηρεσία.
• 404: Μη έγκυρο αναγνωριστικό προθέματος: αποκτήστε ένα τρέχον ατομικό αναγνωριστικό προθέματος από την ανακάλυψη.
• 404: Μη έγκυρο πρόθεμα: το αποθηκευμένο πρόθεμα δεν περιέχει αρκετά ψηφία για αναζήτηση NPA/NXX.
• 500: Αποτυχία κάλυψης αποθέματος: η αναζήτηση προς τον ανώτερο πάροχο δεν επέστρεψε επιτυχημένο αποτέλεσμα κάλυψης. Δοκιμάστε ξανά αργότερα με αναμονή μεταξύ των προσπαθειών (backoff)· μια αποτυχία δεν είναι καταμέτρηση μηδενικού αποθέματος.

Διαθεσιμότητα και παρενέργειες

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