عرض قائمة الأرقام المشتراة

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

الطلب

استخدم بيانات اعتماد واجهة API على جانب الخادم عبر HTTPS. تقرأ الأمثلة بيانات الاعتماد من متغيرات البيئة؛ ولا تتضمن أي بيانات اعتماد صالحة للاستخدام. افحص status.code في محتوى JSON، إلى جانب حالة HTTP. لا تضبط هذه المعالجات القديمة حالة خطأ HTTP بصورة متسقة عند حدوث خطأ في التطبيق.

curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
  "https://api.multitel.net/v3/inventory"

للتصفية حسب رقم هاتف مخزن واحد، استخدم صيغة المسار الاختيارية:

curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
  "https://api.multitel.net/v3/inventory/12025550100"

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

الاستجابة

العنصر response يكون دائماً مصفوفة عند النجاح، بما في ذلك عند استخدام صيغة المسار لرقم واحد. قيمة status.results هي طول المصفوفة.

هذا مثال توضيحي لبنية الاستجابة، وليس بيانات حساب أو عرض سعر حالي.

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "number": "12025550100",
      "uuid": "NUMBER_UUID",
      "description": "Main reception",
      "isocode": "US",
      "config": {
        "uri": "sip:reception@example.com",
        "uri2": "",
        "uri3": "",
        "forward_destination": "",
        "sms_uri": "",
        "sms_forward_destination": ""
      },
      "features": {
        "voice": "1",
        "sms": "1",
        "mms": "0"
      },
      "status": {
        "capacity": {
          "assigned_channels": "2",
          "used_channels": "0",
          "overflow": "0",
          "overage_charge": "0.01"
        },
        "origination": {
          "origination_trunk_id": "ORIGINATION_ID",
          "origination_trunk_name": "ORIGINATION_NAME",
          "origination_country_iso": "US",
          "origination_continent_iso": "NA",
          "origination_continent_name": "North America"
        },
        "service_active": "1",
        "force_codec": "",
        "force_dtmf": ""
      },
      "billing": {
        "cnam": "0",
        "overflow": "0",
        "autorenew": "1",
        "persistent": "0",
        "date_created": "2026-01-01 00:00:00"
      },
      "price": {
        "setup_price": "0.00",
        "monthly_price": "1.00",
        "per_minute": "0.01",
        "free_minutes": "0",
        "remaining_minutes": "0"
      }
    }
  ]
}

حقول الأرقام المُرجعة
الحقل	المعنى
`number, uuid, description, isocode`	رقم الهاتف المخزن، ومعرّف الرقم الذي لا تُستنتج دلالة من بنيته، والوصف، ورمز البلد.
`config`	الحقول المخزنة لوجهات المكالمات الصوتية والتحويل الخارجي ووجهة الرسائل النصية القصيرة وتحويلها. لا تعدّل نقطة النهاية هذه تلك الحقول.
`features`	المؤشرات المخزنة لإمكانات المكالمات الصوتية والرسائل النصية القصيرة ورسائل الوسائط المتعددة. ليس مضموناً أن تكون المؤشرات القديمة المخزنة قيماً منطقية في JSON.
`status.capacity`	قيم القنوات المخصصة والمستخدمة، وإعداد تجاوز السعة، ورسوم الاستخدام الزائد المخزنة. هذه بيانات وصفية مخزنة، وليست عرضاً حديثاً للسعة أو اختباراً لمكالمة فعلية.
`status.origination`	البيانات الوصفية المخزنة لمنشأ المكالمات. تعامل مع المعرّفات على أنها قيم لا تُستنتج دلالة من بنيتها؛ ولا تستمد منطق التطبيق من الأسماء الداخلية.
`status.service_active, force_codec, force_dtmf`	حقول التفعيل وإعدادات الوسائط المخزنة. لا يثبت المؤشر وحده نجاح إيصال المكالمات الواردة.
`billing`	القيم المخزنة لاسم المتصل CNAM وتجاوز السعة والتجديد والاستمرارية والإنشاء. لا تؤدي قراءتها إلى تغيير إعدادات التجديد أو غيرها من إعدادات الفوترة.
`price`	أسعار التهيئة والاشتراك الشهري والدقيقة، وحصص الدقائق المخزنة. لا يوفر المعالج حقلاً للعملة أو عرض سعر حديثاً. لا تستنتج العملة من قيم المثال ولا تستخدمها بوصفها عرض سعر حالياً للشراء.

التصفية وتقسيم النتائج إلى صفحات

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

لا توجد أرقام مطابقة

إذا لم تكن للحساب أي سجلات مطابقة غير ملغاة، فإن محتوى JSON يتضمن الحقل status.code بالقيمة 404 ورسالة تحتوي على no numbers found. ولا يُرجع مصفوفة فارغة تدل على النجاح. تتضمن الرسالة لاحقة تشير إلى مرجع في المصدر، وينبغي ألا تحللها التطبيقات العميلة بوصفها معرّفاً ثابتاً.

الخطوات التالية

استخدم numberinfo عندما تحتاج إلى حقول التسجيل ومرجع الرقم الإضافية القديمة لرقم واحد. افحص وجهات المكالمات الصوتية والرسائل قبل تغيير أي مسار من خلال عملية منفصلة لضبط الإعدادات.