جلب رابط التنزيل

GET/v1/tasks/{token}/result

بعد الاكتمال، احصل على رابط تنزيل ملف النتائج. تحفظ الملفات افتراضيا لمدة 7 أيام (حسب إعداد النظام result_retention_days).

مثال الاستجابة

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

حقول الاستجابة

الحقل	النوع	الوصف
task_id	string	الرمز الذي تستعلم به وتنزّل عبره. وهو المعامل {token} في مسار نقاط نهاية المهمة.
download_url	string (URL)	عنوان URL لملف النتائج. ويتطلب مفتاح API نفسه كسائر الطلبات.
expires_at	string (ISO 8601) | null	وقت توقف إمكانية تنزيل الملف.
summary.submitted	integer	الصفوف المستلمة في الإرسال.
summary.prefiltered	integer	الصفوف المستبعدة قبل الفحص — أسطر مشوّهة مثلًا.
summary.deduped	integer	الصفوف المكررة المحذوفة.
summary.total	integer	الصفوف الموضوعة فعليًا في قائمة انتظار الفحص، بعد الفلترة المسبقة وإزالة التكرار.
summary.valid	integer	الصفوف المؤكدة كمسجّلة.
summary.invalid	integer	الصفوف المؤكدة كغير مسجّلة.
summary.unknown	integer	الصفوف التي تعذّر على المزوّد حسمها.
summary.unknown_processed	integer	الصفوف المجهولة التي أُعيدت محاولتها وسُوّيت.
summary.unknown_unprocessed	integer	الصفوف المجهولة التي لا تزال دون حسم. ويُسترد مقابلها.

تنبيه

نزّل الملف قبل expires_at. تُحذف ملفات النتائج المنتهية نهائيًا ولا يمكن استعادتها.

تنزيل ملف النتائج

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

يُرسل ملف النتائج الجاهز مباشرة كمُرفق. يمكنك اتباع download_url العائد من نقطة النتيجة، أو استدعاء هذه النقطة بالرمز نفسه للمهمة.

بعد انتهاء مدة الاحتفاظ يُحذف الملف وتُعيد هذه النقطة 404، ويلزم إرسال المهمة من جديد لإعادة إنشائه.

• 404 — قيمة task_id غير موجودة أو تنتمي إلى حساب آخر.
• 404 — ملف النتائج منتهي الصلاحية أو مفقود أو غير متاح.
• 422 — المهمة لم تكتمل، أو لم يُنشأ ملف نتائجها بعد.

التالي

• أمثلة الدفعات — دورة الإرسال ← الاستعلام ← التنزيل كاملة في سكربت واحد