Rufen Sie einen Datensatz zu einer gekauften Rufnummer und dessen gespeicherte Konfiguration ab. Dieser Vorgang gibt ein Objekt zurück, während der Endpunkt inventory ein Array zurückgibt.
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/numberinfo/12025550100"Das erforderliche Pfadsegment ist die gespeicherte internationale Telefonnummer, nicht deren UUID oder eine Nebenstelle einer Telefonanlage. Dieser Handler verwendet weder Abfrageparameter noch einen Anfragekörper.
Antwort
Dies ist eine beispielhafte Antwortstruktur, keine Kontodaten und kein aktuelles Preisangebot.
{
"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"
}
}| Feld | Bedeutung |
|---|---|
number, uuid, description, isocode | Die gespeicherte Telefonnummer, die opake Rufnummernkennung, die Beschreibung und der Ländercode. |
config | Gespeicherte Felder für Sprachziele, externe Weiterleitung, SMS-Ziel und SMS-Weiterleitung. Dieser Endpunkt verä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 genutzte Kanäle, die Überlaufeinstellung und die gespeicherte Gebühr für Überschreitungen. Dies sind gespeicherte Metadaten, kein neu erstelltes Kapazitätsangebot und kein Live-Anruftest. |
status.origination | Gespeicherte Metadaten zur Anrufherkunft. Behandeln Sie Kennungen als opak; leiten Sie aus internen Namen keine Anwendungslogik ab. |
status.service_active, force_codec, force_dtmf | Gespeicherte Felder zur Aktivierung und Medienkonfiguration. Ein Kennzeichen allein belegt keine erfolgreiche eingehende Zustellung. |
billing | Gespeicherte Werte für CNAM, Überlauf, Verlängerung, Persistenz und Erstellung. Ihr Abruf verändert weder die Verlängerung noch andere Abrechnungseinstellungen. |
price | Gespeicherte Einrichtungs-, Monats- und Minutenpreise sowie Minutenkontingente. Der Handler liefert weder ein Währungsfeld noch ein neu erstelltes Preisangebot. Leiten Sie aus den Beispielwerten keine Währung ab und verwenden Sie sie nicht als aktuelles Kaufangebot. |
Im Vergleich zu inventory gibt dieser Endpunkt außerdem folgende Felder zurück: needs_registration, vrating, country_id, area_id, provider_id und price.perminute_charges. Dies sind ältere gespeicherte Werte, keine gesonderte Antwort zur Genehmigung einer Identitätsprüfung. Referenz-IDs sollten als opak behandelt werden; erstellen Sie daraus ohne die entsprechende Discovery-Antwort keine Discovery-URLs und leiten Sie daraus keine Anbieterzuordnungen ab.
Keine passende Rufnummer
Wenn für das authentifizierte Konto kein passender, nicht annullierter Datensatz gefunden wird, enthält der JSON-Antwortkörper status.code 404 und eine Meldung mit dem Text number not found. Verlassen Sie sich nicht auf den angehängten Quellzeilenhinweis. Prüfen Sie vor einem erneuten Versuch die gespeicherte Rufnummer und inventory.
Das Ergebnis verwenden
Hierbei werden gespeicherte Daten abgerufen. Dadurch wird weder eine Rufnummer gekauft noch werden Identitätsdokumente genehmigt oder ein Ziel geändert. Auch wird nicht garantiert, dass ein Anruf, ein Fax oder eine Nachricht zugestellt wird. Testen Sie beim Konfigurieren einer Rufnummer jeden aktivierten Dienst einzeln.