Synchrone Prüfung
So prüfen Sie die Telegram-Registrierung einer Telefonnummer in Echtzeit
Übermitteln Sie eine E.164-Telefonnummer und lesen Sie ihren Telegram-Registrierungsstatus aus derselben synchronen API-Antwort.
Das Produkt beantwortet eine präzise Frage
TG Validator prüft, ob die übermittelte Telefonnummer zum Zeitpunkt der Anfrage bei Telegram registriert ist.
Das Produkt nimmt eine E.164-Telefonnummer an, verwendet service_type=tg und liefert das abgeschlossene Ergebnis in derselben HTTP-Antwort. Es gibt keine Job-ID, die abgefragt werden müsste, und keinen Callback, der nötig wäre, bevor die Anwendung data.registered lesen kann.
Der Umfang endet beim Registrierungsstatus. Die Antwort liefert keinen Telegram-Benutzernamen, kein Profil, keinen Aktivitätsstatus, keine Kontakte, Gruppen oder Nachrichtendaten. Sie identifiziert auch nicht die Person, die die Telefonnummer kontrolliert. Das sind keine versteckten Funktionen; sie liegen außerhalb des Produktvertrags.
Ein abgeschlossenes false ist etwas anderes als eine fehlgeschlagene Prüfung
| Zurückgegebene Daten | Registrierungsentscheidung | Verwendung |
|---|---|---|
code=0, registered=true |
Zum Zeitpunkt der Prüfung registriert | true als Ergebnis dieser Anfrage verwenden |
code=0, registered=false |
Zum Zeitpunkt der Prüfung nicht registriert | false als Ergebnis dieser Anfrage verwenden |
| Geschäftscode ungleich null | Keine Registrierungsentscheidung | Keinen booleschen Wert erzeugen; den Fehler gemäß API-Dokumentation behandeln oder wiederholen |
Die Unterscheidung ist wichtig, weil registered=false eine verwertbare Information ist, die aus einer abgeschlossenen Prüfung stammt. Ein API-Fehler wird über den äußeren Envelope mit eigenem HTTP-Status und numerischem code zurückgegeben; er ist kein weiterer Wert von data.registered.
Der synchrone Anfrageweg
- E.164-Eingabe vorbereiten – Gehen Sie von einem bekannten Länderkontext aus und normalisieren Sie die Nummer auf Pluszeichen, Ländervorwahl und Ziffern.
- Anfrage authentifizieren – Verwenden Sie einen in den Einstellungen erstellten API-Schlüssel und senden Sie ihn mit dem dokumentierten Header.
- Telegram-Produkt wählen – Setzen Sie
service_type=tg; leiten Sie das Produkt nicht aus fremden Feldern ab. - Auf dieselbe Antwort warten – Die Prüfung ist synchron, daher erhält die Anwendung die Entscheidung ohne Polling.
- Die exakten Ergebnisfelder lesen – Verarbeiten Sie
data.registeredbeicode=0; lassen Sie das Feld leer, wenn die API einen Geschäftscode ungleich null zurückgibt. - Prüfzeitpunkt erfassen – Behandeln Sie das Ergebnis als aktuelle Beobachtung, nicht als unbefristete Garantie.
Wo Echtzeitverhalten hilft
Der synchrone Vertrag eignet sich gut für Software, die eine aktuelle Registrierungsentscheidung benötigt, bevor sie fortfährt. Ein Operator kann einen Datensatz im Dashboard prüfen, eine interne Anwendung kann eine übermittelte Nummer validieren, oder ein Backend-Worker kann Datensätze einzeln verarbeiten.
Für eine kleine Liste nimmt der synchrone Batch-Endpunkt bis zu 100 E.164-Identifier an und liefert den abgeschlossenen Batch in der auslösenden Antwort. Planung und Parallelität liegen beim Client. So bleibt der API-Vertrag einfach: Jedes abgeschlossene Ergebnis hat eine Eingabe, ein Telegram-Registrierungsergebnis und einen Beobachtungszeitpunkt.
Ein minimaler Anwendungsdatensatz
Verwenden Sie explizite Felder statt eines vagen Labels valid:
| Feld | Zweck |
|---|---|
source_phone |
Bewahrt, was das Quellsystem geliefert hat |
e164_phone |
Speichert die kanonische Nummer, die geprüft wurde |
service_type |
Hält tg als Ergebnisvertrag fest |
outcome |
Die Einordnung Ihrer Anwendung als abgeschlossen, wiederholbar oder fehlgeschlagene Anfrage |
registered |
Speichert true/false nur für abgeschlossene Prüfungen |
checked_at |
Versieht die Registrierungsbeobachtung mit einem Zeitstempel |
Benötigt eine Anwendung eine aktuellere Antwort, sollte sie einen weiteren synchronen Aufruf durchführen. Sie sollte weder den Zeitstempel eines älteren Werts ändern noch behaupten, ein zwischengespeicherter Wert sei in Echtzeit.
Die Integrationsregel, die falsche Daten verhindert
code=0 bestätigt, dass der boolesche Wert registered die abgeschlossene Registrierungsantwort ist.
Diese zweistufige Interpretation hält Eingabeprobleme und vorübergehende Dienstzustände aus dem Telegram-Statusfeld heraus. Zugleich macht sie das Produktversprechen präzise: TG Validator liefert synchron eine aktuelle Registrierungsbeobachtung, wenn die Prüfung abgeschlossen ist, während das integrierende System entscheidet, wann es eine neue Beobachtung benötigt.