Εύρεση διαθέσιμων αριθμών κινητής

Επιβεβαιώστε ότι το απόθεμα κινητών είναι ενεργοποιημένο

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

Η τρέχουσα παλιά διαδρομή δεν απορρίπτει αξιόπιστα κάθε μη επιλέξιμο αίτημα. Ένας λογαριασμός χωρίς ενεργοποιημένο απόθεμα κινητών μπορεί να λάβει συνηθισμένο απόθεμα ενώ η απάντηση εξακολουθεί να λέει info.is_mobile: 1. Ένα πρόθεμα δωρεάν κλήσης μπορεί επίσης να φτάσει στον κλάδο αποθέματος δωρεάν κλήσεων με αυτή την ετικέτα. Μην χρησιμοποιείτε αυτή την ετικέτα μόνη της για την αναγνώριση υπηρεσίας κινητής και μη στέλνετε συνηθισμένα ή δωρεάν προθέματα σε αυτό το endpoint. Χρησιμοποιήστε τον επιβεβαιωμένο κατάλογο κινητής και την ενεργοποιημένη ροή εργασίας του λογαριασμού.

Διατηρήστε κάθε αριθμό μαζί με τη δική του επιλογή τιμής

Για κάθε υποψήφιο, διατηρήστε το number, το info.uuid και τη λίστα price της ίδιας καταχώρισης μαζί. Η απάντηση περιέχει επίσης μεταδεδομένα προθέματος/περιοχής/χώρας, όρους συμβολαίου και περιορισμούς εγγραφής. Οι υποψήφιοι ταξινομούνται κατά τη μηνιαία τιμή της πρώτης τους επιλογής τιμής, αύξουσα· δεν υπάρχει εγγυημένη σταθερή σειρά για ίσες τιμές. Μην αντικαθιστάτε το ID αριθμού που επιστρέφεται με ID περιοχής ή προθέματος ούτε το συνδυάζετε με ID τιμής άλλου υποψηφίου.

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

Χρησιμοποιήστε μια μικρή θετική ποσότητα

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

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

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

Ελέγξτε ξανά πριν από την αγορά

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

Αίτημα

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

GET με το τρέχον αναγνωριστικό μεμονωμένου προθέματος και μια θετική ακέραια ποσότητα στη διαδρομή URL. Η ποσότητα προεπιλέγεται σε 1 αν παραλειφθεί. Χρησιμοποιήστε το παράδειγμα με 1· αυτή η διαδρομή δεν επικυρώνει ή επιβάλλει με συνέπεια ένα καθολικό όριο αποτελεσμάτων.

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

Απόκριση

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

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

{
  "status": {
    "code": 200,
    "msg": "Results: 1",
    "results": 1
  },
  "response": [
    {
      "number": "12025550123",
      "info": {
        "uuid": "NUMBER_ID",
        "prefix_uuid": "PREFIX_ID",
        "country_iso": "US",
        "is_mobile": 1
      },
      "price": [
        {
          "uuid": "PRICE_ID",
          "monthly_price": "ACCOUNT_MONTHLY_PRICE",
          "setup_price": "ACCOUNT_SETUP_PRICE",
          "per_minute": "ACCOUNT_INCOMING_RATE",
          "channels": "PLAN_CHANNELS"
        }
      ],
      "features": [
        "voice",
        "sms",
        "mms",
        "t38"
      ]
    }
  ]
}

Σφάλματα

• 404: Μη έγκυρο ID προθέματος, χώρα ή περιοχή: ανανεώστε την επιλογή μεμονωμένου προθέματος κινητής.
• 404: Δεν βρέθηκαν αριθμοί: μπορεί να σημαίνει μη χρησιμοποιήσιμο απόθεμα, απενεργοποιημένη υπηρεσία, αποτυχημένη αναζήτηση παρόχου, μη υποστηριζόμενη επιλογή ή περιορισμούς λογαριασμού. Δεν αποτελεί απόδειξη έγκυρου μηδενικού αριθμού αποθέματος.

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

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