ایک خریدے گئے نمبر کی معلومات پڑھیں

ایک خریدے گئے نمبر کا ریکارڈ اور اس کی محفوظ کردہ ترتیب پڑھیں۔ یہ کارروائی inventory اینڈپوائنٹ کی صف کے بجائے ایک آبجیکٹ واپس کرتی ہے۔

درخواست

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

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

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

جواب

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

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "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",
      "perminute_charges": "0"
    },
    "needs_registration": "0",
    "vrating": "",
    "country_id": "COUNTRY_REFERENCE",
    "area_id": "AREA_REFERENCE",
    "provider_id": "OPAQUE_LEGACY_REFERENCE"
  }
}

اس کے مقابلے میں: inventory، یہ اینڈپوائنٹ درج ذیل بھی واپس کرتا ہے: needs_registration، vrating، country_id، area_id، provider_id اور price.perminute_charges۔ یہ پرانی محفوظ کردہ قدریں ہیں، شناخت کی منظوری کا الگ جواب نہیں۔ حوالہ جاتی شناخت کنندگان سے کوئی اندرونی معنی اخذ نہیں کیے جانے چاہییں؛ مناسب دریافت کا جواب حاصل کیے بغیر ان سے دریافت کے URLs نہ بنائیں اور نہ ہی ان سے فراہم کنندگان کے باہمی تعلقات اخذ کریں۔

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

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

نتیجہ استعمال کریں

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