تحقق من مخزون الهواتف المحمولة لبدال اتصال

اختر بادئة مدعومة

استخدم بادئة محمول فردية حديثة من نتائج الاستكشاف. هذه النقطة مخصصة لبدالات NANPA: يحدد NPA رمز المنطقة، ويحدد NXX البدال. البادئة التي تحتوي على رمز المنطقة فقط واسعة جدًا. لا ترسل معرفات عرض مجمعة ولا تستنتج دعم بلد آخر لمجرد أن بادئته تحتوي على عدد كافٍ من الأرقام.

استخدم العدد كمؤشر فقط

اقرأ response.count، مع response.npa و response.nxx التي تحدد البدال. هذه لقطة من خدمة التغطية، وليست مخزونًا محجوزًا لحسابك. أكد الأرقام الفعلية وعروض الأسعار المعمول بها وأي متطلبات تسجيل قبل الطلب. لا يفوض العدد الناجح عملية شراء أبدًا.

ميز المخزون الصفري عن فشل البحث

العدد الناجح الذي يساوي صفرًا يختلف عن خطأ في واجهة برمجة التطبيقات. افحص status.code و status.msg بالإضافة إلى حالة HTTP. تعامل مع انتهاء المهلة أو فشل البحث باعتباره توفرًا غير معروف وأعد المحاولة لاحقًا مع تراجع تدريجي.

الطلب

استخدم بيانات اعتماد حساب API المفعّل لديك عبر HTTPS. تُدعَم مصادقة Basic ورموز Bearer لحسابات API المفعّلة؛ وتنطبق قيود الحساب.

GET مع معرف البادئة في مسار URL. لا توجد معلمات استعلام أو معلمات نص موثقة.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"

الاستجابة

تحقق من status.code في نص JSON بالإضافة إلى حالة HTTP. response الناجح لديه status.code بقيمة 200 وstatus.msg بقيمة Results. response هو كائن وليس قائمة: count هو لقطة مخزون بعدد صحيح؛ وnpa وnxx سلسلتان من ثلاثة أحرف. status.results غير موجود لهذا الكائن الترابطي. العدد 0 يعني أن بحث التغطية لم يجد بدالا مطابقًا أو أعاد مخزونًا صفريًا؛ ولا يثبت أن جميع الموردين أو مسارات الاستكشاف الأخرى لا تملك أرقامًا.

شكل استجابة توضيحي؛ ليس بيانات حساب فعلية ولا عرض سعر حالي.

{
  "status": {
    "code": 200,
    "msg": "Results"
  },
  "response": {
    "count": 42,
    "npa": "212",
    "nxx": "555"
  }
}

الأخطاء

• 404: المزود معطل: تغطية مخزون الهواتف المحمولة غير متاحة على الخدمة.
• 404: معرف بادئة غير صالح: احصل على معرف بادئة فردية حديث من الاستكشاف.
• 404: بادئة غير صالحة: البادئة المخزنة لا تحتوي على عدد كاف من الأرقام لإجراء بحث NPA/NXX.
• 500: فشلت تغطية المخزون: لم يرجع البحث المنبعي نتيجة تغطية ناجحة. أعد المحاولة لاحقًا مع تراجع تدريجي؛ الفشل لا يعني عدد مخزون يساوي صفرًا.

التوفر والآثار الجانبية

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