Wie CarrierLookup den Netzbetreiber einer Nummer abfragt

Eine Prüfung durchführen

Dieser Abschnitt behandelt Echtzeitprüfungen: Das SaaS-Dashboard und die synchronen REST-Endpunkte teilen sich einen Prüfdienst und dieselbe Bedeutung der Antwort. Für sehr große Listen gibt es eine asynchrone Massenoption, die am Ende dieser Seite behandelt wird.

1. 1

   Nummer übermitteln

   Übermitteln Sie eine vollständige Nummer, wie in der API-Dokumentation beschrieben.

2. 2

   service_type=carrier verwenden

   Das Produkt carrier liefert das Netz, dem die Nummer ursprünglich zugeteilt wurde, mit Anschlussart und Zuteilungsregion.

3. 3

   Ergebnis auslesen

   Lesen Sie die Netzbetreiberfelder in derselben Antwort. Sie beschreiben die ursprüngliche Zuteilung, nicht den Netzbetreiber, der die Nummer heute bedient.

Welches Nummernformat übermittelt werden sollte

CarrierLookup akzeptiert eine Nummer pro Abfrage im E.164-Format: ein Pluszeichen, die Ländervorwahl, dann die Teilnehmernummer ohne Leerzeichen oder Trennzeichen.

• Übermitteln Sie die vollständige Nummer einschließlich Ländervorwahl. Eine nationale Nummer ohne Ländervorwahl kann nicht abgefragt werden.
• Nationale Formate mit führenden Nullen, Leerzeichen, Bindestrichen oder Klammern werden nicht akzeptiert – senden Sie nur + und Ziffern.
• Nummern im falschen Format werden vor jeder Berechnung abgelehnt; ein abgelehntes Format ist keine Antwort „kein Ergebnis“.

Was bedeuten die Netzbetreiberfelder?

Die Netzbetreiberfelder sind die Antwort einer Netzbetreiber-Abfrage: carrier, underlying_carrier, number_type, country_code, region und city auf oberster Ebene einer erfolgreichen Antwort. Sie enthalten den ursprünglich zugeteilten Netzbetreiber und die Anschlussart, das Land sowie die Zuteilungsregion und -stadt, sofern der Anbieter sie liefert. Es gibt kein registered-Flag – eine erfolgreiche Antwort ist das Ergebnis. Alles andere – eine Zeitüberschreitung, ein unbestimmtes Ergebnis, eine ungültige Nummer – kommt stattdessen als Fehlercode zurück, und diese Abfrage wird automatisch erstattet. Ein leerer Wert bedeutet nie „kein Netzbetreiber“; er bedeutet, dass der Anbieter dieses Feld nicht geliefert hat.

• carrier ist das Netz, dem die Nummer bei ihrer Vergabe zugeteilt wurde.
• number_type, region und city können leer sein, wenn der Anbieter sie nicht liefert; die Schlüssel sind immer vorhanden.
• Behandeln Sie andere Ergebnisse gemäß dem API-Antwortcode; leiten Sie die Zuteilung nicht selbst ab.

Das Ergebnis im vorgesehenen Rahmen nutzen

Ein Netzbetreiber-Ergebnis beschreibt das Netz, dem die Nummer ursprünglich zugeteilt wurde. Es ist weder eine Erreichbarkeitsprüfung noch eine Identitätsprüfung noch eine Erlaubnis, jemanden zu kontaktieren.

• Sie bestätigt nicht, wem die Nummer gehört, und berücksichtigt keine Rufnummernmitnahme – eine portierte Nummer meldet weiterhin den Netzbetreiber, dem ihr Nummernblock ursprünglich zugeteilt wurde.
• Ein Netzbetreiber-Ergebnis begründet keine Einwilligung zur Kontaktaufnahme mit der Nummer.
• Behandeln Sie das Ergebnis nicht als aktuellen Netzbetreiber: Eine erneute Abfrage liefert dieselbe ursprüngliche Zuteilung, nicht das Netz, in das die Nummer möglicherweise portiert wurde.

Sehr große Listen: die asynchrone Option

Die Mehrfachprüfung im Dashboard und der Mehrfach-Endpunkt der API decken die meisten Listen ab. Erst wenn eine Liste diese Limits weit übersteigt, ist es sinnvoll, die ganze Datei als eine asynchrone Massenaufgabe zu übermitteln.

• Laden Sie eine .txt- oder .csv-Datei mit einer Nummer pro Zeile hoch, über die Seite für Massenprüfungen oder über die API.
• Wählen Sie beim Hochladen das Land, zu dem die Nummern gehören; jede Zeile sollte dennoch im E.164-Format vorliegen.
• Beim Übermitteln wird Guthaben für die gültigen Zeilen reserviert, berechnet werden nur Nummern, die ein Ergebnis liefern, und die Differenz wird erstattet.
• Die Aufgabe läuft im Hintergrund; laden Sie die Ergebnisdatei herunter, sobald sie fertig ist. Eine fehlgeschlagene Aufgabe wird vollständig erstattet.