خریدے گئے نمبروں کی فہرست حاصل کریں

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

درخواست

HTTPS کے ذریعے سرور کی جانب استعمال ہونے والی API کی توثیقی معلومات استعمال کریں۔ مثالیں توثیقی معلومات ماحولیاتی متغیرات سے پڑھتی ہیں؛ ان میں کوئی قابلِ استعمال توثیقی معلومات شامل نہیں ہیں۔ جانچنے کے لیے JSON باڈی میں موجود status.code کے ساتھ HTTP اسٹیٹس بھی دیکھیں۔ یہ پرانے ہینڈلر ایپلیکیشن کی خرابی پر ہر بار HTTP کی خرابی کا اسٹیٹس مقرر نہیں کرتے۔

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

کسی ایک محفوظ شدہ ٹیلی فون نمبر کے لحاظ سے نتائج چھانٹنے کے لیے پاتھ کی یہ اختیاری صورت استعمال کریں:

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

محفوظ شدہ بین الاقوامی ٹیلی فون نمبر ملک کے کوڈ سمیت ہندسوں کی صورت میں استعمال کریں۔ اس کی جگہ PBX ایکسٹینشن، نمبر کا UUID، علاقے کی شناخت یا سابقے کی شناخت نہ بھیجیں۔ فراہم کردہ نمبر کسی موجودہ ریکارڈ کو منتخب کرتا ہے؛ یہ کوئی نمبر خریدتا یا اس کی ترتیب مقرر نہیں کرتا۔

جواب

کامیابی کی صورت میں response رکن ہمیشہ ایک ارے ہوتا ہے، ایک نمبر والے پاتھ کی صورت میں بھی۔ ارے کی لمبائی status.results میں ہوتی ہے۔

یہ جواب کی ساخت کی ایک وضاحتی مثال ہے، اکاؤنٹ کا ڈیٹا یا موجودہ قیمت کی پیشکش نہیں۔

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "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"
      }
    }
  ]
}

نتائج چھانٹنا اور صفحات میں تقسیم

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

کوئی مماثل نمبر نہیں

اگر اکاؤنٹ میں کوئی مماثل غیر منسوخ ریکارڈ نہ ہو تو JSON باڈی میں status.code کی قدر 404 ہوتی ہے اور پیغام میں یہ عبارت شامل ہوتی ہے: no numbers found۔ یہ کامیابی ظاہر کرنے والا خالی ارے واپس نہیں کرتا۔ پیغام کے آخر میں ماخذ کے حوالے کا ایک لاحقہ شامل ہوتا ہے جسے کلائنٹس کو مستقل شناخت کار سمجھ کر پارس نہیں کرنا چاہیے۔

اگلے اقدامات

استعمال کریں: numberinfo، جب آپ کو کسی ایک نمبر کے لیے پرانے رجسٹریشن اور نمبر کے حوالے کے اضافی خانے درکار ہوں۔ ترتیب بدلنے کے الگ عمل کے ذریعے کسی بھی روٹ کو تبدیل کرنے سے پہلے صوتی کالوں اور پیغام رسانی کی منزلیں دیکھیں۔