عرض أنواع الأرقام المتاحة للتسجيل

اختر نوعًا باستخدام اسمه المُعاد

استخدم بلدًا من get_document_countries. مرّر اسم النوع المُعاد إلى get_requirements. معرّف النوع في الكتالوج ليس معرّف بادئة أو معرّف رقم أو معرّف فئة مستندات الإثبات.

أعداد المجموعات لا تمثّل مخزون الأرقام

available_groups يحصي سجلات المجموعات التي تُعيدها عملية البحث هذه في الكتالوج. ولا يحصي أرقام الهاتف المتاحة للشراء، ولا يحجز مخزونًا، ولا يضمن أن الكتالوج قد استنفد جميع صفحات المصدر الذي يعتمد عليه. ابحث في مخزون الأرقام ذي الصلة وراجع عرض سعر بشكل منفصل.

الطلب

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

GET مع وضع أي معلمة موثّقة في مسار عنوان URL.

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

الاستجابة

تحقّق من status.code في جسم JSON، وكذلك من حالة HTTP. response مصفوفة تحتوي على id وname وavailable_groups. استخدم name بوصفه قيمة number_type عند استدعاء get_requirements؛ ولا تُرسل id بدلًا منه. available_groups هو عدد سجلات المجموعات المُعادة لذلك النوع، وليس عدد أرقام الهاتف في المخزون أو إجماليًا كاملًا عبر جميع الصفحات. تُحذف الأنواع التي لم تُعَد لها أي مجموعات. الترتيب المفضّل هو Local، Mobile، National، Toll Free، Shared Cost، Global، ثم أسماء الكتالوج الأخرى.

بنية استجابة توضيحية؛ لا تمثّل بيانات حساب مباشرة أو عرض سعر حاليًا.

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "id": "NUMBER_TYPE_ID_FROM_RESPONSE",
      "name": "Local",
      "available_groups": 3
    }
  ]
}

الأخطاء

• 400: country is required: قدّم رمز ISO لبلد التسجيل.
• 400: Invalid country ISO or no available DID registration country found: اختر بلدًا من كتالوج التسجيل الحالي؛ فهذا لا يثبت عدم الحاجة إلى مستندات.

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

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