اعثر على أرقام الهاتف المحمول المتاحة

تأكد من تفعيل مخزون أرقام الهاتف المحمول

استخدم هذا البحث فقط بعد تفعيل مخزون أرقام الهاتف المحمول لحساب العميل الخاص بك. احصل على بادئة محمول فردية حالية من خلال سير عمل الاكتشاف الخاص بالحساب. يستعلم المسار المدعوم عن المخزون اللاسلكي لتلك البادئة. وهو لا يعتمد على سجل مطابق لبيانات توجيه الخطوط الثابتة. تواصل مع الدعم إذا لم تكن متأكدًا من تفعيل حسابك أو البادئة.

لا يرفض المسار القديم الحالي كل طلب غير مؤهل بطريقة موثوقة. يمكن أن يتلقى حساب غير مُفعَّل به مخزون أرقام الهاتف المحمول مخزونًا عاديًا بينما تظل الاستجابة تقول info.is_mobile: 1. يمكن أن تصل بادئة الرقم المجاني أيضًا إلى فرع مخزون الأرقام المجانية بذلك التصنيف. لا تستخدم هذا التصنيف وحده لتحديد خدمة الهاتف المحمول، ولا ترسل بادئات عادية أو مجانية إلى نقطة النهاية هذه. استخدم كتالوج الهاتف المحمول المؤكد للحساب وسير العمل المُفعَّل.

احتفظ بكل رقم مع اختيار السعر الخاص به

لكل مرشح، احتفظ بـ number، info.uuid وقائمة price الخاصة بنفس الإدخال معًا. تحتوي الاستجابة أيضًا على بيانات وصفية للبادئة/المنطقة/البلد وشروط العقد وقيود التسجيل. يتم ترتيب المرشحين تصاعديًا حسب السعر الشهري لخيار السعر الأول لكل منهم؛ ولا يوجد ترتيب ثابت مضمون للأسعار المتساوية. لا تستبدل معرف الرقم المُعاد بمعرف منطقة أو بادئة، ولا تربطه بمعرف سعر مرشح آخر.

يمكن أن تتضمن الاستجابة الكاملة حقول بيانات وصفية وحقول أسعار إضافية. كل من features، وقيم القنوات وrestrictions يصف المرشح؛ وهي ليست ضمانًا بأن المكالمات أو الرسائل القصيرة أو MMS أو الفاكس قابلة للاستخدام بالفعل. ما زالت أذونات الحساب والتسجيل وخطة الخدمة المختارة تنطبق. لا تتعامل مع العناصر النائبة في المثال على أنها معرفات أو أسعار صالحة.

استخدم كمية موجبة صغيرة

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

ميز بين نقص المخزون وفشل الاستعلام

يمكن أن تمثل استجابة 404 مخزونًا غير متاح أو خدمة معطلة أو فشلًا في استعلام المورد أو سجلات كتالوج غير صالحة. تعامل مع انتهاء المهلة أو فشل الموفر على أنه توافر غير معروف وليس مخزونًا صفريًا مؤكدًا. حدّث الاختيار وأعد المحاولة بتراجع تدريجي عند الاقتضاء. تجنب استقصاء كل مقسم بشكل متكرر. نقطة النهاية المنفصلة لعدّ مخزون الهاتف المحمول هي تلميح لقطة لحظية ولا يلزم أن تطابق طول قائمة المرشحين لهذا الحساب.

أعد التحقق قبل الشراء

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

الطلب

استخدم حساب API مُفعَّلًا عبر HTTPS من عنوان IP مصدر مسموح به. يجب أيضًا تفعيل مخزون أرقام الهاتف المحمول لحساب العميل؛ فمصادقة API وحدها لا تفعّله.

GET مع معرف البادئة الفردية الحالية وكمية موجبة بصيغة عدد صحيح في مسار URL. تكون الكمية افتراضيًا 1 إذا حُذفت. استخدم المثال بالقيمة 1؛ هذا المسار لا يتحقق بشكل متسق من حد نتائج عالمي ولا يفرضه.

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

الاستجابة

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

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

{
  "status": {
    "code": 200,
    "msg": "Results: 1",
    "results": 1
  },
  "response": [
    {
      "number": "12025550123",
      "info": {
        "uuid": "NUMBER_ID",
        "prefix_uuid": "PREFIX_ID",
        "country_iso": "US",
        "is_mobile": 1
      },
      "price": [
        {
          "uuid": "PRICE_ID",
          "monthly_price": "ACCOUNT_MONTHLY_PRICE",
          "setup_price": "ACCOUNT_SETUP_PRICE",
          "per_minute": "ACCOUNT_INCOMING_RATE",
          "channels": "PLAN_CHANNELS"
        }
      ],
      "features": [
        "voice",
        "sms",
        "mms",
        "t38"
      ]
    }
  ]
}

الأخطاء

• 404: معرف بادئة أو بلد أو منطقة غير صالح: حدّث اختيار بادئة الهاتف المحمول الفردية.
• 404: لم يتم العثور على أرقام: قد يعني عدم وجود مخزون قابل للاستخدام أو خدمة معطلة أو فشل استعلام الموفر أو اختيار غير مدعوم أو قيود على الحساب. وهو ليس دليلًا على عدد مخزون صفري موثوق.

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

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