URL Unduhan

GET/v1/tasks/{token}/result

Setelah selesai, ambil URL unduh untuk berkas hasil. Berkas disimpan selama 7 hari secara default (dikontrol oleh setting result_retention_days).

Contoh Respons

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

Bidang Respons

Field	Tipe	Deskripsi
task_id	string	Token yang Anda pakai untuk polling dan mengunduh. Ini adalah parameter path {token} pada endpoint tugas.
download_url	string (URL)	URL file hasil. Memerlukan kunci API yang sama seperti setiap panggilan lainnya.
expires_at	string (ISO 8601) | null	Kapan file tidak lagi dapat diunduh.
summary.submitted	integer	Baris yang diterima dalam pengiriman.
summary.prefiltered	integer	Baris yang dibuang sebelum deteksi — misalnya baris yang formatnya salah.
summary.deduped	integer	Baris duplikat yang dihapus.
summary.total	integer	Baris yang benar-benar masuk antrean untuk deteksi, setelah penyaringan awal dan penghapusan duplikat.
summary.valid	integer	Baris yang dipastikan terdaftar.
summary.invalid	integer	Baris yang dipastikan tidak terdaftar.
summary.unknown	integer	Baris yang tidak dapat diselesaikan oleh penyedia.
summary.unknown_processed	integer	Baris unknown yang dicoba ulang dan telah selesai.
summary.unknown_unprocessed	integer	Baris unknown yang masih belum terselesaikan. Biaya untuk baris ini dikembalikan.

Perhatian

Unduh berkas sebelum expires_at. Berkas hasil yang kedaluwarsa dihapus permanen dan tidak dapat dipulihkan.

Unduh berkas hasil

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

Mengalirkan berkas hasil yang sudah selesai langsung sebagai lampiran. Anda bisa mengikuti download_url dari endpoint hasil, atau memanggil endpoint ini dengan token tugas yang sama.

Setelah masa simpan berakhir, berkas dihapus dan endpoint ini mengembalikan 404 — tugas harus dikirim ulang untuk membuatnya kembali.

• 404 — task_id tidak ada atau milik akun lain.
• 404 — File hasil sudah kedaluwarsa, hilang, atau tidak tersedia.
• 422 — Tugas belum selesai, atau file hasilnya belum dibuat.

Berikutnya

• Contoh massal — seluruh siklus kirim → polling → unduh dalam satu skrip