نمبر منتقلی کے منصوبے کی حالت معلوم کریں

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

اجازت یافتہ انٹرنیٹ پتے سے HTTPS کے ذریعے فعال API اکاؤنٹ استعمال کریں۔ منصوبہ اسی اکاؤنٹ کی ملکیت ہونا چاہیے اور حذف شدہ نہیں ہونا چاہیے۔ نمبر منتقلی کا آرڈر دینے کے عمل سے ملنے والا منصوبے کا منفرد شناخت کنندہ استعمال کریں، نہ کہ ڈیٹابیس میں اس کی عددی شناخت یا کوئی فون نمبر۔ درخواست بناتے وقت منصوبے کے شناخت کنندہ کو ویب پتے کی رمز بندی کے مطابق رمز بند کریں۔

درخواست

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

یہ اینڈ پوائنٹ درخواست کا متن، صفحہ بندی کے پیرامیٹر یا تاریخ کا فلٹر نہیں پڑھتا۔

جواب

فرضی جواب کی مثال۔

{
  "status": {
    "code": 200,
    "msg": "Project Status"
  },
  "response": {
    "uniqueid": "PROJECT_EXAMPLE",
    "status": 2,
    "status_str": "Completed",
    "counts": {
      "total": 2,
      "pending": 0,
      "in_progress": 0,
      "completed": 1,
      "rejected": 1
    }
  }
}

بیرونی فیلڈ status.code، API کا نتیجہ بتاتی ہے۔ الگ فیلڈ response.status، منصوبے کی نمبر منتقلی کا اخذ کردہ خلاصہ ہے۔ دونوں کو ایک نہ سمجھیں۔

خلاصہ تمام نمبروں کا یکساں نتیجہ نہیں ہے

اگر کسی بھی نمبر کی حالت In Progress ہو تو خلاصے میں یہی حالت منتخب ہوتی ہے؛ ورنہ Pending، پھر Completed، اور پھر Rejected منتخب ہوتی ہے۔ کوئی معلوم حالت مماثل نہ ہو تو طے شدہ حالت Pending ہوتی ہے۔ اس لیے جس منصوبے میں منتقلی مکمل ہونے والے اور مسترد ہونے والے دونوں طرح کے نمبر ہوں، اس کا خلاصہ Completed بتاتا ہے، حالانکہ اس میں مسترد شدہ نمبر اب بھی موجود ہوتے ہیں۔

پورا منصوبہ مکمل ہونے کا فیصلہ کرنے سے پہلے ہمیشہ تعداد اور انفرادی نمبروں کی فہرست دیکھیں۔ counts.total میں منصوبے کے ہر نمبر کی قطار شامل ہوتی ہے؛ دوسرے شمارندے صرف حالت کی چار معلوم قدروں کو شمار کرتے ہیں، اس لیے دیگر قدریں موجود ہونے پر ان کا مجموعہ کل تعداد کے برابر نہ بھی ہو سکتا ہے۔ جس منصوبے میں کوئی نمبر نہ ہو، اس کے تمام شمارندے صفر اور خلاصے کی حالت Pending ہوتی ہے۔

نمبر منتقلی کی حالت سمجھیں

حالت کی عددی قدر محفوظ رکھیں اور نامعلوم قدروں کو بھی سنبھالیں۔ نام معلوم نہ ہونے پر محفوظ شدہ قدر استعمال ہوتی ہے؛ نئے نام کی ضمانت نہیں ہوتی۔ تکمیل کی محفوظ شدہ حالت یا مقررہ تاریخ بذات خود آنے والی کالوں کی روٹنگ یا اس نمبر کی ہر سروس کی جانچ نہیں کرتی۔

خرابیاں اور حدود

HTTP کے جواب کے ساتھ یہ بھی جانچیں: status.code/status.msg۔ منصوبہ موجود نہ ہو، حذف ہو چکا ہو یا اکاؤنٹ کی ملکیت نہ ہو تو API کوڈ 404 اور منصوبہ نہ ملنے کا پیغام واپس آتا ہے۔ شناخت کی توثیق اور ماخذ انٹرنیٹ پتے کی پابندیاں بھی لاگو ہوتی ہیں۔ مثالیں کوئی حقیقی درخواست نہیں بھیجتیں، اور کامیاب جواب اس بات کا ثبوت نہیں کہ ٹیلی کام کمپنی نے منتقلی قبول یا مکمل کر لی ہے۔

اثرات

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