Валидация Email

Скачать результаты в ZIP-архиве

Возвращает результаты валидации в виде ZIP-архива с тремя текстовыми файлами, готовыми для загрузки в ESP или CRM.

Содержимое архива:

  • good.txt — валидные адреса (по одному на строку)
  • bad.txt — невалидные адреса
  • unknown.txt — адреса, по которым доставляемость определить не удалось, плюс ещё не проверенные

Адреса из unknown.txt не стоит ни отправлять, ни удалять вслепую: обычно это временно недоступные домены, которые имеет смысл перепроверить позже.

Когда использовать: Этот формат удобен, когда вам нужен чистый список адресов без дополнительных колонок — например, для загрузки в рассылочный сервис. Если нужен детальный отчёт с причинами отклонения, используйте CSV-формат: GET /api/v1/tasks/:taskId/results/csv.

Важно: результаты доступны только для задач в статусе completed. Проверьте статус задачи через GET /api/v1/tasks/:taskId перед скачиванием.

get/api/v1/tasks/{taskId}/download

Request

  • Base URL: https://api.uchecker.net
  • URL: https://api.uchecker.net/api/v1/tasks/{taskId}/download
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key
    • HTTP bearer

Path parameters

taskIdnumber required
Example:123

Числовой идентификатор задачи

Query parameters

sep'comma' | 'semicolon'

Разделитель колонок в bad_unknown_reasons.csv. По умолчанию запятая.

bom'1'

1 — метка UTF-8 в начале bad_unknown_reasons.csv, чтобы Excel прочёл кириллицу.

Response

ZIP-архив: good.txt, bad.txt, unknown.txt — списки адресов, и bad_unknown_reasons.csv — все адреса с причиной (email, вердикт, текст ответа сервера). Content-Type: application/zip.

Changes

No recorded changes to this operation across all 1 revision of this API.