ڈیولپرز

GET/v3/lrn/{number}

روٹنگ کی معلومات تلاش کریں

تلاش کے چارجز اور جزوی ناکامیوں کو مدنظر رکھتے ہوئے دستیاب روٹنگ ڈیٹا پڑھیں۔

اس صفحے پر
  1. روٹنگ کی معلومات تلاش کریں
  2. درخواست
  3. جواب
  4. قیمت اور دوبارہ کوششیں
  5. ناکامیاں اور نامکمل کامیابی

روٹنگ کی معلومات تلاش کریں

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

درخواست

اپنا فعال API اکاؤنٹ اور اس کے لیے اجازت یافتہ ماخذ IP پتہ استعمال کریں۔ مکمل نمبر ہندسوں میں فراہم کریں، جس میں ملک کا کوڈ 1 بھی شامل ہو۔ مثال میں ماحولیاتی متغیرات اور ایک فرضی نمبر استعمال کیے گئے ہیں۔ درخواست سنبھالنے والا کوڈ رموزِ اوقاف کو معیاری شکل میں نہیں ڈھالتا؛ بھیجنے سے پہلے درج کردہ معلومات کی درستی جانچیں۔

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/lrn/12025550123

جواب

صرف چند منتخب خانے بطور مثال دکھائے گئے ہیں؛ ان کی دستیابی ماخذ اور نمبر کی قسم پر منحصر ہے۔

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": {
    "lrn": "12025550123",
    "ocn": "0000",
    "local": 1,
    "ported": 0,
    "cost": "$0.00025"
  }
}

معیاری تلاش واپس آنے والے خانوں کے ناموں کو چھوٹے حروف میں تبدیل کرتی ہے۔ ماخذ کے لحاظ سے ٹیلی کام کمپنی، شرح بندی کے مرکز، مقام اور دائرۂ اختیار کے خانے موجود ہو سکتے ہیں۔ جواب صارف کا مکمل ریکارڈ نہیں ہے جس کی ساخت ہمیشہ یکساں ہو۔ local پرچم کی قدر عددی 1 یا متنی سلسلہ 0 ہو سکتی ہے۔ درخواست سنبھالنے والا کوڈ واپس آنے والے روٹنگ نمبر کا فراہم کردہ ٹیلی فون نمبر سے موازنہ کر کے ported کا حساب لگاتا ہے؛ اسے نمبر کی منتقلی کی تصدیق شدہ مکمل تاریخ نہ سمجھیں۔

قیمت اور دوبارہ کوششیں

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

پیشگی ادائیگی والے اکاؤنٹس کے لیے کوڈ کم از کم 0.00025 بیلنس کی جانچ کرتا ہے۔ ناکافی بیلنس کا اس کا پیغام فی الحال $5 کا ذکر کرتا ہے، جو اس حد سے مطابقت نہیں رکھتا۔ اس ناکامی کو بیلنس کی وجہ سے درخواست مسترد ہونا سمجھیں اور دوبارہ کوشش کرنے سے پہلے اکاؤنٹ میں رقم کی تصدیق کریں۔

ناکامیاں اور نامکمل کامیابی

HTTP کی کیفیت اور JSON میں status.code/status.msg، دونوں پڑھیں۔ معیاری تلاش کا خالی نتیجہ API کوڈ 404 واپس کرتا ہے۔ API کوڈ 403 پیشگی ادائیگی کے ناکافی بیلنس کی نشاندہی کر سکتا ہے۔

مفت کال والے نمبروں کے لیے موجودہ خرابی کا ایک راستہ اب بھی تلاش کی رقم کاٹ سکتا ہے اور مفید روٹنگ خانے فراہم کیے بغیر API کوڈ 200 کی اطلاع دے سکتا ہے؛ اس کی لاگت کی معلومات نامکمل ہو سکتی ہیں۔ اس لیے صرف 200 کوڈ سے یہ ثابت نہیں ہوتا کہ تلاش کا نتیجہ قابلِ استعمال ہے۔ اپنی ایپلیکیشن کے لیے درکار خانوں کی درستی جانچیں، غیر یقینی چارجز کو اکاؤنٹ کے بلنگ ریکارڈ سے ملا کر حساب واضح کریں اور نامکمل نتائج کے لیے معاونت سے رابطہ کریں۔

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