Eine ausgewählte Telefonnummer kaufen

Rufnummer und Preis gemeinsam auswählen

Kaufen Sie eine bestimmte Rufnummer aus einer aktuellen Suche nach verfügbaren Rufnummern. Verwenden Sie beim ausgewählten Eintrag info.uuid als Rufnummern-ID und einen der price[].uuid-Werte desselben Eintrags als Preis-ID. Die Route akzeptiert auch die vollständige gespeicherte Rufnummer; eine Länder-, Gebiets- oder Präfix-ID ersetzt jedoch keine Rufnummernauswahl.

Eine Suche oder das Lesen gespeicherter Preise reserviert keine Rufnummer und schreibt ihren Preis nicht fest. Bestätigen Sie für die Auswahl den Einrichtungspreis, den monatlichen Preis, den Minutenpreis für eingehende Anrufe, die enthaltenen Minuten und Kanäle sowie die Kaufberechtigungen und Registrierungsanforderungen des Kontos. Der anfängliche Grundbetrag in der geprüften Hilfsfunktion setzt sich aus Einrichtungspreis und monatlichem Preis zusammen; sämtliche anbieterspezifischen Gebühren und Bedingungen müssen für den ausgewählten Tarif bestätigt werden.

Eine abgesicherte Kaufanfrage per POST senden

Verwenden Sie ein freigeschaltetes API-Konto über HTTPS von einer zugelassenen Quell-IP-Adresse aus. Der folgende Befehl führt einen Kauf aus, keine Angebotsabfrage und keinen Probelauf. Setzen Sie sämtliche Variablen anhand derselben aktuellen Rufnummern- und Preisauswahl. Die Felder für Obergrenzen behalten das bisherige Präfix restore_quote_ bei; das aktuelle Portal verwendet sie auch für abgesicherte Käufe bestimmter Rufnummern.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --data-urlencode "restore_quote_price_id=$PRICE_ID" \
  --data-urlencode "restore_quote_setup=$SETUP_PRICE" \
  --data-urlencode "restore_quote_monthly=$MONTHLY_PRICE" \
  --data-urlencode "restore_quote_per_minute=$PER_MINUTE_PRICE" \
  --data-urlencode "restore_quote_channels=$CHANNELS" \
  "https://api.multitel.net/v3/rentnumber/$NUMBER_ID/$PRICE_ID"

Verwenden Sie wie gezeigt Formular-POST. Die Hilfsfunktion kann auch JSON und Options-Wrapper verarbeiten, doch diese Prüfung belegt keine vollständige Gleichwertigkeit für alle Angebots- und Anbieterpfade. Verwenden Sie GET nicht für Käufe, auch wenn dieser ältere Koordinator keine ausdrückliche Prüfung der HTTP-Methode besitzt.

Geben Sie immer alle numerischen Angebotsfelder an, wenn Sie die Angebots-Preis-ID angeben. Eine geänderte ID, ein Preis oberhalb einer Obergrenze, eine fehlende oder ungültige Obergrenze, eine geänderte Kanalanzahl oder eine belegte Angebotssperre führt zum API-Code 409, bevor der ausgewählte Rufnummernanbieter beauftragt wird. Vergleiche erlauben eine geringe Gleitkommatoleranz; verwenden Sie die tatsächlich angezeigten Tarifwerte statt eines von Hand gerundeten Preises.

Die Schutzprüfungen machen den gesamten Ablauf weder zu einem Probelauf noch zu einer Transaktion. Abfragen von Registrierungsdaten, die Bereitstellung von Identitäten oder andere Arbeiten der Hilfsfunktion können vor diesen Prüfungen stattfinden. Sie schreiben auch keinen externen Rufnummernbestand fest und ersetzen keine Kaufbeschränkungen auf Kontoebene.

Registrierung und Aktivierung

Fügen Sie bei Bedarf das Formularfeld RegistrationID mit der UUID des kundeneigenen Registrierungsprofils hinzu. Dabei handelt es sich nicht um die ID eines hochgeladenen Nachweises, einer Anbieteradresse oder einer separaten Identitätsentität. Die Hilfsfunktion ermittelt das Profil im Kontext des authentifizierten Kontos und lehnt fehlende oder nicht verfügbare Profile ab.

Bei einigen unterstützten Rufnummernbeständen ist ein Kauf vor Abschluss der Registrierung möglich; bei anderen ist vor dem Kauf ein Profil erforderlich. Eine netzbetreiberspezifische Validierung oder Bereitstellung kann weiterhin erforderlich sein. Ein erfolgreicher Kauf oder eine ausgelassene Vorabprüfung bedeutet weder eine Befreiung von der Registrierung noch eine sofortige Aktivierung.

Sofern vorhanden, kennzeichnet das Antwortfeld registration_requirements die strukturierte Anforderungsabfrage anhand von Land und Rufnummerntyp. Verwenden Sie den Registrierungskatalog und den Ablauf zur Einreichung von Nachweisen, um die geltenden Anforderungen zu erfüllen. Zurückgegebene Texte und Metadaten stellen für sich genommen keine Genehmigung eines Profils dar.

Unbemerkten Tarifwechsel vermeiden

Der ältere Koordinator kann einen nicht angegebenen Preis aus zwischengespeicherten Rufnummerndaten ableiten. Wenn eine ausdrücklich angegebene Preis-ID nicht mehr existiert, kann er außerdem auf den neuesten Kontopreis für ein zwischengespeichertes Präfix zurückgreifen und die zwischengespeicherte Auswahl zulässiger Preise aktualisieren. Verlassen Sie sich bei der Auswahl des vom Kunden genehmigten Tarifs nicht auf diese Ersatzmechanismen.

Geben Sie den ausgewählten Preis ausdrücklich zusammen mit den passenden Feldern für die Angebotsprüfungen an. Die Prüfung der Angebots-ID lehnt einen Rückgriff auf eine andere ID ab, bevor die Rufnummernmiete beauftragt wird. Aktualisieren Sie nach einem Konflikt aufgrund eines veralteten Preises die Suche und lassen Sie die neue Auswahl genehmigen, statt die Schutzprüfungen zu entfernen, um den Kauf zu erzwingen.

Es gibt weder einen garantierten Reservierungszeitraum noch eine für alle Pfade einheitlich durchgesetzte Cache-Gültigkeitsdauer. Die Verfügbarkeit der Rufnummer, die Preisgrenzen des Kontos und die Kaufrichtlinien werden im Ablauf erneut geprüft; das vollständige anbieterspezifische Verhalten wird jedoch noch untersucht.

Erweitert: Routing-Standardeinstellungen des Kontos

Ein Kauf kann die bestehenden Anrufziele, Ausweichziele, das SMS-Ziel und die bevorzugte Trunk-Einstellung für eingehende Anrufe des Kontos übernehmen. Prüfen Sie diese Standardeinstellungen vor der Bestellung; das Weglassen von Routing-Optionen garantiert keine unkonfigurierte Rufnummer. Die geprüfte Hilfsfunktion aktiviert die automatische Verlängerung standardmäßig.

Dies beschreibt das Verhalten der gemeinsam genutzten Hilfsfunktion und garantiert nicht, dass jeder Anbieter jede optionale Einstellung auf dieselbe Weise dauerhaft speichert. Weitere ältere Felder für Telefonie, Voicemail, Fax und SMS existieren, erfordern aber noch eine vollständige anbieterspezifische Prüfung. Prüfen Sie die gespeicherte Konfiguration der gekauften Rufnummer über die Kontoverwaltung, bevor Sie sich auf Anrufe oder Nachrichten verlassen.

Antwort

Fiktives Beispiel für einen unkomplizierten Kauf; Werte und Funktionen variieren je nach ausgewähltem Tarif.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550123",
    "price": {
      "per_minute": "0.0100",
      "free_minutes": "100",
      "setup_price": "2.00",
      "monthly_price": "4.00",
      "channels": "2",
      "overflow": "0"
    },
    "features": [
      "voice"
    ],
    "needs_registration": 0,
    "registration_requirements": null
  }
}

Der Koordinator verwendet seine eigenen Felder status.code/status.msg und die response-Antworthülle, ohne ein garantiertes Feld status.results. Bei einem Fehler ist die Antwortliste in der Regel leer. Prüfen Sie bei Erfolg die zurückgegebene Rufnummer und den Preis und gleichen Sie anschließend den Rufnummernbestand des Kontos und den Registrierungsstatus ab. Die Annahme durch den Anbieter ist kein tatsächlicher Telefonie-, SMS- oder Faxtest.

Fehler und unklare Ergebnisse

Lesen Sie neben dem HTTP-Status auch den tatsächlichen API-Antwortinhalt. Ein externer Anbieter kann eine Rufnummernmiete annehmen, bevor die lokale Benachrichtigung, Registrierung oder weitere Verarbeitung fehlschlägt. Einige Zuweisungen aus dem lokalen Rufnummernbestand verwenden Datenbanktransaktionen; es gibt jedoch keine allgemeine Rückabwicklung von Bestellungen bei externen Anbietern. Dieser Koordinator bietet keinen clientseitigen Idempotenzschlüssel.

Vor einem erneuten Versuch abgleichen

1. Speichern Sie die genehmigte Rufnummer, den Preis und die Angebotsobergrenzen im Bestelldatensatz Ihrer Anwendung, bevor Sie die Anfrage einmalig absenden.
2. Rufen Sie nach der Anfrage den Bestand gekaufter Rufnummern und die Rufnummerndetails desselben Kontos ab, auch nach einer Zeitüberschreitung oder einem Fehler.
3. Wenn die Rufnummer vorhanden ist, prüfen Sie ihren Preis, ihre Verlängerung, ihr Routing und ihren Registrierungsstatus, statt eine weitere Kaufanfrage zu stellen.
4. Wenn das Ergebnis weiterhin unklar ist, lassen Sie den Support die Anbieterbestellung und die Kontoabrechnung abgleichen, bevor Sie einen erneuten Versuch unternehmen. Eine Fehlermeldung oder eine Erfolgsmarkierung im bisherigen Protokoll allein ist kein ausreichender Nachweis.
5. Nachdem die Zuordnung zum Konto und die Aktivierung bestätigt wurden, führen Sie die üblichen Routing-Prüfungen und Diensttests des Kontos durch.