Bỏ qua để đến nội dung

Lấy URL tải xuống

GET/v1/tasks/{token}/result

Sau khi hoàn tất, lấy URL tải xuống cho tệp kết quả. Mặc định tệp được giữ 7 ngày (do cài đặt hệ thống result_retention_days kiểm soát).

Ví dụ phản hồi

{
  "task_id": "xKj9aP3qLm7v",
  "download_url": "https://api.zelnum.com/api/v1/tasks/xKj9aP3qLm7v/download",
  "expires_at": "2026-05-02T10:00:00+00:00",
  "summary": {
    "submitted": 5000,
    "prefiltered": 0,
    "deduped": 0,
    "total": 5000,
    "valid": 3800,
    "invalid": 1200,
    "unknown": 0,
    "unknown_processed": 0,
    "unknown_unprocessed": 0
  }
}

Trường phản hồi

Trường	Kiểu	Mô tả
`task_id`	string	Token dùng để thăm dò và tải xuống. Đây là tham số đường dẫn `{token}` của các endpoint tác vụ.
`download_url`	string (URL)	URL của tệp kết quả. Cần cùng API key như mọi lệnh gọi khác.
`expires_at`	string (ISO 8601) \| null	Thời điểm tệp không còn tải được.
`summary.submitted`	integer	Số dòng nhận được trong lần gửi.
`summary.prefiltered`	integer	Số dòng bị loại trước khi phát hiện — ví dụ các dòng sai định dạng.
`summary.deduped`	integer	Số dòng trùng lặp đã bị loại bỏ.
`summary.total`	integer	Số dòng thực sự được đưa vào hàng đợi phát hiện, sau khi lọc trước và loại trùng.
`summary.valid`	integer	Số dòng được xác nhận là đã đăng ký.
`summary.invalid`	integer	Số dòng được xác nhận là chưa đăng ký.
`summary.unknown`	integer	Số dòng mà nhà cung cấp không thể phân giải.
`summary.unknown_processed`	integer	Các dòng không phân giải được đã được thử lại và quyết toán.
`summary.unknown_unprocessed`	integer	Các dòng không phân giải được vẫn chưa xử lý. Những dòng này được hoàn tiền.

Tải tệp kết quả

GET/v1/tasks/{token}/download

curl -X GET "https://api.zelnum.com/api/v1/tasks/xKj9aP3qLm7v/download" \
  -H "X-API-Key: YOUR_KEY_HERE" \
  -o result.zip

Truyền trực tiếp tệp kết quả đã hoàn tất dưới dạng tệp đính kèm. Bạn có thể theo download_url từ endpoint kết quả, hoặc gọi endpoint này với cùng token nhiệm vụ.

Khi hết thời hạn lưu trữ, tệp bị xóa và endpoint này trả về 404 — cần gửi lại nhiệm vụ để tạo lại tệp.

404 — task_id không tồn tại hoặc thuộc về tài khoản khác.
404 — Tệp kết quả đã hết hạn, không tồn tại hoặc không khả dụng.
422 — Tác vụ chưa hoàn tất hoặc tệp kết quả chưa được tạo.

Tiếp theo

Ví dụ hàng loạt — toàn bộ chu trình gửi → thăm dò → tải xuống trong một script