سير العمل المعتاد

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

نقاط النهاية في لمحة

نقاط النهاية	الوصف
GET /v1/balance	يعيد رصيد USD الحالي للحساب الموثق.
POST /v1/detect	أرسل مصفوفة من أرقام الهاتف للفحص. تتم المعالجة بشكل غير متزامن. يتم خصم التكلفة مسبقا؛ والأرقام غير المفحوصة ترد تلقائيا.
POST /v1/detect/file	ارفع ملف TXT أو CSV يحتوي على رقم واحد في كل سطر، بحد أقصى 50 MB.
GET /v1/tasks/{token}	استعلم عن المهمة حتى تصبح مكتملة أو فاشلة. الفاصل الموصى به: 3–5 ثوان.
GET /v1/tasks/{token}/result	بعد الاكتمال، احصل على رابط تنزيل ملف النتائج. تحفظ الملفات افتراضيا لمدة 7 أيام (حسب إعداد النظام result_retention_days).
GET /v1/tasks/{token}/download	يُرسل ملف النتائج الجاهز مباشرة كمُرفق. يمكنك اتباع download_url العائد من نقطة النتيجة، أو استدعاء هذه النقطة بالرمز نفسه للمهمة.

HTTP 202 Accepted

قبل الإرسال

• يجب أن يبلغ الإرسال الحد الأدنى للمنتج المحدد — 500 أو 1,000 أو 2,000 حسب المنتج، وهو مبين في جدول منتجات الدفعات — وأن يبقى دون الحد الأقصى للمنصة البالغ 2,000,000. ويُرفض الإرسال الأقل من الحد الأدنى بالرمز too_few_numbers.
• منتجات الهاتف: رمز ISO 3166-1 alpha-2، مثل CN أو US. منتجات البريد الإلكتروني: احذف هذا الحقل تمامًا. — رموز الدول

ملاحظة

يخصم الفحص الجماعي كامل المبلغ عند الإرسال، ثم يعيد تلقائيًا قيمة الأرقام التي لم تُفحص (المُرشّحة أو المكرّرة أو غير المعالجة) عند انتهاء المهمة. ولا تدفع إلا مقابل الأرقام التي عُولجت فعلًا.