HTX-E-Mail-Prüfer-API: E-Mail-Prüfung im Stapel

Prüfen, ob die E-Mail-Adressen in Ihrer Datei Konten bei HTX haben. Der Ablauf entspricht den Stapelaufgaben anderer Social-Media- und Messenger-Prüfer.

Beispiel zum Hochladen der Prüfdatei:

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./emails.txt"' \
--form 'task_type="htx_email"'

Beispiel zum Prüfen des Aufgabenstatus:

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

Antwort nach erfolgreichem Hochladen

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2049,
    "estimated_amount": {
        "amount": "0.500000",
        "currency": "USD"
    },
    "message": "Task created successfully",
    "created_at": "2025-11-21T15:58:08.916446594Z"
}

Antwort waehrend der Verarbeitung

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2049,
    "success": 1024,
    "failure": 0
}

Antwort nach Abschluss (exported)

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2049,
    "success": 2049,
    "failure": 0,
    "result_url": "https://example-link-to-results.zip",
    "actual_amount": {
      "amount": "2.000000",
      "currency": "USD"
    }
}

Anfrage-URL zum Hochladen der Datei

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

Anfrageparameter zum Hochladen der Datei

Parameter	Beschreibung
`file`	`file`, eine E-Mail-Adresse pro Zeile
`task_type`	`string`, auf `htx_email` setzen

Anfrage-URL zum Prüfen des Aufgabenstatus

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

Anfrageparameter zum Prüfen des Aufgabenstatus

Parameter	Beschreibung
`task_id`	`string`, Aufgaben-ID aus der Aufgabenerstellung

Ergebnisfelder

Feld	Beschreibung
`Email`	E-Mail-Adresse
`htx`	Ob die E-Mail-Adresse bei HTX registriert ist (Werte `yes` / `no`; Bezeichnungen gemäß Export)

Antwortformat

Feld	Beschreibung
`created_at`	Zeitstempel der Aufgabenerstellung
`updated_at`	Zeitstempel der letzten Statusaktualisierung
`task_id`	Eindeutige Aufgabenkennung
`user_id`	Benutzer-ID
`status`	`pending` · `processing` · `exported` · `failed` (wird automatisch erstattet)
`total`	Insgesamt verarbeitete E-Mail-Adressen
`success`	Erfolgreich identifizierte E-Mail-Adressen
`failure`	E-Mail-Adressen mit fehlgeschlagener Verarbeitung
`result_url`	Download-URL bei Status `exported`
`actual_amount`	(Optional) Tatsächlich abgerechneter Betrag, verfügbar nach Abrechnung der Aufgabe
`estimated_amount`	(Antwort bei Aufgabenerstellung) Geschätzter Betrag; die endgültige Abrechnung erfolgt nach Abschluss der Aufgabe

Statuscodes

Status	Beschreibung
`200`	`free`, Anfrage erfolgreich (z. B. Statusabfrage)
`202`	`charge`, Aufgabe erfolgreich erstellt; der geschätzte Betrag wird abgebucht
`400`	`free`, Ungültige Anfrage: Parameter oder Dateiformat fehlerhaft, Aufgabentyp nicht unterstützt oder weniger gültige Einträge als die Mindestmenge
`401`	`free`, Fehlender oder ungültiger API-Schlüssel
`402`	`free`, Unzureichendes Guthaben
`404`	`free`, Aufgabe nicht gefunden
`413`	`free`, Hochgeladene Datei zu groß
`500`	`free`, Interner Serverfehler; bitte später erneut versuchen