Routinginformationen abfragen

Fordern Sie Routinginformationen für eine nordamerikanische Telefonnummer an. Nutzen Sie diese Informationen zur Auswertung verfügbarer Routing- und Netzbetreiberdaten, nicht als Nachweis der Identität des Anschlussinhabers, der Inhaberschaft der Nummer, ihrer Erreichbarkeit oder ihrer Verfügbarkeit zum Kauf. Eine Abfrage kann Ihr Konto belasten.

Anfrage

Verwenden Sie Ihr freigeschaltetes API-Konto und die dafür zugelassene Quell-IP-Adresse. Geben Sie die vollständige Nummer als Ziffernfolge einschließlich der Landesvorwahl 1 an. Das Beispiel verwendet Umgebungsvariablen und eine fiktive Nummer. Die Verarbeitungsroutine normalisiert keine Satzzeichen; prüfen Sie die Eingabe vor dem Absenden.

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

Antwort

Es werden nur ausgewählte Felder zur Veranschaulichung gezeigt; ihre Verfügbarkeit hängt von der Quelle und dem Nummerntyp ab.

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": {
    "lrn": "12025550123",
    "ocn": "0000",
    "local": 1,
    "ported": 0,
    "cost": "$0.00025"
  }
}

Die Standardabfrage wandelt die Namen der zurückgegebenen Felder in Kleinbuchstaben um. Je nach Quelle können Felder zum Netzbetreiber, zum Tarifgebiet, zum Standort und zum Zuständigkeitsgebiet enthalten sein. Die Antwort ist kein fest definierter, vollständiger Teilnehmerdatensatz. Das Kennzeichen local kann den Zahlenwert 1 oder die Zeichenfolge 0 enthalten. Die Verarbeitungsroutine berechnet ported, indem sie die zurückgegebene Routingnummer mit der angegebenen Telefonnummer vergleicht; verstehen Sie dies nicht als verifizierte, vollständige Portierungshistorie.

Preis und Wiederholungsversuche

Die geprüfte Verarbeitungsroutine belastet das Konto mit $0.00025, wenn sie ihren Abschlusspfad erreicht und die Abfrage protokolliert. Die zurückgegebenen Kosten werden normalerweise als Zeichenfolge mit Dollarzeichen und nicht als reiner Zahlenwert angegeben. Es wird kein Idempotenzschlüssel bereitgestellt. Eine erneute Anfrage kann eine weitere Gebühr verursachen.

Bei Prepaid-Konten prüft der Code, ob das Guthaben mindestens 0.00025 beträgt. Die Meldung bei unzureichendem Guthaben nennt derzeit $5, was nicht diesem Schwellenwert entspricht. Verstehen Sie den Fehler als Ablehnung aufgrund des Guthabens und prüfen Sie vor einem erneuten Versuch, ob das Konto ausreichend gedeckt ist.

Fehler und unvollständig erfolgreiche Abfragen

Prüfen Sie sowohl den HTTP-Status als auch status.code/status.msg in JSON. Ein leeres Ergebnis der Standardabfrage liefert den API-Code 404. Der API-Code 403 kann auf unzureichendes Prepaid-Guthaben hinweisen.

Ein derzeitiger Fehlerpfad für gebührenfreie Rufnummern kann dennoch den Abfragebetrag abbuchen und den API-Code 200 melden, ohne verwertbare Routingfelder zu liefern; die Kostenangabe kann dabei unvollständig sein. Ein Code 200 allein belegt daher keine verwertbare Abfrage. Prüfen Sie die von Ihrer Anwendung benötigten Felder, gleichen Sie unklare Gebühren mit den Abrechnungsunterlagen des Kontos ab und wenden Sie sich bei unvollständigen Ergebnissen an den Support.

In der geprüften Implementierung werden gebührenfreie Rufnummern je nach Länge der Eingabe unterschiedlich behandelt. Verwenden Sie vorzugsweise die vollständige internationale Ziffernfolge und klären Sie mit dem Support, ob die benötigten gebührenfreien Rufnummern abgedeckt sind. Wiederholen Sie eine Abfrage bei einem fehlerhaft formatierten oder unvollständigen Ergebnis nicht automatisch, und verlassen Sie sich nicht auf eine Routingabfrage, um zu entscheiden, dass eine Nummer bedenkenlos angerufen werden kann oder eine Berechtigung für den Anruf vorliegt.