نمبر منتقلی کے منصوبے کے واقعات پڑھیں

اکاؤنٹ اور منصوبے تک رسائی

اجازت یافتہ IP پتے سے HTTPS کے ذریعے ایک فعال API اکاؤنٹ استعمال کریں۔ منصوبہ اسی اکاؤنٹ کی ملکیت ہونا چاہیے اور حذف شدہ نہیں ہونا چاہیے۔ نمبر منتقلی کا آرڈر دینے کے طریقۂ کار سے حاصل کردہ منصوبے کا منفرد شناخت کنندہ استعمال کریں، اس کا عددی ڈیٹابیس شناخت کنندہ یا کوئی فون نمبر نہیں۔ درخواست بناتے وقت منصوبے کے شناخت کنندہ پر 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 پتے کی پابندیاں بھی لاگو ہوتی ہیں۔ مثالیں کوئی حقیقی درخواست نہیں بھیجتیں، اور کامیاب جواب اس بات کا ثبوت نہیں ہے کہ کسی ٹیلی کام آپریٹر نے نمبر منتقلی قبول یا مکمل کر لی ہے۔

اثرات

جس ہینڈلر کا جائزہ لیا گیا ہے وہ محفوظ شدہ واقعات پڑھتا ہے اور نہ منصوبے میں تبدیلی کرتا ہے، نہ نمبر منتقلی شروع کرتا ہے اور نہ اکاؤنٹ سے رقم کاٹتا ہے۔ واقعات لکھنے والے اجزا کی مرئیت اور توثیق شدہ اکاؤنٹ کے ساتھ جانچ اب بھی انٹرفیس کے معاہدے کے زیر التوا جائزے کا حصہ ہیں۔