Phone Carrier Bulk Lookup API: Massenprüfung

Ermittelt für jede übermittelte Mobilnummer den Netzbetreiber, den zugrunde liegenden Netzbetreiber, den Anschlusstyp, die Ländervorwahl, die Region und die Stadt. Vereinfacht die Gruppierung nach Netzbetreiber und die Erkennung virtueller Nummern. Die Aufgabe verwendet den standardmäßigen asynchronen Batch-Workflow.

Eingabeformat

Laden Sie eine Textdatei mit einer Telefonnummer pro Zeile hoch. Normalisieren Sie die Werte vor dem Upload; für Telefonnummern wird das E.164-Format empfohlen.

+14155552671
+13105551234

Reichen Sie pro Aufgabe ein Land ein. Nummern werden anhand des Landes der Aufgabe normalisiert (siehe country_code unten); Nummern aus einem anderen Land in derselben Datei werden auf dieses Land umgeschrieben und liefern keine korrekten Ergebnisse.

Aufgabe erstellen

POST https://api.checknumber.ai/v1/tasks

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'file=@"./input.txt"' \
--form 'task_type="globalCarrier"' \
--form 'country_code="US"'

Anfrageparameter

Feld	Erforderlich	Beschreibung
file	ja	Textdatei, eine Telefonnummer pro Zeile.
task_type	ja	globalCarrier. Die früheren länderspezifischen Aufgabentypen (usaCarrier, deCarrier, gbCarrier, …) werden weiterhin akzeptiert und verweisen auf dasselbe Produkt.
country_code	nein	ISO-3166-alpha-2-Land der Nummern in der Datei (US, DE, OM, …). Dient zum Normalisieren von Nummern ohne Ländervorwahl. Wird bei Weglassen aus der Datei abgeleitet.

Die API gibt eine Aufgaben-ID zurück. Bewahren Sie diese ID auf und verwenden Sie sie zur Abfrage des Aufgabenstatus.

Antwort beim Upload

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "pending",
  "total": 5000,
  "estimated_amount": {
    "amount": "0.500000",
    "currency": "USD"
  },
  "message": "Task created successfully"
}

Aufgabenstatus prüfen

POST https://api.checknumber.ai/v1/gettasks

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'task_id="d4g8o46p2jvh04o9uolg"'

Fragen Sie den Status ab, bis status zu exported wechselt. pending und processing sind keine abgeschlossenen Ergebnisse.

Antwort während der Verarbeitung

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "processing",
  "total": 5000,
  "success": 2500,
  "failure": 0
}

Exportierte Antwort

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "exported",
  "total": 5000,
  "success": 5000,
  "failure": 0,
  "result_url": "https://example-link-to-results.zip",
  "actual_amount": {
    "amount": "2.000000",
    "currency": "USD"
  }
}

Ergebnisfelder

Feld	Beschreibung	Beispiel
number	Telefonnummer aus der übermittelten Datei.	+14155552671
number_type	Für die Nummer zurückgegebener Leitungstyp.	mobile
country_code	country_code value returned for the input.	Beispielwert
carrier	Carrier value returned for the number.	Beispiel Carrier
underlying_carrier	Carrier value returned for the number.	Beispiel Carrier
region	region value returned for the input.	Beispielwert
city	Vom Dienst für den Eingabewert zurückgegebener Ort.	Beispielwert

Verarbeitung der Ergebnisdatei

Laden Sie die Datei erst nach dem Export der Aufgabe über result_url herunter. Bewahren Sie die zurückgegebenen Spaltennamen bei der weiteren Verarbeitung bei.

Antwortfelder

Feld	Beschreibung
created_at	Zeitstempel der Aufgabenerstellung.
updated_at	Zeitstempel der letzten Statusaktualisierung.
task_id	Eindeutige Aufgabenkennung.
status	pending, processing, exported oder failed.
total	Gesamtzahl der verarbeiteten Eingabewerte.
success	Erfolgreich verarbeitete Werte.
failure	Werte, deren Verarbeitung fehlgeschlagen ist.
result_url	Download-URL nach dem Export der Aufgabe.
actual_amount	Endgültig abgerechneter Betrag, sofern verfügbar.
estimated_amount	Beim Erstellen der Aufgabe zurückgegebener Schätzbetrag.

Statuscodes

Status	Beschreibung
200	Anfrage erfolgreich.
202	Aufgabe erfolgreich erstellt; der geschätzte Betrag wurde angewendet.
400	Ungültige Datei, nicht unterstützter Aufgabentyp oder zu wenige gültige Einträge.
401	API-Key fehlt oder ist ungültig.
402	Unzureichendes Kontoguthaben.
403	Produkt für Ihr Konto nicht verfügbar (eingestellt oder nur für Whitelist-Kunden); bitte Support kontaktieren.
404	Aufgabe nicht gefunden.
413	Die hochgeladene Datei ist zu groß.
500	Interner Serverfehler; versuchen Sie es später erneut.
503	Produkt vorübergehend nicht verfügbar (wegen Wartung pausiert); es wird nichts berechnet, später erneut versuchen.

Hinweise zum Betrieb

• Die Aufgabe ist asynchron. Verwenden Sie die Aufgaben-ID zur Statusabfrage.
• Prüfen Sie vor dem Upload die produktspezifischen Eingabelimits.
• Fehlerhafte Zeilen werden im exportierten Ergebnis ausgegeben und in den Aufgabenzählern berücksichtigt.
• Die obigen Felder basieren auf dem aktuellen Live-Sample und können sich ändern, wenn sich das vorgelagerte Exportschema ändert.