تصدیق کریں کہ موبائل انوینٹری فعال ہے
یہ تلاش صرف اس وقت استعمال کریں جب آپ کے کسٹمر اکاؤنٹ کے لیے موبائل نمبر انوینٹری فعال کر دی گئی ہو۔ اکاؤنٹ کے ڈسکوری ورک فلو کے ذریعے موجودہ انفرادی موبائل پریفکس حاصل کریں۔ تعاون یافتہ راستہ اس پریفکس کے لیے وائرلیس انوینٹری کی درخواست کرتا ہے۔ یہ مماثل وائرلائن روٹنگ میٹا ڈیٹا ریکارڈ پر منحصر نہیں ہے۔ اگر آپ کو یقین نہ ہو کہ آپ کا اکاؤنٹ یا پریفکس فعال ہے تو سپورٹ سے رابطہ کریں۔
موجودہ لیگیسی روٹ ہر نااہل درخواست کو قابل اعتماد طریقے سے مسترد نہیں کرتا۔ موبائل انوینٹری فعال کیے بغیر اکاؤنٹ عام انوینٹری حاصل کر سکتا ہے جبکہ جواب میں اب بھی لکھا ہوتا ہے info.is_mobile: 1. ٹول فری پریفکس بھی اس لیبل کے ساتھ ٹول فری انوینٹری برانچ تک پہنچ سکتا ہے۔ موبائل سروس کی شناخت کے لیے صرف اس لیبل کو استعمال نہ کریں، اور اس اینڈ پوائنٹ پر عام یا ٹول فری پریفکس نہ بھیجیں۔ اکاؤنٹ کے تصدیق شدہ موبائل کیٹلاگ اور فعال ورک فلو کا استعمال کریں۔
ہر نمبر کو اس کے اپنے قیمت کے انتخاب کے ساتھ رکھیں
ہر امیدوار کے لیے، number، info.uuid اور اسی اندراج کی price فہرست کو ایک ساتھ رکھیں۔ جواب میں پریفکس/ایریا/ملک میٹا ڈیٹا، معاہدے کی شرائط اور رجسٹریشن کی پابندیاں بھی شامل ہیں۔ امیدواروں کو ان کے پہلے قیمت کے آپشن کی ماہانہ قیمت کے لحاظ سے صعودی ترتیب میں ترتیب دیا جاتا ہے؛ برابر قیمتوں کے لیے کوئی ضمانت شدہ مستحکم ترتیب نہیں ہے۔ واپس کردہ نمبر ID کو ایریا یا پریفکس ID سے تبدیل نہ کریں، یا اسے کسی دوسرے امیدوار کے قیمت ID کے ساتھ نہ جوڑیں۔
مکمل جواب میں اضافی میٹا ڈیٹا اور قیمت کے فیلڈز شامل ہو سکتے ہیں۔ واپس کردہ features، چینل کی قدریں اور restrictions امیدوار کی وضاحت کرتے ہیں؛ یہ اس بات کی ضمانت نہیں ہیں کہ کالیں، SMS، MMS یا فیکس پہلے سے قابل استعمال ہیں۔ اکاؤنٹ کی اجازتیں، رجسٹریشن اور منتخب سروس پلان اب بھی لاگو ہیں۔ مثال کے پلیس ہولڈرز کو درست IDs یا قیمتوں کے طور پر نہ لیں۔
چھوٹی مثبت مقدار استعمال کریں
مقدار 1 سے شروع کریں۔ عام پرووائیڈر درخواست غیر مثبت مقدار کو 1 پر معمول پر لاتی ہے اور اپ اسٹریم ویلیو کو 300 پر محدود کرتی ہے، لیکن بعد کی نتیجہ ہینڈلنگ پھر بھی اصل ان پٹ استعمال کرتی ہے۔ اس لیے صفر مقدار اپ اسٹریم انوینٹری کی درخواست کر سکتی ہے اور کوئی امیدوار واپس نہیں کر سکتی۔ دیگر لیگیسی برانچیں درخواست کردہ نتیجہ شمار کو مستقل طور پر نافذ نہیں کرتیں۔ کسی واحد عالمگیر زیادہ سے زیادہ پر انحصار نہ کریں اور منفی، کسری یا غیر عددی قدریں نہ بھیجیں۔ اس روٹ کے لیے کوئی تعاون یافتہ عوامی سرچ فلٹر یا قیمت ID باڈی پیرامیٹر دستاویزی نہیں ہے۔
گمشدہ اسٹاک اور لک اپ ناکامی میں فرق کریں
404 جواب غیر دستیاب انوینٹری، غیر فعال سروس، ناکام سپلائر لک اپ یا غلط کیٹلاگ ریکارڈز کی نمائندگی کر سکتا ہے۔ ٹائم آؤٹ یا پرووائیڈر ناکامی کو تصدیق شدہ صفر اسٹاک کے بجائے نامعلوم دستیابی سمجھیں۔ انتخاب کو تازہ کریں اور مناسب ہونے پر بیک آف کے ساتھ دوبارہ کوشش کریں۔ ہر ایکسچینج کو بار بار پول کرنے سے گریز کریں۔ علیحدہ موبائل انوینٹری گنتی اینڈ پوائنٹ ایک سنیپ شاٹ اشارہ ہے اور اس اکاؤنٹ کی امیدوار فہرست کی لمبائی سے مماثل ہونا ضروری نہیں ہے۔
خریدنے سے پہلے دوبارہ جانچیں
تلاش اسٹاک محفوظ نہیں کرتی۔ جائزہ شدہ برانچ پہلے سے خریدے گئے نمبروں کو خارج کرنے کی کوشش کرتی ہے، لیکن ناکام مقامی ریزرویشن لک اپ ایسے امیدوار کو نتیجے میں چھوڑ سکتا ہے۔ دستیابی، ملکیت، منظور شدہ قیمت اور رجسٹریشن کو خریداری ورک فلو کے ذریعے جانچنا ضروری ہے۔ محفوظ خریداری درخواست کے ساتھ نیا انتخاب استعمال کریں، اور دوبارہ کوشش سے پہلے کسی غیر یقینی خریداری نتیجے کے بعد اکاؤنٹ انوینٹری کا ملان کریں۔ صرف اس لیے کبھی نہ خریدیں کہ کوئی امیدوار واپس کیا گیا تھا۔
درخواست
اجازت شدہ سورس IP ایڈریس سے HTTPS پر فعال API اکاؤنٹ استعمال کریں۔ کسٹمر اکاؤنٹ کے لیے موبائل انوینٹری بھی فعال ہونی چاہیے؛ صرف API تصدیق اسے فعال نہیں کرتی۔
GET موجودہ انفرادی پریفکس شناخت کنندہ اور URL پاتھ میں مثبت مکمل عدد مقدار کے ساتھ۔ مقدار چھوڑنے پر 1 پر ڈیفالٹ ہوتی ہے۔ 1 کے ساتھ مثال استعمال کریں؛ یہ روٹ عالمگیر نتیجہ حد کی مستقل طور پر توثیق یا نفاذ نہیں کرتا۔
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobiles/$PREFIX_ID/1"| نام | قسم | مطلوب | تفصیل |
|---|---|---|---|
prefix_id | string | ہاں | ڈسکوری سے اہل انفرادی موبائل پریفکس کی غیر شفاف مرئی ID۔ اپنے اکاؤنٹ کی تعاون یافتہ موبائل NPA/NXX ایکسچینج پریفکس استعمال کریں؛ ایریا ID، گروپڈ ڈسپلے ID، لفظی ڈائلنگ پریفکس یا ٹول فری پریفکس متبادل نہ کریں۔ |
quantity | integer | نہیں | امیدواروں کی درخواست کردہ تعداد۔ 1 پر ڈیفالٹ ہوتی ہے۔ معمولی مثبت مکمل عدد فراہم کریں۔ عام اپ اسٹریم درخواست اپنی مقدار کو 300 پر محدود کرتی ہے، لیکن یہ عالمی طور پر توثیق شدہ ان پٹ یا رسپانس سائز کی ضمانت نہیں ہے۔ |
جواب
HTTP اسٹیٹس کے ساتھ ساتھ JSON باڈی میں status.code اور status.msg کا معائنہ کریں۔ کامیابی پر، response نمبر امیدواروں کی فہرست ہے، status.msg Results: ہے جس کے بعد واپس کردہ اندراجات کی تعداد آتی ہے، اور status.results سیریلائزڈ فہرست کی لمبائی ہے۔ امیدوار کی قیمتیں اکاؤنٹ مخصوص ہیں۔ مثالی مختصر مثال حقیقی انوینٹری یا ٹیرف کوٹیشن کے بجائے پلیس ہولڈرز استعمال کرتی ہے۔ نمبروں میں پلس کے نشان کے بغیر ملکی کوڈ شامل ہے؛ شناخت کنندگان غیر شفاف سٹرنگز ہیں۔
مثالی جواب کی شکل؛ لائیو اکاؤنٹ ڈیٹا یا موجودہ کوٹ نہیں ہے۔
{
"status": {
"code": 200,
"msg": "Results: 1",
"results": 1
},
"response": [
{
"number": "12025550123",
"info": {
"uuid": "NUMBER_ID",
"prefix_uuid": "PREFIX_ID",
"country_iso": "US",
"is_mobile": 1
},
"price": [
{
"uuid": "PRICE_ID",
"monthly_price": "ACCOUNT_MONTHLY_PRICE",
"setup_price": "ACCOUNT_SETUP_PRICE",
"per_minute": "ACCOUNT_INCOMING_RATE",
"channels": "PLAN_CHANNELS"
}
],
"features": [
"voice",
"sms",
"mms",
"t38"
]
}
]
}خرابیاں
- 404: غلط پریفکس ID، ملک یا علاقہ: انفرادی موبائل پریفکس انتخاب کو تازہ کریں۔
- 404: کوئی نمبر نہیں ملا: اس کا مطلب قابل استعمال اسٹاک نہ ہونا، غیر فعال سروس، ناکام پرووائیڈر لک اپ، غیر تعاون یافتہ انتخاب یا اکاؤنٹ کی حدود ہو سکتا ہے۔ یہ مستند صفر انوینٹری شمار کا ثبوت نہیں ہے۔
دستیابی اور ضمنی اثرات
- تلاش نمبر کرائے پر نہیں لیتی یا محفوظ نہیں کرتی اور جائزہ شدہ راستہ خریداری رقم ڈیبٹ نہیں کرتا۔ یہ انوینٹری پرووائیڈر سے رابطہ کرتی ہے اور وقت لے سکتی ہے۔
- کامیاب تلاشیں اکاؤنٹ سے متعلق نمبر اور قیمت کیش اندراجات اور استفسار لاگز لکھتی ہیں۔ تلاش دہرانا ریزرویشن، قیمت لاک یا خریداری نہیں ہے۔
- منتخب اکاؤنٹ اور نمبر کے لیے واپس کردہ قیمتوں، شرائط، پابندیوں اور صلاحیتوں کا جائزہ لینا ضروری ہے۔ فیچر لیبل ایکٹیویشن، میسجنگ منظوری یا آزمودہ سروس فعالیت کو ثابت نہیں کرتا۔