کال کرنے والے کا نام تلاش کریں

کال کرنے والے کا نام تلاش کریں

کسی ٹیلی فون نمبر کے لیے کال کرنے والے کے نام کا دستیاب نتیجہ حاصل کریں۔ یہ اصل عملی سروس میں کی جانے والی تلاش ہے اور اس کی فیس آپ کے اکاؤنٹ سے وصول کی جا سکتی ہے، اس صورت میں بھی جب نتیجہ سروس کے کیش سے آئے۔ اس سے آپ کی ملکیت والے نمبر کی باہر جانے والی کالوں پر دکھایا جانے والا نام تبدیل نہیں ہوتا۔

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

درخواست

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

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

ملک کے کوڈ سمیت پورا نمبر ہندسوں میں فراہم کریں، مثلاً شمالی امریکہ کے لیے گیارہ ہندسے جن کی ابتدا 1 سے ہو۔ رموز یا جمع کے نشان کو معیاری صورت میں بدلنے کے لیے درخواست سنبھالنے والے جزو پر انحصار نہ کریں۔ درخواست کے متن یا خطے کے انتخاب کی ضرورت نہیں ہے۔ اپنے مطلوبہ استعمال کے لیے دستیاب کوریج کی تصدیق MultiTEL سے کریں۔

جواب

قدریں صرف وضاحت کے لیے ہیں؛ درج لاگت قیمت کی پیش کش نہیں ہے۔

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550123",
    "name": "EXAMPLE NAME",
    "cost": 0.0037,
    "balance": 9.9963
  }
}

فیس اور حسابات کی مطابقت

نام والے نتائج کی فیس اکاؤنٹ میں مقرر کردہ CNAM قیمت کے مطابق وصول کی جاتی ہے۔ دوبارہ کی جانے والی یا کیش سے حاصل ہونے والی تلاش پر ایک اور فیس لگ سکتی ہے؛ ایک ہی درخواست پر دوبارہ عمل درآمد سے بچانے والی کوئی کلید فراہم نہیں کی جاتی۔ خودکار تلاش فعال کرنے سے پہلے اکاؤنٹ کی موجودہ شرح دیکھیں۔

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

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

خرابیاں اور دوبارہ کوششیں

HTTP کی حیثیت اور JSON میں status.code/status.msg دونوں کو جانچیں۔ API کوڈ 403 کا مطلب ناکافی پیشگی ادائیگی والا کریڈٹ، خریداری کی ممانعت، اکاؤنٹ کی اجازت دہی کا مسئلہ یا کال کرنے والے کا نام نہ ملنا ہو سکتا ہے۔ نام نہ ملنے والا پراسیسنگ راستہ کوڈ کو متنی سٹرنگ کے طور پر واپس دے سکتا ہے۔ ہر 403 کو غلط اسناد سمجھنے کے بجائے پیغام دیکھیں۔ ترتیب کی متضاد ترتیبات کی صورت میں API کوڈ 500 واپس آ سکتا ہے۔

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

نمبر سے متعلق دیگر کارروائیاں

معلومات پڑھنے کی یہ کارروائی باہر جانے والی کال کے نام یا LIDB کی تازہ کاری، ٹیلی فون ڈائریکٹری میں اندراج یا کال کرنے والے کی رجسٹریشن سے الگ ہے۔ ان کارروائیوں کے اپنے لازمی خانے، اجازت دہی اور فیس ہیں۔ درج ذیل سہولتیں استعمال کریں: تخصیص کی کوریج سابقوں کی جدول کی جانچ کے لیے، یا نمبروں کی تلاش ان نمبروں کے ذخیرے کے لیے جو آرڈر کیے جا سکتے ہیں۔ ان میں سے کوئی بھی یہ ثابت نہیں کرتا کہ کال کرنے والا وہی شخص ہے جس کی شناخت کا وہ دعویٰ کرتا ہے۔