Einen gespeicherten Nummernpreisplan lesen

Einen gespeicherten Preisplan lesen

Rufen Sie nach dem Durchsuchen verfügbarer Telefonnummern die für Ihr API-Konto gespeicherten Preiszeilen ab. Verwenden Sie die uuid der Preisoption aus der price-Liste der ausgewählten Nummer, nicht deren Nummer, Präfix-ID oder Gebiets-ID. Halten Sie die ausgewählte Nummer und die Preisoption zusammen.

Dies ist eine Kompatibilitätsabfrage gespeicherter Preise. Sie aktualisiert weder Verfügbarkeit noch Preise, reserviert keine Nummer, gibt keine Bestellung auf und garantiert nicht den Betrag eines zukünftigen Kaufs. Prüfen Sie vor der Bestellung die Preisoption, die eine neue Nummernsuche zurückgibt.

Anfrage

Verwenden Sie Ihr freigeschaltetes API-Konto über HTTPS von einer zugelassenen IP-Adresse aus. Setzen Sie PRICE_ID auf genau die Preisoptions-ID, die Sie erhalten haben. Die Methode liest ein Pfadargument und keine Body-, Datums- oder Paginierungsparameter.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"

Dasselbe Konto, das die Preisoption erhalten hat, muss diese Abfrage durchführen. Konstruieren Sie keine ID, verwenden Sie keine Datenbank-Zeilennummer und ersetzen Sie sie nicht durch die Auswahl eines anderen Kontos. Die Legacy-Methode gleicht nur die sichtbare Preis-ID ab.

Antwort

Das folgende fiktive Beispiel zeigt nur ausgewählte kundenseitige Felder. Tatsächliche Antworten geben vollständige gespeicherte Zeilen zurück und können zusätzliche Konto-, Lieferanten- und interne Preismetadaten enthalten. Behalten Sie die vollständige Antwort auf Ihrem Server und geben Sie nur die kundenseitigen Werte weiter, die Ihre Anwendung benötigt.

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "visible_uuid": "PRICE_FROM_SEARCH",
      "setup_price": "2.00",
      "monthly_price": "4.50",
      "per_minute": "0.0100",
      "free_minutes": "100",
      "channels": "2"
    }
  ]
}

response ist eine Liste, auch bei nur einer Zeile. status.results zählt die zurückgegebenen Zeilen. Numerische Datenbankwerte können Zeichenketten sein. Der Endpunkt fügt kein Währungsfeld hinzu und rechnet keine Währungen um; bestätigen Sie die Abrechnungswährung des Kontos, statt sie aus diesem Beispiel abzuleiten.

Preisfelder

Ausgewählte Preisplanfelder
Feld	Bedeutung
visible_uuid	Die sichtbare Kennung der gespeicherten Preisoption. Verwenden Sie die ursprüngliche Options-ID, wenn Sie die Abfrage zuordnen.
setup_price	Gespeicherter einmaliger Einrichtungspreis für diese Option.
monthly_price	Gespeicherter wiederkehrender Monatspreis.
per_minute, free_minutes	Gespeicherter Minutentarif für eingehende Anrufe und Anzahl der inkludierten Minuten. Diese beziffern weder ausgehende Anrufe noch jeden möglichen Aufschlag.
channels	Gespeicherte Kanalanzahl für diese Option; dies ist keine Live-Prüfung der Kapazität oder Registrierung.
yearly_price	Ein zusätzliches gespeichertes Jahrespreisfeld kann vorhanden sein. Schließen Sie nicht daraus, dass ein Monatspreis ungleich null und ein Jahresfeld mit dem Wert null einen kostenlosen Jahresplan darstellen.

Mehrere passende Zeilen behandeln

Eine Abfrage kann mehr als eine gespeicherte Zeile zurückgeben. Die Methode bietet keine garantierte Reihenfolge, keine Auswahl der neuesten Zeile und keinen Nummern-/Präfixfilter. Wählen Sie nicht stillschweigend die erste oder letzte Zeile. Vergleichen Sie den zurückgegebenen Kontext mit der ursprünglich ausgewählten Nummer und Preisoption; bleibt er mehrdeutig oder veraltet, wiederholen Sie die Nummernsuche, statt diese Antwort als Bestellangebot zu behandeln.

Der Bestellprüfungs-Workflow des Portals führt zusätzliche Auswahl- und Gültigkeitsprüfungen durch. Gehen Sie nicht davon aus, dass diese Legacy-Abfrage diese Prüfungen implementiert oder jede Kennung akzeptiert, die das Portal akzeptiert.

Leere Antworten und Fehler

Wenn keine gespeicherte Zeile passt, gibt der aktuelle Handler kein JSON-Ergebnis und keine explizite Nicht-gefunden-Antwort aus. Ein leerer Body ist weder ein Nullpreis noch ein verfügbarer Plan noch eine bestätigte erfolgreiche Abfrage. Prüfen Sie sowohl die HTTP-Antwort als auch die JSON-Struktur; bestellen Sie nicht auf Basis fehlender oder nicht parsbarer Preisdaten.

Auch Authentifizierung, Quell-IP-Beschränkungen und Datenbankfehler können eine verwertbare Antwort verhindern. Für eine Datenbankausnahme gibt es keinen handlerspezifischen Fehlerumschlag. Erneuern Sie Ihre Auswahl oder wenden Sie sich an den Support, wenn eine authentifizierte Abfrage weiterhin nicht verfügbar ist.

Auswirkungen und Grenzen

Die geprüfte Abfrage führt eine Leseabfrage aus und enthält keine Belastung, keinen Kauf, keine Reservierung und keine Aktualisierung von Anbieterpreisen. Das Lesen gespeicherter Preise stellt weder den aktuellen Bestand noch eine behördliche Genehmigung, eine Kaufberechtigung des Kontos oder die endgültige Abrechnung fest.