قراءة بيانات رقم واحد تم شراؤه

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

الطلب

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

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

مقطع المسار المطلوب هو رقم الهاتف الدولي المخزن، وليس معرّف UUID الخاص به أو رقمًا داخليًا في مقسم PBX. لا يستخدم هذا المعالج أي معاملات استعلام أو متن طلب.

الاستجابة

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

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "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",
      "perminute_charges": "0"
    },
    "needs_registration": "0",
    "vrating": "",
    "country_id": "COUNTRY_REFERENCE",
    "area_id": "AREA_REFERENCE",
    "provider_id": "OPAQUE_LEGACY_REFERENCE"
  }
}

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

بالمقارنة مع inventory، تُرجع نقطة النهاية هذه أيضًا needs_registration، vrating، country_id، area_id، provider_id وprice.perminute_charges. هذه قيم قديمة مخزنة، وليست استجابة منفصلة للموافقة على الهوية. ينبغي التعامل مع المعرّفات المرجعية باعتبارها قيمًا لا تُستنبط دلالة من بنيتها؛ فلا تُنشئ منها عناوين URL للاستكشاف ولا تستنتج منها ارتباطات بمزوّدي الخدمة دون استجابة الاستكشاف المناسبة.

لا يوجد رقم مطابق

إذا لم يُعثر للحساب الذي تمت مصادقته على سجل مطابق غير ملغى، فإن متن JSON يتضمن status.code بقيمة 404 ورسالة تتضمن number not found. لا تعتمد على اللاحقة التي تشير إلى سطر الشيفرة المصدرية في الرسالة. تحقّق من الرقم المخزن ومن inventory قبل إعادة المحاولة.

استخدام النتيجة

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