محفوظ شدہ نمبر قیمت پلان پڑھیں

محفوظ شدہ قیمت پلان پڑھیں

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

یہ محفوظ شدہ قیمتوں کا ایک مطابقتی (compatibility) لُک اپ ہے۔ یہ دستیابی یا قیمتوں کو تازہ نہیں کرتا، نمبر ریزرو نہیں کرتا، آرڈر نہیں دیتا، اور نہ ہی مستقبل کی خریداری کی رقم کی ضمانت دیتا ہے۔ آرڈر دینے سے پہلے نئی نمبر سرچ کے ساتھ واپس آنے والے قیمت کے آپشن کا جائزہ لیں۔

درخواست

اجازت یافتہ IP ایڈریس سے HTTPS پر اپنا فعال API اکاؤنٹ استعمال کریں۔ PRICE_ID کو بالکل اسی قیمت کے آپشن ID پر سیٹ کریں جو آپ کو موصول ہوا تھا۔ یہ میتھڈ ایک پاتھ آرگومنٹ پڑھتا ہے اور کوئی باڈی، تاریخ یا پیجینیشن پیرامیٹرز نہیں پڑھتا۔

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

یہ لُک اپ اسی اکاؤنٹ کو کرنا ہوگا جس نے قیمت کا آپشن حاصل کیا تھا۔ کوئی ID خود نہ بنائیں، ڈیٹا بیس کی قطار کا نمبر استعمال نہ کریں، اور نہ ہی کسی دوسرے اکاؤنٹ کا انتخاب اس کی جگہ استعمال کریں۔ لیگیسی میتھڈ صرف ظاہری (visible) قیمت ID سے مماثلت کرتا ہے۔

جواب

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

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "visible_uuid": "PRICE_FROM_SEARCH",
      "setup_price": "2.00",
      "monthly_price": "4.50",
      "per_minute": "0.0100",
      "free_minutes": "100",
      "channels": "2"
    }
  ]
}

response ایک فہرست ہے، چاہے ایک ہی قطار ہو۔ status.results واپس آنے والی قطاروں کی گنتی بتاتا ہے۔ ڈیٹا بیس کی عددی قدریں سٹرنگز ہو سکتی ہیں۔ یہ اینڈ پوائنٹ کوئی کرنسی فیلڈ شامل نہیں کرتا اور نہ ہی کرنسیاں تبدیل کرتا ہے؛ اس مثال سے اندازہ لگانے کے بجائے اکاؤنٹ کی بلنگ کرنسی کی تصدیق کریں۔

قیمت کے فیلڈز

متعدد مماثل قطاروں کو سنبھالیں

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

پورٹل کا آرڈر ریویو ورک فلو اضافی انتخاب اور درستگی کی جانچ کرتا ہے۔ یہ فرض نہ کریں کہ یہ لیگیسی لُک اپ وہ جانچیں نافذ کرتا ہے یا ہر وہ شناخت کنندہ قبول کرتا ہے جو پورٹل قبول کرتا ہے۔

خالی جوابات اور خرابیاں

اگر کوئی محفوظ شدہ قطار مماثل نہ ہو، تو موجودہ ہینڈلر کوئی JSON نتیجہ جاری نہیں کرتا اور نہ ہی کوئی واضح not-found جواب دیتا ہے۔ خالی باڈی کا مطلب صفر قیمت، دستیاب پلان یا تصدیق شدہ کامیاب لُک اپ نہیں ہے۔ HTTP جواب اور JSON ساخت دونوں کی جانچ کریں؛ غائب یا ناقابلِ پارس قیمت کے ڈیٹا سے آرڈر نہ دیں۔

تصدیق، سورس IP کی پابندیاں اور ڈیٹا بیس کی ناکامیاں بھی قابلِ استعمال جواب کو روک سکتی ہیں۔ ڈیٹا بیس ایکسیپشن کے لیے کوئی ہینڈلر مخصوص ایرر اینویلپ نہیں ہے۔ جب تصدیق شدہ لُک اپ دستیاب نہ رہے تو اپنا انتخاب تازہ کریں یا سپورٹ سے رابطہ کریں۔

اثرات اور حدود

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