API проверки электронной почты HTX: Проверка электронной почты в массовом порядке

Проверьте, зарегистрирована ли электронная почта в файле на HTX. Использует task_type htx_email и тот же поток опроса партий, что и другие сервисы на основе электронной почты.

Загрузка файла для проверки — пример:

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

Проверка статуса задачи — пример:

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

Ответ после успешной загрузки

{
    "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"
}

Ответ при обработке

{
    "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
}

Ответ при завершении (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"
    }
}

URL запроса загрузки файла

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

Параметры запроса загрузки файла

Параметр	Описание
`file`	`file`, один адрес электронной почты в строке
`task_type`	`string`, установите на `htx_email`

URL запроса проверки статуса задачи

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

Параметры запроса проверки статуса задачи

Параметр	Описание
`task_id`	`string`, ID задачи, возвращенный при создании задачи

Поля результата

Поле	Описание
`Email`	Адрес электронной почты
`htx`	Зарегистрирована ли электронная почта на HTX (`yes` / `no`; метки в зависимости от экспорта)

Формат ответа

Поле	Описание
`created_at`	Временная метка создания задачи
`updated_at`	Временная метка последнего обновления статуса задачи
`task_id`	Уникальный идентификатор задачи
`user_id`	ID пользователя
`status`	`pending` · `processing` · `exported` · `failed` (сумма возвращается автоматически)
`total`	Всего обработано адресов электронной почты
`success`	Адреса электронной почты успешно проверены
`failure`	Строки, которые не удалось обработать
`result_url`	URL загрузки, когда `status` равен `exported`
`actual_amount`	(Необязательно) Фактически списанная сумма, возвращается после завершения расчёта по задаче
`estimated_amount`	(Ответ при создании) Ориентировочная стоимость задачи; окончательное списание происходит после её завершения

Коды состояния

Состояние	Описание
`200`	`free`, запрос успешно выполнен (например, запрос статуса)
`202`	`charge`, задача успешно создана; списывается ориентировочная сумма
`400`	`free`, неверный запрос: недопустимые параметры или формат файла, неподдерживаемый тип задачи или количество корректных записей меньше минимального
`401`	`free`, отсутствует или недействителен API-ключ
`402`	`free`, недостаточно средств на балансе
`404`	`free`, задача не найдена
`413`	`free`, загруженный файл слишком большой
`500`	`free`, внутренняя ошибка сервера, повторите попытку позже