Bestand gekaufter Rufnummern auflisten

Listen Sie die Datensätze gekaufter Rufnummern auf, deren gespeicherter Inhaber dem durch Ihre API-Zugangsdaten ausgewiesenen Konto entspricht. Das Vorhandensein eines Datensatzes ist von einem erfolgreichen Test mit einem tatsächlichen Anruf zu unterscheiden.

Anfrage

Verwenden Sie serverseitige API-Zugangsdaten über HTTPS. Die Beispiele lesen Zugangsdaten aus Umgebungsvariablen; sie enthalten keine funktionsfähigen Zugangsdaten. Prüfen Sie status.code im JSON-Antwortkörper sowie den HTTP-Status. Diese älteren Handler setzen bei einem Anwendungsfehler nicht durchgängig einen HTTP-Fehlerstatus.

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

Um nach einer einzelnen gespeicherten Telefonnummer zu filtern, verwenden Sie die optionale Pfadvariante:

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

Verwenden Sie die gespeicherte internationale Telefonnummer als Ziffernfolge einschließlich Ländervorwahl. Übergeben Sie stattdessen weder eine Telefonanlagen-Nebenstelle noch eine Rufnummern-UUID, eine Gebiets-ID oder eine Präfix-ID. Die angegebene Rufnummer wählt einen vorhandenen Datensatz aus; dadurch wird keine Rufnummer gekauft oder konfiguriert.

Antwort

Das Feld response ist bei Erfolg immer ein Array, auch bei der Pfadvariante für eine einzelne Rufnummer. status.results gibt die Länge des Arrays an.

Dies veranschaulicht die Struktur einer Antwort und enthält weder Kontodaten noch ein aktuelles Preisangebot.

{
  "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"
      }
    }
  ]
}

Zurückgegebene Rufnummernfelder
Feld	Bedeutung
`number, uuid, description, isocode`	Die gespeicherte Telefonnummer, die nicht interpretierbare Rufnummernkennung, die Beschreibung und der Ländercode.
`config`	Gespeicherte Felder für Sprachziele, externe Weiterleitung, SMS-Ziel und SMS-Weiterleitung. Dieser Endpunkt ändert sie nicht.
`features`	Gespeicherte Kennzeichen für Sprach-, SMS- und MMS-Funktionen. Bei älteren gespeicherten Kennzeichen ist nicht gewährleistet, dass es sich um boolesche JSON-Werte handelt.
`status.capacity`	Werte für zugewiesene und belegte Kanäle, Überlaufeinstellung und gespeicherte Gebühr für Überschreitungen. Dies sind gespeicherte Metadaten, kein aktuelles Kapazitätsangebot und kein Test mit einem tatsächlichen Anruf.
`status.origination`	Gespeicherte Metadaten zur Anrufherkunft. Behandeln Sie Kennungen als nicht interpretierbare Werte; leiten Sie aus internen Namen keine Anwendungslogik ab.
`status.service_active, force_codec, force_dtmf`	Gespeicherte Felder für Aktivierung und Medienkonfiguration. Ein Kennzeichen allein belegt nicht, dass eingehende Anrufe erfolgreich zugestellt werden.
`billing`	Gespeicherte Werte für CNAM, Überlauf, Verlängerung, Persistenz und Erstellung. Ihr Abruf ändert weder die Verlängerungseinstellungen noch andere Abrechnungseinstellungen.
`price`	Gespeicherte Einrichtungs-, Monats- und Minutenpreise sowie Minutenkontingente. Der Handler liefert weder ein Währungsfeld noch ein aktuelles Angebot. Leiten Sie aus den Beispielwerten keine Währung ab und verwenden Sie sie nicht als aktuelles Kaufangebot.

Filterung und Seitennavigation

Dieser Handler bietet weder Seitennavigation noch eine Begrenzung der Seitengröße oder eine explizite Sortierreihenfolge. Er gibt alle durch seine Abfrage ausgewählten, nicht für ungültig erklärten Datensätze zurück. Er implementiert weder einen Filter ausschließlich für Rufnummern mit aktivem Dienst noch eine separate Ansicht archivierter Rufnummern. Gehen Sie nicht davon aus, dass die Reihenfolge der zurückgegebenen Datensätze gleich bleibt.

Keine passenden Rufnummern

Wenn das Konto keine passenden, nicht für ungültig erklärten Datensätze enthält, enthält der JSON-Antwortkörper den Wert status.code 404 sowie eine Meldung mit dem Text no numbers found. Es wird kein leeres Array als erfolgreiche Antwort zurückgegeben. Die Meldung enthält ein Suffix mit einem Quellverweis, das Clients nicht als stabile Kennung auswerten sollten.

Nächste Schritte

Verwenden Sie numberinfo , wenn Sie für eine Rufnummer die zusätzlichen älteren Registrierungs- und Rufnummernreferenzfelder benötigen. Prüfen Sie die Ziele für Sprachverbindungen und Nachrichten, bevor Sie eine Route über einen separaten Konfigurationsvorgang ändern.