Einen Telefonverzeichniseintrag für eine Rufnummer beantragen

Einen Verzeichniseintrag beim Netzbetreiber beantragen

Übermitteln Sie den Namen und die Adresse für einen Verzeichniseintrag zu einer geeigneten Rufnummer, die Ihnen in MultiTEL gehört. Dies ist eine kostenpflichtige Aktualisierung beim Netzbetreiber, keine Abfrage des Anrufernamens, kein privater Adressbucheintrag und keine allgemeine Aktualisierung des Bestandsfelds LIDB im Portal.

Übermitteln Sie nur Angaben, deren Verwendung für einen Verzeichniseintrag der Kunde autorisiert hat. Bestätigen Sie vor der Nutzung dieser älteren Route, dass der Netzbetreiber die Rufnummer unterstützt. Der geprüfte Handler prüft weder die Eignung des Anbieters noch das internationale Rufnummernformat; seine Anfrage an den Netzbetreiber setzt eine nordamerikanische Rufnummer voraus und entfernt die erste gespeicherte Ziffer.

Anforderungen an Konto und Rufnummer

Verwenden Sie ein freigeschaltetes API-Konto über HTTPS von einer zugelassenen Quell-IP-Adresse aus. Die genaue Rufnummer muss als nicht stornierter Datensatz einer gekauften Rufnummer zu diesem Konto gehören. Verwenden Sie die vollständige internationale Ziffernfolge aus Ihrem Bestand, etwa das Format mit der Landesvorwahl 1 für eine unterstützte nordamerikanische Rufnummer. Verwenden Sie keine Tarifplan-ID, keine Rufnummern-UUID und keine Rufnummer eines anderen Kontos.

POST-Anfrage mit Formulardaten

Setzen Sie NUMBER auf die Ihnen gehörende Rufnummer. Ersetzen Sie das fiktive Beispiel durch die autorisierten Angaben für den Eintrag. Diese Route liest Formularfelder aus POST; sie verarbeitet keinen Anfragetext im Format application/json.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --data-urlencode "lastname=EXAMPLE" \
  --data-urlencode "firstname=EXAMPLE" \
  --data-urlencode "streetnum=1" \
  --data-urlencode "streetname=Example" \
  --data-urlencode "streetpredir=N" \
  --data-urlencode "streetpostdir=W" \
  --data-urlencode "city=Example City" \
  --data-urlencode "state=NY" \
  --data-urlencode "postalcode=10001" \
  "https://api.multitel.net/v3/directory/$NUMBER"

Die Richtungsangaben und die Adresse im Beispiel sind Platzhalter und keine empfohlene Postanschrift. Ergänzen Sie echte Kundendaten nicht um eine erfundene Richtungsangabe. Die Pflichtfeldprüfungen der API sind oberflächlich: Sie bestätigen weder die Gültigkeit einer Adresse noch deren Akzeptanz durch den Netzbetreiber. Zudem galten auf der älteren Website andere Formularanforderungen.

Die Implementierung kann eine Warnung über einen fehlenden Array-Schlüssel ausgeben, wenn eine optionale Richtungsangabe fehlt oder leer ist. Falls die Antwort fehlerhaft formatiert ist oder der Netzbetreiber die Adresse ablehnt, bewahren Sie die Anfragereferenz auf und bitten Sie den Support, den Eintrag zu bestätigen, anstatt wiederholt vermutete Adressvarianten zu übermitteln.

Gebühren und Verhalten bei erneuten Versuchen

Der geprüfte Handler prüft, ob mindestens 10.00 Guthabeneinheiten vorhanden sind, bevor er den Netzbetreiber kontaktiert. Nachdem sowohl der Netzbetreiber als auch die lokale Rufnummernaktualisierung Erfolg gemeldet haben, zieht er 10.00 vom Kontoguthaben ab und erfasst eine Transaktion zur Einrichtung des Verzeichniseintrags. Dies sind die derzeit implementierten Beträge und kein neuer Preisvorschlag; bestätigen Sie vor dem Absenden anhand Ihrer Kontobedingungen die geltende Abrechnungswährung und den unterstützten Dienst.

Der Vorgang verfügt weder über einen Idempotenzschlüssel noch über einen Schutz vor doppelten Aufträgen oder eine gemeinsame Transaktion für die Übermittlung an den Netzbetreiber, die lokale Aktualisierung und die Abrechnung. Eine erfolgreich wiederholte Anfrage kann eine weitere Übermittlung an den Netzbetreiber und eine weitere Gebühr auslösen. Eine Zeitüberschreitung oder ein API-Fehler beweist nicht, dass der Netzbetreiber die vorherige Anfrage abgelehnt hat: Der Anbieter kann sie bereits angenommen haben, bevor eine lokale Aktualisierung fehlgeschlagen ist.

Antwort

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": ""
}

Die normale Erfolgsantwort enthält eine leere Zeichenfolge im Feld response und gibt weder eine Eintrags-ID noch Details zum Abschluss zurück. Sie bedeutet, dass die Abläufe beim Netzbetreiber und für die lokale Aktualisierung Erfolg gemeldet haben; sie belegt weder die Veröffentlichung in jedem externen Verzeichnis noch eine sofortige Verbreitung oder die künftige Anzeige bei der Anruferkennung.

Fehler der älteren Implementierung

Prüfen Sie sowohl den HTTP-Status als auch die folgenden Felder im JSON: status.code/status.msg. Auch Authentifizierung und Beschränkungen der Quell-IP-Adresse können eine verwertbare Antwort verhindern. Fordern Sie keine Aktualisierung über GET oder Abfrageparameter an, nur weil der ältere Handler keine ausdrückliche Prüfung der HTTP-Methode enthält.

Vor einem erneuten Versuch prüfen

1. Bestätigen Sie vor dem Senden der Anfrage die Ihnen gehörende Rufnummer, die Unterstützung durch den Netzbetreiber, die autorisierten Eintragsdaten und die Gebühr.
2. Senden Sie die Anfrage einmal und bewahren Sie das kontoseitige Ergebnis auf, ohne die Kundenadresse in öffentlichen Protokollen oder Analysedaten offenzulegen.
3. Prüfen Sie den gespeicherten Eintrag und den Transaktionsverlauf über den unterstützten Kontoablauf oder den Support. Berücksichtigen Sie die vom Netzbetreiber bestätigte Bearbeitungszeit; diese API legt keine garantierte Frist für die Verbreitung fest.
4. Lassen Sie bei einem ungewissen Ergebnis den Support den Netzbetreiberauftrag und die lokale Abrechnung abgleichen, bevor Sie es erneut versuchen. Eine wiederholte Anfrage ist keine idempotente Statusabfrage.