Produktleitfaden
Einen Echtzeit-API-Workflow zur Telefonnummernprüfung für Telegram planen
Workflow zur Telegram-Nummernprüfung auf den Echtzeit-Endpunkten von TG Validator: eine oder bis zu 100 Nummern pro Anfrage, mit E.164 und Parallelitätslimits.
Ein technischer Leitfaden zum Entwurf eines Echtzeit-API-Workflows zur Telefonnummernprüfung mit TG Validator, der die synchronen Einzel- und Multi-Endpunkte, Parallelitätslimits, E.164-Formatierung und die Interpretation des Signals behandelt.
Ein Prüf-Workflow mit TG Validator basiert auf Echtzeitprüfungen: Übermitteln Sie eine E.164-Kennung an POST /api/v1/check oder bis zu 100 Kennungen an den synchronen Multi-Endpunkt POST /api/v1/batch-check, und die fertigen Registrierungsergebnisse kommen in der auslösenden HTTP-Antwort zurück. Steuern Sie die clientseitige Parallelität gemäß der API-Dokumentation. Für eine ganze Liste, die weit über eine Echtzeitanfrage hinausgeht, steht zusätzlich eine asynchrone Massenaufgabe als Ergänzung zur Verfügung.
Das synchrone Prüfmodell verstehen
Das primäre Modell von TG Validator ist synchron. Verwenden Sie POST /api/v1/check für eine Kennung oder den synchronen Multi-Endpunkt POST /api/v1/batch-check für bis zu 100 Kennungen; die fertigen Ergebnisse kommen in derselben HTTP-Antwort zurück, ohne Einreichen einer Aufgabe, Polling, Callback oder Download-Schritt und ohne die Vorgabe, dass alle Nummern aus demselben Land stammen. Als Ausweichlösung für eine ganze große Liste steht zusätzlich eine asynchrone Massenaufgabe (/api/v1/bulk-tasks) zur Verfügung: Laden Sie die Datei hoch, erhalten Sie eine Aufgaben-ID, fragen Sie dann den Status der Aufgabe ab und laden Sie die Ergebnisdatei herunter, sobald sie abgeschlossen ist. Beim Einreichen einer Aufgabe wählen Sie das Land, zu dem die Nummern gehören, und die Liste sollte im Wesentlichen aus diesem einen Land stammen. Der Rest dieses Leitfadens konzentriert sich auf den synchronen Weg.
Ihre Daten für die Prüfung vorbereiten
Bevor Sie Anfragen starten, stellen Sie sicher, dass alle Telefonnummern in Ihrem Datensatz nach dem internationalen Rufnummernplan E.164 formatiert sind. Die API erfordert einen Header X-API-Key und einen Header Content-Type: application/json. Verwenden Sie POST /api/v1/check mit service_type=tg und einer E.164-Kennung identifier oder den synchronen Multi-Endpunkt POST /api/v1/batch-check mit service_type=tg und einem Array identifiers mit bis zu 100 E.164-Nummern. Da sich TG Validator ausschließlich auf Telegram konzentriert, muss der Diensttyp immer tg sein.
Einen Echtzeit-API-Workflow zur Telefonnummernprüfung aufbauen
Die Steuerung des Durchsatzes ist die wichtigste Komponente eines Echtzeit-API-Workflows zur Telefonnummernprüfung. Die TG Validator API begrenzt, wie viele Prüfungen ein Konto gleichzeitig in Bearbeitung haben kann, und die API-Dokumentation nennt die aktuelle Obergrenze. Ihre clientseitige Anwendung muss die Anfragen drosseln, um innerhalb dieser Grenze zu bleiben. Überschreitet Ihr System diesen Schwellenwert, lehnt die API die Anfragen ab. Ablehnungen wegen des Parallelitätslimits werden nicht berechnet und erzeugen kein Prüfergebnis; Ihre Anwendung sollte also so ausgelegt sein, dass sie diese Anfragen sicher pausiert und erneut versucht.
Das Registrierungssignal interpretieren
Die API liefert einen dokumentierten Antwort-Umschlag aus code, message und data. Innerhalb dieses Umschlags befindet sich der Telegram-Registrierungsstatus im Feld data.registered. Dieses Ergebnis dient ausschließlich als Kontopräsenzsignal zum Zeitpunkt der Prüfung. Das Produkt liefert keine Felder avatar oder business, sodass sich die Nutzdaten vollständig auf den Registrierungsstatus konzentrieren.
Überwachung und Fehlerbehandlung
Nutzen Sie den Antwortcode der API, um wiederholbare Fehler zu behandeln; die aktuellen Fehlercodes und Limits finden Sie in der API-Dokumentation.
FAQ
Was sollte ich tun, wenn ich das Parallelitätslimit erreiche?
Die API erlaubt pro Konto nur eine begrenzte Anzahl gleichzeitiger Prüfungen, wie in der API-Dokumentation angegeben. Wenn Sie diese überschreiten, lehnt die API die Anfrage ab, ohne Ihr Guthaben zu belasten oder ein Ergebnis zu erzeugen. Ihre Anwendung sollte den Fehlercode für die Parallelität abfangen, kurz pausieren und die Anfrage erneut senden.
Bestätigt der Status „registered“, dass ein Nutzer erreichbar ist?
Nein. Das Registrierungssignal zeigt nur die Präsenz eines Telegram-Kontos genau zum Zeitpunkt der Prüfung an.
Wie sollte der Workflow mit einer Liste umgehen, die größer als eine Anfrage ist?
Behalten Sie den synchronen Multi-Endpunkt als primären Weg bei, mit bis zu 100 Kennungen pro Anfrage und innerhalb des dokumentierten Parallelitätslimits. Für eine ganze Liste, die weit darüber hinausgeht, steht zusätzlich eine asynchrone Massenaufgabe zur Verfügung (hochladen, warten, herunterladen); Sie wählen beim Einreichen das Land, zu dem die Nummern gehören, die Liste sollte im Wesentlichen aus diesem einen Land stammen, und die Mindest- und Höchstanzahl pro Produkt ist in der API-Dokumentation aufgeführt.
Wie werden fehlgeschlagene Prüfungen abgerechnet?
Bei fehlgeschlagenen, abgelaufenen und unbestimmten Prüfungen wird die Gebühr nicht einbehalten. Aktuelle Details zu Plänen und Guthaben finden Sie auf der Preisseite.