قراءة أحداث مشروع نقل الأرقام

الوصول إلى الحساب والمشروع

استخدم حساب API مفعّلًا عبر HTTPS من عنوان IP مسموح به. يجب أن يكون المشروع تابعًا لذلك الحساب وألّا يكون محذوفًا. استخدم المعرّف الفريد للمشروع الوارد في سير عمل طلب نقل الأرقام، وليس معرّفه الرقمي في قاعدة البيانات أو رقم هاتف. طبّق ترميز URL على معرّف المشروع عند إنشاء الطلب.

الطلب

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/lnp/project/$PROJECT_ID/events"

الاستجابة

مثال افتراضي على الاستجابة.

{
  "status": {
    "code": 200,
    "msg": "Project Events",
    "results": 1
  },
  "response": [
    {
      "id": 31,
      "subject": "Example project update",
      "event": "{\"type\":\"comment\",\"value\":\"Example update\",\"source\":\"Example source\"}",
      "type": "comment",
      "value": "Example update",
      "source": "Example source",
      "date_created": "2026-10-23 12:00:00"
    }
  ]
}

يُرجع المشروع الموجود الذي لا يتضمن أحداثًا رمز API بالقيمة 200 وقائمة فارغة وتكون قيمة status.results مساوية لـ 0. تُطلب النتائج بترتيب تنازلي حسب وقت الإنشاء، دون ترتيب إضافي عند تساوي الأوقات، ودون تقسيم إلى صفحات أو مؤشّر متابعة أو تصفية حسب التاريخ.

اقرأ بيانات الحدث بعناية

id هو المعرّف الرقمي لصف الحدث، وsubject هو عنوانه المخزّن، وdate_created هو قيمة التاريخ والوقت المخزّنة له. تحتفظ نقطة النهاية بالسلسلة النصية الخام event وتحاول أيضًا فك ترميز خصائصها type، value وsource. إذا لم تكن البيانات كائن JSON أو كانت إحدى الخصائص مفقودة، يكون الحقل المقابل الناتج عن التحليل سلسلة نصية فارغة.

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

السجل لا يضمن التسليم

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

الأخطاء والحدود

تحقّق من استجابة HTTP وكذلك من status.code/status.msg. يُرجع المشروع غير الموجود أو المحذوف أو غير التابع للحساب رمز API بالقيمة 404 مع رسالة تفيد بعدم العثور على المشروع. تنطبق أيضًا متطلبات المصادقة والقيود على عنوان IP المصدر. لا تنفّذ الأمثلة طلبًا فعليًا، ولا تُعدّ الاستجابة الناجحة دليلًا على أن شركة اتصالات قد قبلت عملية نقل الأرقام أو أتمّتها.

الآثار

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