Der Begriff beschreibt, woher die Antwort kommt, nicht was Sie erhalten. Ein Mobilfunknetz führt ein Register seiner eigenen Teilnehmer. Ein Lookup ist eine Anfrage an dieses Register über einen Dienst mit Zugriff darauf. Was das Register antwortet, unterscheidet sich je nach Netz.
Was ist das HLR selbst?
Das Teilnehmerregister innerhalb eines Mobilfunknetzes.
GSM ist der Mobilfunkstandard, auf dem die meisten Netze vor paketbasierten Kernnetzen aufgebaut wurden. Darin hält das Home Location Register den Datensatz für jeden Teilnehmer dieses Netzes vor, einschließlich des aktuell zuständigen Netzelements. Spätere Architekturen verlagerten dieselbe Rolle auf den Home Subscriber Server. Die beiden Namen beschreiben dieselbe Aufgabe in unterschiedlichen Netzgenerationen.
Keines von beiden ist ein öffentliches Verzeichnis. Es gibt kein einzelnes globales Register, das man abfragen könnte. Kein Lookup liefert einen Namen oder eine Adresse eines Teilnehmers. Was ein Lookup liefern kann, sind Routing- und Statusinformationen, die das bedienende Netz bereit ist herauszugeben.
Was kann ein Lookup tatsächlich verraten?
Welches Netz die Nummer aktuell hält, welche Art von Anschluss es ist und ob er aktiv ist.
| Was Sie anfragen | Was zurückkommt | Was es nicht feststellt |
|---|---|---|
| Basis-Lookup | Land, bedienendes und ausgebendes Netz, Anschlussart, ob die Nummer portiert wurde | Ob jemand sie nutzt |
presence | Ob die Nummer registriert ist und gerade Verkehr empfangen kann | Wer das Gerät in der Hand hält |
roaming | Ob sie sich im Roaming befindet und in welchem Netz | Wo sich die Person aufhält |
sim_swap | Wann die SIM zuletzt gewechselt wurde | Warum sie gewechselt wurde |
porting | Wann die Nummer zuletzt das Netz gewechselt hat und ihr Datensatz | Irgendetwas über den Teilnehmer |
classification | Der genaue zugewiesene Dienst des Nummernbereichs, wo der Basis-Lookup nur grobe Kategorien liefert | Warum der Bereich so zugewiesen wurde |
score | Ein Glaubwürdigkeitswert von 0 bis 100 | Wie er zusammengesetzt wurde, was die anderen Eigenschaften nicht liefern können |
Ein Basis-Lookup unterscheidet bereits das bedienende Netz einer Nummer vom ausgebenden Netz. Genau so wird eine portierte Nummer überhaupt sichtbar: Die beiden unterscheiden sich, und ein ported-Flag bestätigt das.
Ist eine Live-Prüfung ein Beweis für irgendetwas?
Sie ist ein Beweis, dass das Netz geantwortet hat, und nichts darüber hinaus.
Ein Presence-Ergebnis spiegelt eine Echtzeitabfrage an das Netz wider, bei dem die Nummer registriert ist. reachable: true bedeutet also, dass dieses Netz die Nummer in dem Moment als empfangsbereit gemeldet hat. Es identifiziert nicht den Inhaber. Es ist keine Einwilligung. Die libphonenumber-FAQ von Google sagt dasselbe zur Frage, wem eine Nummer gehört:
Do not rely on libphonenumber to determine whether numbers are currently assigned to a specific user and reachable.
Auch bedeutet eine erreichbare Nummer nicht, dass eine Nachricht ankommt. Die Zustellung hängt vom Absender, der Route und der Filterung auf Empfängerseite ab, und nichts davon fragt ein Lookup ab.
Wie lese ich eine Antwort, die niemand geben konnte?
Anhand des Status der Eigenschaft, der drei Ergebnisse unterscheidet.
Jede angefragte Eigenschaft meldet ihren eigenen status:
ok: Die Eigenschaft wurde beantwortet und ihr Wert ist vorhanden.unavailable: Keine Antwort eingegangen, der Block ist dahernull.inconclusive: Eine Antwort ist eingegangen, die die Eigenschaft nicht auflöst.
Nur ok enthält einen Wert, und nur ok wird berechnet. Das lässt die Unterscheidung übrig, die für einen Registrierungsablauf zählt. Ein Presence-Block mit status: unavailable bedeutet, dass niemand Ihnen Auskunft geben konnte. Einer mit status: ok und reachable: false bedeutet, dass das Netz gemeldet hat, die Nummer könne keinen Verkehr empfangen. Ersteres wie Letzteres zu behandeln, macht aus einer unbeantworteten Frage einen abgelehnten Kunden.
Wie führe ich einen Lookup auf Bird aus?
Senden Sie die Nummer und benennen Sie die gewünschten Eigenschaften.
POST /v1/lookup/phone-number erwartet eine phone_number und ein optionales type-Array mit beliebigen Werten aus classification, porting, presence, roaming, sim_swap und score. Lassen Sie type weg, wenn Sie nur den Basis-Lookup benötigen. Jede hinzugefügte Eigenschaft wird separat berechnet und nur bei Zustellung. Fordern Sie presence nur an, wenn Sie eine Live-Prüfung brauchen, nicht standardmäßig.
Verzweigen Sie auf ok. Behandeln Sie jeden anderen Status als nicht beantwortet. Das Status-Vokabular ist ein offenes Enum, ein unbekannter Wert ist also ein zukünftiger Status und kein Fehler. So bleibt die Verzweigung korrekt, wenn das Vokabular wächst. Der Lookup-Leitfaden beschreibt den Ablauf. Welche Prüfungen eine Telefonnummernvalidierung umfasst beschreibt, welche Fragen jede Prüfungsart beantworten kann.
Kurz gesagt
HLR ist ein Name aus der Netzarchitektur, keine öffentliche Datenbank.
Das Home Location Register ist das Teilnehmerregister in älteren Mobilfunknetzen; in neueren Netzen übernimmt der Home Subscriber Server dieselbe Rolle.
Ein Ergebnis „erreichbar
Dass das Netz meldet, eine Nummer könne Verkehr empfangen, sagt nichts darüber aus, wer das Gerät in der Hand hält oder ob die Person dem Kontakt zugestimmt hat.
Jede Antwort trägt ihren eigenen Status.
Bird meldet jede angefragte Eigenschaft als ok, unavailable oder inconclusive, und nur ok enthält einen Wert.
Unavailable und unreachable sind verschiedene Antworten.
Das eine bedeutet, dass niemand Ihnen Auskunft geben konnte. Das andere bedeutet, dass das Netz Ihnen mitgeteilt hat, die Nummer könne gerade keinen Verkehr empfangen.