So prüfen Sie eine CSV-Datei mit Telefonnummern in Echtzeit auf Telegram-Registrierung

Ein technischer Leitfaden zur Echtzeitprüfung einer CSV-Datei mit Telefonnummern auf Telegram-Registrierung mit TG Validator, mit Schwerpunkt auf Datenvorbereitung, den synchronen Einzel- und Multi-Endpunkten, der Steuerung der Parallelität und der Interpretation der Ergebnisse.

TG Validator prüft die Telegram-Registrierung in Echtzeit: Senden Sie eine E.164-Nummer an POST /api/v1/check oder bis zu 100 Nummern an den synchronen Multi-Endpunkt POST /api/v1/batch-check, und das fertige Ergebnis kommt in derselben HTTP-Antwort zurück. Um eine CSV-Datei zu prüfen, standardisieren Sie die Spalte im E.164-Format, senden sie über den Multi-Endpunkt mit bis zu 100 Kennungen pro Anfrage und steuern die clientseitige Parallelität gemäß der API-Dokumentation. Eine ganze Datei, die weit über eine Echtzeitanfrage hinausgeht, kann auch als asynchrone Massenaufgabe hochgeladen werden.

Ihre Daten für die Prüfung vorbereiten

Bei der Verarbeitung einer CSV-Datei mit Kontakten besteht der erste Schritt darin, die Eingabe zu standardisieren. TG Validator verlangt, dass alle übermittelten Telefonnummern im E.164-Format vorliegen. Dieser internationale Rufnummernplan stellt sicher, dass jede Nummer weltweit eindeutig ist; sie beginnt in der Regel mit einem „+“, gefolgt von der Ländervorwahl und der Teilnehmernummer. Wenn Sie Ihre CSV-Spalte vor dem Start der API-Anfragen auf E.164 standardisieren, vermeiden Sie Fehler wegen ungültiger Telefonnummern und stellen sicher, dass das System den Telegram-Registrierungsstatus genau prüfen kann.

Den API-Workflow von TG Validator verstehen

Das primäre Modell von TG Validator ist synchrones Request-Response, für Einzel- wie für Multi-Prüfungen. Verwenden Sie POST /api/v1/check für eine Nummer oder den synchronen Multi-Endpunkt POST /api/v1/batch-check mit service_type=tg für bis zu 100 E.164-Kennungen aus einer CSV-Datei; beide antworten in derselben HTTP-Antwort, ohne Einreichen einer Aufgabe, Polling oder Download-Schritt.

Durchsatz und API-Limits steuern

Arbeiten Sie die CSV-Datei mit dem synchronen Multi-Endpunkt ab, mit bis zu 100 Kennungen pro Anfrage, und beachten Sie die Nutzungskontrollen der Plattform-API. TG Validator setzt ein Parallelitätslimit pro Nutzer durch; prüfen Sie daher den aktuellen Wert in der API-Dokumentation, bevor Sie festlegen, wie viele Anfragen Ihr Skript gleichzeitig offen hält. Für eine ganze Datei, die weit über eine Echtzeitanfrage hinausgeht, steht zusätzlich eine asynchrone Massenaufgabe zur Verfügung (hochladen, warten, herunterladen); die aktuellen Limits dafür finden Sie in der API-Dokumentation. Überschreitet Ihr Skript diese Schwellenwerte, gibt die API spezifische Fehlercodes zurück, die anzeigen, dass alle Parallelitätsplätze belegt sind oder dass die Zeit für die Prüfung abgelaufen ist. Ablehnungen dieser Art werden nicht berechnet und erzeugen kein Prüfergebnis. Eine Verzögerung oder eine Warteschlange zur Begrenzung der Parallelität in Ihrem CSV-Verarbeitungsskript sorgt für einen reibungslosen Ablauf ohne unnötige Fehler.

Ergebnisse interpretieren und Fehler behandeln

Die API liefert einen dokumentierten Antwort-Umschlag mit code, msg und data. Bei Telegram-Prüfungen liefert das Feld data.registered das Kontopräsenzsignal. Bei einer abgeschlossenen Telegram-Prüfung enthält das zurückgegebene data nur service_type, identifier und registered; interne Datensatz-, Transaktions-, Status- und Abrechnungsfelder werden nicht zurückgegeben.

FAQ

In welchem Format sollten Telefonnummern für die Prüfung vorliegen?

Alle Telefonnummern müssen im E.164-Format übermittelt werden, das die weltweite Eindeutigkeit jeder Nummer sicherstellt: ein „+“, gefolgt von der Ländervorwahl und der Teilnehmernummer.

Was passiert, wenn ich das Parallelitätslimit überschreite?

Wenn Sie das dokumentierte Parallelitätslimit überschreiten, gibt die API einen Fehlercode zurück. Solche limitbedingten Ablehnungen werden nicht berechnet und erzeugen kein Prüfergebnis.

Kann ich mehrere Nummern in einer Anfrage prüfen?

Ja. Der synchrone Multi-Endpunkt POST /api/v1/batch-check akzeptiert bis zu 100 E.164-Kennungen und liefert die fertigen Ergebnisse in derselben HTTP-Antwort. Für eine ganze Datei, die weit darüber hinausgeht, steht zusätzlich eine asynchrone Massenaufgabe zur Verfügung (Sie wählen beim Einreichen das Land, zu dem die Nummern gehören, und die Liste sollte im Wesentlichen aus diesem einen Land stammen), doch die synchronen Endpunkte bleiben der primäre Weg zur Prüfung.