ایکسچینج کے لیے موبائل انوینٹری چیک کریں

ایک معاون پریفکس منتخب کریں

ڈسکوری سے موجودہ انفرادی موبائل پریفکس استعمال کریں۔ یہ اینڈ پوائنٹ NANPA ایکسچینجز کے لیے ہے: NPA ایریا کوڈ کی نشاندہی کرتا ہے، اور NXX ایکسچینج کی نشاندہی کرتا ہے۔ صرف ایریا کوڈ والی پریفکس بہت وسیع ہے۔ گروپ کیے گئے ڈسپلے IDs نہ بھیجیں اور نہ ہی کسی اور ملک کی معاونیت کا اندازہ لگائیں اس بنیاد پر کہ اس کی پریفکس میں کافی ہندسے موجود ہیں۔

شمار کو اشارے کے طور پر استعمال کریں

پڑھیں response.count، کے ساتھ response.npa اور response.nxx ایکسچینج کی نشاندہی کرتے ہیں۔ یہ کوریج سروس کا اسنیپ شاٹ ہے، آپ کے اکاؤنٹ کے لیے مختص اسٹاک نہیں۔ آرڈر کرنے سے پہلے اصل نمبرز، لاگو کوٹیشنز اور رجسٹریشن کے کسی بھی تقاضے کی تصدیق کریں۔ کامیاب شمار کبھی بھی خریداری کی اجازت نہیں دیتا۔

صفر اسٹاک اور ناکام تلاش میں فرق کریں

صفر کا کامیاب شمار API خرابی سے مختلف ہے۔ معائنہ کریں status.code اور status.msg کے ساتھ ساتھ HTTP اسٹیٹس بھی۔ ٹائم آؤٹ یا ناکام تلاش کو نامعلوم دستیابی سمجھیں اور بعد میں بیک آف کے ساتھ دوبارہ کوشش کریں۔

درخواست

HTTPS کے ذریعے اپنے فعال API اکاؤنٹ کی اسناد استعمال کریں۔ Basic توثیق اور فعال API اکاؤنٹس کے Bearer ٹوکنز کی معاونت حاصل ہے؛ اکاؤنٹ کی پابندیاں لاگو ہوتی ہیں۔

GET پریفکس شناخت کار کے ساتھ URL پاتھ میں۔ کوئی دستاویزی query یا body پیرامیٹرز موجود نہیں ہیں۔

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"

جواب

JSON باڈی میں status.code کے ساتھ ساتھ HTTP اسٹیٹس بھی چیک کریں۔ ایک کامیاب response میں status.code 200 اور status.msg Results ہوتا ہے۔ response ایک آبجیکٹ ہے، فہرست نہیں: count ایک صحیح عدد انوینٹری اسنیپ شاٹ ہے؛ npa اور nxx تین حروف کی سٹرنگز ہیں۔ status.results اس ایسوسی ایٹو آبجیکٹ کے لیے موجود نہیں ہوتا۔ 0 کے شمار کا مطلب ہے کہ کوریج تلاش کو کوئی مماثل ایکسچینج نہیں ملا یا اس نے صفر اسٹاک واپس کیا؛ یہ ثابت نہیں کرتا کہ تمام سپلائرز یا دیگر ڈسکوری راستوں کے پاس نمبرز نہیں ہیں۔

وضاحتی جواب کی شکل؛ لائیو اکاؤنٹ ڈیٹا یا موجودہ کوٹیشن نہیں۔

{
  "status": {
    "code": 200,
    "msg": "Results"
  },
  "response": {
    "count": 42,
    "npa": "212",
    "nxx": "555"
  }
}

خرابیاں

• 404: فراہم کرنے والا غیر فعال: سروس پر موبائل انوینٹری کوریج دستیاب نہیں ہے۔
• 404: غلط پریفکس ID: ڈسکوری سے موجودہ انفرادی پریفکس ID حاصل کریں۔
• 404: غلط پریفکس: محفوظ شدہ پریفکس میں NPA/NXX تلاش کے لیے کافی ہندسے موجود نہیں ہیں۔
• 500: انوینٹری کوریج ناکام ہو گئی: اپ اسٹریم تلاش نے کامیاب کوریج نتیجہ واپس نہیں کیا۔ بعد میں بیک آف کے ساتھ دوبارہ کوشش کریں؛ ناکامی صفر اسٹاک کا شمار نہیں ہے۔

دستیابی اور ضمنی اثرات

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