Ανάκτηση ενός αγορασμένου αριθμού

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

Αίτημα

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

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

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

Απόκριση

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

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "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",
      "perminute_charges": "0"
    },
    "needs_registration": "0",
    "vrating": "",
    "country_id": "COUNTRY_REFERENCE",
    "area_id": "AREA_REFERENCE",
    "provider_id": "OPAQUE_LEGACY_REFERENCE"
  }
}

Πεδία αριθμού που επιστρέφονται
Πεδίο	Σημασία
`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`	Αποθηκευμένες τιμές ενεργοποίησης, μηνιαίας χρέωσης και χρέωσης ανά λεπτό, καθώς και παρεχόμενα λεπτά. Ο χειριστής δεν παρέχει πεδίο νομίσματος ή νέα προσφορά τιμής. Μη συνάγετε το νόμισμα από τις ενδεικτικές τιμές και μην τις χρησιμοποιείτε ως τρέχουσα προσφορά αγοράς.

Σε σύγκριση με το inventory, αυτό το τελικό σημείο επιστρέφει επίσης τα needs_registration, vrating, country_id, area_id, provider_id και price.perminute_charges. Πρόκειται για αποθηκευμένες τιμές παλαιού τύπου, όχι για ξεχωριστή απόκριση έγκρισης ταυτότητας. Τα αναγνωριστικά αναφοράς πρέπει να αντιμετωπίζονται ως αδιαφανή· μη δημιουργείτε URL ανακάλυψης και μη συνάγετε αντιστοιχίσεις παρόχων από αυτά χωρίς την κατάλληλη απόκριση ανακάλυψης.

Δεν βρέθηκε αντίστοιχος αριθμός

Αν δεν βρεθεί αντίστοιχη μη ακυρωμένη εγγραφή για τον λογαριασμό του οποίου η ταυτότητα έχει επαληθευτεί, το σώμα JSON περιέχει status.code 404 και ένα μήνυμα που περιέχει number not found. Μη βασίζεστε στο επίθημά του που αναφέρεται στη γραμμή πηγαίου κώδικα. Ελέγξτε τον αποθηκευμένο αριθμό και το inventory πριν προσπαθήσετε ξανά.

Χρήση του αποτελέσματος

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