تخطَّ إلى المحتوى

إرسال فحص (مصفوفة)

POST/v1/detect

أرسل مصفوفة من أرقام الهاتف للفحص. تتم المعالجة بشكل غير متزامن. يتم خصم التكلفة مسبقا؛ والأرقام غير المفحوصة ترد تلقائيا.

HTTP 202 Accepted

المعاملات

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

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

{
  "mode": "async",
  "task_id": "xKj9aP3qLm7v",
  "idempotent_replay": false,
  "message": "Task queued. Poll GET /api/v1/tasks/xKj9aP3qLm7v for progress.",
  "recovery_pending": false,
  "summary": {
    "total": 5000,
    "cost_deducted": 0.500000
  }
}

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

الحقل	النوع	الوصف
`mode`	string	دائمًا `async` لإرسالات الدفعات.
`task_id`	string	الرمز الذي تستعلم به وتنزّل عبره. وهو المعامل `{token}` في مسار نقاط نهاية المهمة.
`idempotent_replay`	boolean	`true` عندما أعاد الإرسال استخدام مهمة سابقة بدل إنشاء مهمة جديدة.
`recovery_pending`	boolean	`true` عندما تكون المهمة في قائمة الانتظار ولا تزال محاسبتها قيد التسوية.
`message`	string	الخطوة التالية بصيغة مقروءة.
`summary.total`	integer	الصفوف المقبولة.
`summary.cost_deducted`	number	المبلغ المخصوم مسبقًا عن الإرسال.

التالي

أرسل ملفًا بدلًا من مصفوفة
استعلم عن حالة المهمة حتى ينتهي العمل