E-Mail-Zustellbarkeitsprüfer API

Wählen Sie pro Upload einen Aufgabentyp: email_check für die Zustellbarkeit oder email_avatar für Avatare. Beide verwenden den folgenden asynchronen Stapelablauf.

Zustellbarkeitsprüfer (email_check)

Prüft, ob E-Mail-Adressen aktiv sind und E-Mails empfangen können. Unterstützt ausschließlich Gmail, Yandex, Mail.ru, iCloud, Outlook und Yahoo.

Avatar-Prüfer (email_avatar)

Prüft, ob E-Mail-Adressen einen öffentlichen Avatar haben, und gibt dessen URL zurück. Unterstützt ausschließlich Gmail, Yandex und Mail.ru.

Adressen außerhalb der genannten Anbieter und ihrer unterstützten Alias-Domains werden weder verarbeitet noch in Ergebnisse oder Abrechnung aufgenommen.

Eingabeformat

Laden Sie eine Textdatei mit einer unterstützten E-Mail-Adresse pro Zeile hoch.

user@gmail.com
another@yandex.com

Aufgabe erstellen

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

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

Avatar-Prüfer (email_avatar)

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

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.numberchecker.ai/v1/gettasks

curl --location 'https://api.numberchecker.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

Zustellbarkeitsprüfer (email_check)

Feld	Beschreibung	Beispiel
email	E-Mail-Adresse aus der übermittelten Datei.	user@gmail.com
activated	Gibt an, ob der Wert als aktiv oder registriert erkannt wurde.	yes

Avatar-Prüfer (email_avatar)

Feld	Beschreibung	Beispiel
email	Eingegebene E-Mail-Adresse aus der übermittelten Datei.	user@gmail.com
activated	Gibt an, ob die Adresse einen öffentlichen Avatar hat.	yes
avatar	URL des Avatarbilds, falls vorhanden; leer bei Standard-Platzhalter.	https://…
name	Anzeigename, sofern der Anbieter ihn offenlegt; sonst leer.	John Doe

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.