إرسال فحص (رفع ملف)

POST/v1/detect/file

ارفع ملف TXT أو CSV يحتوي على رقم واحد في كل سطر، بحد أقصى 50 MB.

HTTP 202 Accepted

المعاملات

Content-Type: multipart/form-data

الحقل	النوع	مطلوب	الوصف
product	string	نعم	Slug المنتج — قائمة المنتجات
country	string	مطلوب للهاتف	منتجات الهاتف: رمز ISO 3166-1 alpha-2، مثل CN أو US. منتجات البريد الإلكتروني: احذف هذا الحقل تمامًا. — رموز الدول
file	file	نعم	ملف TXT أو CSV، رقم واحد في كل سطر، بحد أقصى 50 MB.

ملاحظة

يجب أن يبلغ الإرسال الحد الأدنى للمنتج المحدد — 500 أو 1,000 أو 2,000 حسب المنتج، وهو مبين في جدول منتجات الدفعات — وأن يبقى دون الحد الأقصى للمنصة البالغ 2,000,000. ويُرفض الإرسال الأقل من الحد الأدنى بالرمز too_few_numbers.

حقل country خاص بمنتجات الهاتف فقط

لا يوجد للبريد الإلكتروني بُعد دولة. وإرسال country مع منتج بريد إلكتروني يفشل التحقق. وهذا هو المقابل في نقاط النهاية الفورية، حيث country اختياري لكن يجب حذفه مع البريد الإلكتروني.

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

{
  "mode": "async",
  "task_id": "qH5rZ7Lp3Wm9",
  "idempotent_replay": false,
  "message": "File queued (10000 numbers). Poll GET /api/v1/tasks/qH5rZ7Lp3Wm9 for progress.",
  "recovery_pending": false,
  "summary": {
    "total": 10000,
    "cost_deducted": 1.000000
  }
}

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

إرسال فحص (أرقام)