نمبر منتقلی کے پروجیکٹ میں نمبروں کی فہرست

اکاؤنٹ اور پروجیکٹ تک رسائی

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

درخواست

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

جواب

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

{
  "status": {
    "code": 200,
    "msg": "Project Numbers",
    "results": 1
  },
  "response": [
    {
      "id": 21,
      "number": "12025550123",
      "status": 0,
      "status_str": "Pending",
      "isocode": "US",
      "updated": "2026-10-23 12:00:00",
      "foc": "",
      "comment": "Example customer-visible note",
      "date_created": "2026-10-23 12:00:00",
      "date_completed": ""
    }
  ]
}

response ایک فہرست ہے۔ ایسا موجودہ پروجیکٹ جس میں کوئی نمبر نہ ہو، خالی فہرست واپس کرتا ہے، جس میں API کوڈ 200 اور status.results کی قدر 0 ہوتی ہے۔ اس کے برعکس، غیر موجود پروجیکٹس API کوڈ 404 واپس کرتے ہیں۔

نمبر کے فیلڈز

واپس کیے جانے والے ڈیٹا کی اس ساخت میں صرف عملے کے لیے مخصوص internal_comment فیلڈ شامل نہیں ہے۔ اس کا مطلب یہ نہیں کہ ایک نمبر کی علیحدہ پرانی تلاش بھی یہی ساخت استعمال کرتی ہے۔

ترتیب اور نگرانی

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

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

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

غلطیاں اور حدود

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

اثرات

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