Λίστα αγορασμένων τηλεφωνικών αριθμών

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

Αίτημα

Χρησιμοποιήστε διαπιστευτήρια API από την πλευρά του διακομιστή μέσω HTTPS. Τα παραδείγματα διαβάζουν διαπιστευτήρια από μεταβλητές περιβάλλοντος· δεν περιέχουν λειτουργικά διαπιστευτήρια. Ελέγξτε το status.code στο σώμα JSON, καθώς και την κατάσταση HTTP. Αυτοί οι παλαιοί χειριστές δεν ορίζουν πάντοτε κατάσταση σφάλματος HTTP όταν προκύπτει σφάλμα εφαρμογής.

curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
  "https://api.multitel.net/v3/inventory"

Για φιλτράρισμα βάσει ενός αποθηκευμένου τηλεφωνικού αριθμού, χρησιμοποιήστε την προαιρετική μορφή διαδρομής:

curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
  "https://api.multitel.net/v3/inventory/12025550100"

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

Απόκριση

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

Αυτή είναι μια ενδεικτική δομή απόκρισης, όχι δεδομένα λογαριασμού ή τρέχουσα προσφορά τιμής.

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "number": "12025550100",
      "uuid": "NUMBER_UUID",
      "description": "Main reception",
      "isocode": "US",
      "config": {
        "uri": "sip:reception@example.com",
        "uri2": "",
        "uri3": "",
        "forward_destination": "",
        "sms_uri": "",
        "sms_forward_destination": ""
      },
      "features": {
        "voice": "1",
        "sms": "1",
        "mms": "0"
      },
      "status": {
        "capacity": {
          "assigned_channels": "2",
          "used_channels": "0",
          "overflow": "0",
          "overage_charge": "0.01"
        },
        "origination": {
          "origination_trunk_id": "ORIGINATION_ID",
          "origination_trunk_name": "ORIGINATION_NAME",
          "origination_country_iso": "US",
          "origination_continent_iso": "NA",
          "origination_continent_name": "North America"
        },
        "service_active": "1",
        "force_codec": "",
        "force_dtmf": ""
      },
      "billing": {
        "cnam": "0",
        "overflow": "0",
        "autorenew": "1",
        "persistent": "0",
        "date_created": "2026-01-01 00:00:00"
      },
      "price": {
        "setup_price": "0.00",
        "monthly_price": "1.00",
        "per_minute": "0.01",
        "free_minutes": "0",
        "remaining_minutes": "0"
      }
    }
  ]
}

Πεδία αριθμού που επιστρέφονται
Πεδίο	Σημασία
`number, uuid, description, isocode`	Ο αποθηκευμένος τηλεφωνικός αριθμός, το αδιαφανές αναγνωριστικό του αριθμού, η περιγραφή και ο κωδικός χώρας.
`config`	Αποθηκευμένα πεδία προορισμών φωνητικών κλήσεων, εξωτερικής προώθησης, προορισμού SMS και προώθησης SMS. Αυτό το τελικό σημείο δεν τα τροποποιεί.
`features`	Αποθηκευμένες σημαίες δυνατοτήτων φωνητικών κλήσεων, SMS και MMS. Δεν είναι εγγυημένο ότι οι αποθηκευμένες σημαίες παλαιού τύπου είναι λογικές τιμές JSON.
`status.capacity`	Τιμές εκχωρημένων και χρησιμοποιούμενων καναλιών, ρύθμιση υπερχείλισης και αποθηκευμένη χρέωση υπέρβασης. Πρόκειται για αποθηκευμένα μεταδεδομένα, όχι για νέα προσφορά χωρητικότητας ή δοκιμή πραγματικής κλήσης.
`status.origination`	Αποθηκευμένα μεταδεδομένα προέλευσης κλήσεων. Αντιμετωπίζετε τα αναγνωριστικά ως αδιαφανή· μη βασίζετε τη λογική της εφαρμογής σε εσωτερικές ονομασίες.
`status.service_active, force_codec, force_dtmf`	Αποθηκευμένα πεδία ενεργοποίησης και διαμόρφωσης πολυμέσων. Μια σημαία από μόνη της δεν αποδεικνύει την επιτυχή παράδοση εισερχόμενων κλήσεων.
`billing`	Αποθηκευμένες τιμές CNAM, υπερχείλισης, ανανέωσης, διατήρησης και δημιουργίας. Η ανάγνωσή τους δεν αλλάζει τις ρυθμίσεις ανανέωσης ή άλλες ρυθμίσεις χρέωσης.
`price`	Αποθηκευμένες τιμές ενεργοποίησης, μηνιαίας χρέωσης και χρέωσης ανά λεπτό, καθώς και παροχές λεπτών. Ο χειριστής δεν παρέχει πεδίο νομίσματος ούτε νέα προσφορά τιμής. Μη συμπεραίνετε το νόμισμα από τις τιμές του παραδείγματος και μην τις χρησιμοποιείτε ως τρέχουσα προσφορά αγοράς.

Φιλτράρισμα και σελιδοποίηση

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

Δεν υπάρχουν αριθμοί που να αντιστοιχούν

Αν ο λογαριασμός δεν έχει μη ακυρωμένες εγγραφές που να αντιστοιχούν, το σώμα JSON περιέχει status.code 404 και ένα μήνυμα που περιέχει no numbers found. Δεν επιστρέφει κενό πίνακα με ένδειξη επιτυχίας. Το μήνυμα περιλαμβάνει ένα επίθημα αναφοράς στον πηγαίο κώδικα, το οποίο οι εφαρμογές πελάτη δεν πρέπει να αναλύουν ως σταθερό αναγνωριστικό.

Επόμενα βήματα

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