cURL-Anfrage
POST /api/v1/bulk-taskscurl -X POST "https://api.carrierlookup.online/api/v1/bulk-tasks" \
-H "X-API-Key: sk_your_api_key" \
-F service_type=number_validation_batch \
-F country=US \
-F [email protected]Validierung von Telefonnummern
Erhalten Sie per asynchronem Datei-Task für jede Nummer ein Gültigkeits- oder Aktivierungssignal. Die true/false-Ergebnisse unterstützen die Prüfung importierter Listen, Datenbereinigung und CRM-Pflege.
Dieses Produkt ist nur als asynchroner Datei-Auftrag verfügbar. Die Echtzeit-Netzbetreiberabfrage liefert keine Gültigkeits- oder Aktivitätssignale.
Zwei Schritte: Datei übermitteln, dann Aufgabe abfragen
Beim Übermitteln wird sofort eine Aufgaben-ID zurückgegeben; fragen Sie die Aufgabe über diese ID ab, und sobald sie erfolgreich ist, enthält die Antwort den Download-Link für die Ergebnisdatei. Jede Anfrage wird mit ihrer eigenen Antwort gezeigt.
1. Datei übermitteln
Die Aufgaben-ID kommt sofort zurück, mit preparing auf true, während die Datei im Hintergrund vorbereitet wird: Ungültige Zeilen, Duplikate und – bei Nummernaufgaben – Nummern ohne Ländervorwahl oder aus einem anderen Land werden entfernt und nicht berechnet. Für die übermittelten Zeilen wird Guthaben reserviert und bei Abschluss abgerechnet; die Differenz wird erstattet.
Antwort: Aufgabe erstellt
200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "number_validation_batch",
"status": "processing",
"country": "US",
"submitted_lines": 509,
"total": 509,
"invalid_cnt": 0,
"no_code_cnt": 0,
"other_country_cnt": 0,
"duplicate_cnt": 0,
"preparing": true,
"created_at": "2026-09-08T09:30:00Z"
}
}2. Aufgabe abfragen
Fragen Sie über die Aufgaben-ID ab. Nach Abschluss der Vorbereitung gilt submitted_lines = total + invalid_cnt + no_code_cnt + other_country_cnt + duplicate_cnt, wobei total die geprüfte und berechnete Menge ist. Eine erfolgreiche Antwort enthält die Anzahl der Erfolge und Fehlschläge sowie den Download-Link für die Ergebnisdatei; eine bei der Vorbereitung abgelehnte Aufgabe erhält den Status failed mit reason_detail und wird vollständig erstattet.
cURL-Anfrage
GET /api/v1/bulk-tasks/{id}curl "https://api.carrierlookup.online/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
-H "X-API-Key: sk_your_api_key"Antwort: Aufgabe abgeschlossen
200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "number_validation_batch",
"status": "success",
"country": "US",
"submitted_lines": 509,
"total": 500,
"invalid_cnt": 3,
"no_code_cnt": 0,
"other_country_cnt": 0,
"duplicate_cnt": 6,
"preparing": false,
"success_cnt": 495,
"failure_cnt": 5,
"result_url": "https://…/result.csv",
"created_at": "2026-09-08T09:30:00Z"
}
}Was mit einer Massenaufgabe passiert
Die Massenprüfung ist keine vergrößerte Echtzeitprüfung – einmal übermitteln, im Hintergrund ausführen, später abholen. Sie müssen die Seite nicht geöffnet lassen; Aufgabenstatus und Ergebnisse bleiben in Ihrem Dashboard.
01Datei hochladen
Eine .txt- oder .csv-Datei mit einer Nummer pro Zeile. Sie wird direkt durchgestreamt; nichts wird auf die Festplatte geschrieben.
02Vorprüfung und Reservierung
Offensichtliche Probleme (eine leere Datei, das falsche Format, zu wenige Zeilen) werden beim Hochladen abgelehnt. Anschließend wird Guthaben reserviert und die Datei im Hintergrund vorbereitet: Doppelte und ungültige Zeilen werden entfernt, und die Länderregel wird geprüft. Eine Datei, die dabei scheitert, endet als fehlgeschlagene Aufgabe und wird vollständig erstattet; andernfalls werden nur die verbleibenden Zeilen geprüft, und die Aufgabe wird bei Abschluss abgerechnet.
03Im Hintergrund ausführen
Die Aufgabe läuft selbstständig – Sie können die Seite gern schließen. Ein Fehlschlag wird sofort gemeldet und vollständig erstattet.
04Ergebnis herunterladen
Holen Sie die Datei auf der Seite der Massenprüfung ab. Sie zahlen nur für Nummern, die tatsächlich ein Ergebnis geliefert haben; die Differenz wird erstattet.
Spalten der Ergebnisdatei
Der Download ist eine einzelne CSV-Datei mit der vollständigen Ergebnistabelle.
Spalten der Ergebnisdatei
identifier·12345678900— Die übermittelte Nummer als reine Ziffernfolge mit Ländervorwahl, ohne Pluszeichen oder Leerzeichen (z. B. 12345678900), und der stabile Schlüssel, um Ergebnisse einem Kunden, Lead oder CRM-Datensatz zuzuordnen. Bewahren Sie sie auf, um die Quellliste nachzuverfolgen und Ergebnisse gesammelt zurückzuschreiben; das Feld allein belegt nicht, dass eine Nummer kontaktiert werden kann.activated·true— Gültigkeits-/Aktivierungsentscheidung: true ist ein Treffer, false ein ausdrücklich negatives Ergebnis. Fehlende oder fehlgeschlagene Ergebnisse nicht durch false ersetzen. Keine Bestätigung von Identität, Kontaktberechtigung oder Erreichbarkeit.
Wann Sie dieses Produkt nutzen sollten
Registrierungslisten prüfen
Prüfen Sie importierte Registrierungs- oder Leadlisten zusammen mit Formulardaten, Betrugsregeln und Einwilligung. Die asynchrone Prüfung ersetzt keine Echtzeit-Codeprüfung bei der Registrierung.
Verknüpfen Sie identifier mit dem Originaldatensatz und behalten Sie die Quelle zur manuellen Prüfung.
Zuordnung: identifier
Listenbereinigung
Markieren Sie Datensätze nach dem Export anhand des Aktivierungssignals und behalten Sie dabei die ursprüngliche Nummer und die Quellfelder bei; leiten Sie fehlende oder ungewöhnliche Signale zur Prüfung weiter, statt Geschäftsdaten direkt zu löschen.
Behandeln Sie true, false und fehlende Ergebnisse getrennt; fehlende Einträge bleiben zur Prüfung offen.
Gruppierung: activated
CRM-Datenpflege
Schreiben Sie Prüfdatum, Produkt und Ergebnis in eigene CRM-Felder, damit Marketing-, Service- und Datenteams in späteren Abläufen mit demselben Listenstatus arbeiten.
Speichern Sie das Ergebnis mit einem von Ihrem Team erfassten Task-Datum. Für eine Aktualisierung einen neuen Task senden.
Rückschreiben: identifier · activated
Was ist die Massen-Nummernvalidierung?
Prüfen Sie E.164-Nummern vor der Kontaktaufnahme in großen Mengen und erhalten Sie Nummern- und Aktivierungssignale. Nutzen Sie das Ergebnis, um Datensätze zur Prüfung zu markieren, Listen zu bereinigen und die CRM-Datenqualität zu pflegen; ein zurückgegebenes Signal garantiert nicht, dass ein Anruf oder eine Nachricht zustande kommt.
Grenzen dieses Produkts
- Interpretieren Sie activated entsprechend dem gewählten Produkt: Gültigkeit/Aktivierung oder Aktivität. Aktivitätsdaten und Häufigkeit sind nicht enthalten.
- Ein Ergebnis belegt weder Identität noch Einwilligung und garantiert nicht, dass ein Anruf oder eine Nachricht ankommt.
- Ergebnisse werden nicht automatisch aktualisiert. Reichen Sie für eine erneute Prüfung einen neuen Auftrag ein.
Über die Nummernvalidierung
Was bedeuten true, false und ein fehlendes Ergebnis?
True ist ein Treffer dieser Prüfung, false ein ausdrückliches negatives Ergebnis. Beides sind ermittelte Entscheidungen; false bedeutet weder Ausführungsfehler noch kostenlose Zeile. Fehlende, unbestimmte und fehlgeschlagene Ergebnisse anhand der Task-Statistik und Endabrechnung getrennt behandeln, niemals als false auffüllen.
Zeigt das Aktivität der letzten Tage oder garantiert es Zustellung?
Nein. Es gibt keinen Beobachtungszeitraum, letztes Aktivitätsdatum, Häufigkeit oder Interaktionsverlauf und keine Zustellgarantie. Mit eigenen Geschäftsdaten und Kontaktberechtigung verwenden.
Ist diese Prüfung in Echtzeit verfügbar?
Dieses Produkt ist nur als asynchroner Datei-Auftrag verfügbar. Die Echtzeit-Netzbetreiberabfrage liefert keine Gültigkeits- oder Aktivitätssignale.
Was passiert mit ungültigen Nummern in der Datei?
Die Vorprüfung verwirft fehlerhafte Zeilen, sodass sie nie in die abrechenbare Anzahl eingehen. Von den verbleibenden Nummern werden auch diejenigen nicht berechnet, die der vorgelagerte Dienst nicht auflösen kann. Sie zahlen nur für Nummern, die tatsächlich ein Ergebnis liefern.
Wie lange dauert eine Aufgabe?
Das hängt von der Anzahl der Nummern und dem Produkt ab. Sie können die Seite nach dem Übermitteln schließen; die Aufgabe läuft im Hintergrund, und das Ergebnis wartet auf der Seite der Massenprüfung auf Sie.
Erhalte ich eine Erstattung, wenn sie fehlschlägt?
Ja. Eine fehlgeschlagene Aufgabe wird vollständig erstattet. Ist die Aufgabe erfolgreich, liefern aber einige Nummern kein Ergebnis, wird dieser Anteil automatisch erstattet. Die Differenz zwischen dem reservierten und dem tatsächlich berechneten Betrag wird immer zurückerstattet.
Weitere Massenprodukte
Globale Netzbetreiber-AbfrageLaden Sie eine ganze Datei mit Nummern hoch: Netzbetreiber, zugrunde liegender Netzbetreiber, Anschlussart, Land, Region und Stadt für jede Nummer – dieselben Felder wie bei der Netzbetreiber-Abfrage in Echtzeit.NummernaktivitätErhalten Sie per asynchronem Datei-Task ein Aktivitätssignal je Nummer. Kombinieren Sie true/false-Ergebnisse mit eigenen Interaktionsdaten, um Zielgruppen und Kontaktprioritäten zu prüfen.Erstellen Sie ein Konto, um eine Massenaufgabe zu übermitteln
Massen- und Echtzeitprüfungen greifen auf dasselbe Guthaben zu – es muss nichts zusätzlich aktiviert werden. Registrieren Sie sich und laden Sie Ihre erste Datei auf der Seite der Massenprüfung hoch.