Скачать результаты в формате CSV
Возвращает результаты валидации как скачиваемый CSV-файл. Браузер и HTTP-клиенты автоматически предложат сохранить файл.
Формат файла:
- Кодировка: UTF-8
- Разделитель: запятая, экранирование по RFC 4180
- Колонки: email, validation_result, reason
- Первая строка — заголовки
Обратите внимание: третья колонка здесь называется reason и содержит текст ответа сервера. Это не то же самое, что двухколоночный CSV из GET /api/v1/tasks/:taskId/results?format=csv.
Пример содержимого:
email,validation_result,reason
user@gmail.com,good,
bad@nonexistent.xyz,bad,"550-5.1.1 The email account is currently not functioning and is unable to receive messages."
risky@example.com,unknown,"550 5.1.2 <risk> No MX records found"
notyet@example.com,pending,
Когда использовать: Если вам нужен единый файл со всеми результатами для импорта в Excel, Google Sheets или CRM. Для разделённых списков (отдельно валидные и невалидные) используйте GET /api/v1/tasks/:taskId/download — он возвращает ZIP-архив.
Важно: результаты доступны только для задач в статусе completed.
Request
- Base URL: https://api.uchecker.net
- URL: https://api.uchecker.net/api/v1/tasks/{taskId}/results/csv
- Auth: one of:
- HTTP bearer
- API key in header x-api-key
Path parameters
Числовой идентификатор задачи
Query parameters
Только строки с этим вердиктом — как в колонке статуса: bad с маркером <risk> считается unknown.
Только строки с этой причиной отказа — ключ из reasons в GET /api/v1/tasks/:taskId/analytics. Выбирает ровно те строки, что посчитаны под этой причиной.
Разделитель колонок. По умолчанию запятая; semicolon — для русского Excel, который делит по точке с запятой.
1 — добавить в начало файла метку UTF-8 (BOM): без неё Excel открывает кириллицу кракозябрами. По умолчанию без метки.
Response
CSV-файл с результатами. Content-Type: text/csv, Content-Disposition: attachment.
Changes
No recorded changes to this operation across all 1 revision of this API.