CNAM انضمام

CNAM REST API ریفرنس

HTTPS پر کالر کا نام طلب کریں اور نتیجہ، چارج اور ایررز کو سنبھالیں۔

لُک اپ کا طرزِ عمل منتخب کریں

ٹائر	فی کوئری عوامی قیمت	یہ کیا کرتا ہے
Starter	$0.0026	ملکیتی اور کیش شدہ کالر نام کی معلومات استعمال کرتا ہے۔
Standard	$0.0037	ہر کوئری کے لیے ریئل ٹائم نیٹ ورک لُک اپ کرتا ہے۔
Mixed	$0.004	پہلے ریئل ٹائم لُک اپ کی کوشش کرتا ہے، پھر کوئی نام نہ ملنے پر Starter کے ڈیٹا کی طرف واپس جاتا ہے۔

منتخب کردہ سروس لُک اپ کا طرزِ عمل طے کرتی ہے؛ Mixed پہلے کیش دیکھنے والا لُک اپ نہیں ہے۔ پروڈکشن میں استعمال سے پہلے اپنے اکاؤنٹ کو تفویض کردہ ریٹ کا جائزہ لیں۔ کالر کا نام شناخت یا ملکیت کا ثبوت نہیں ہے۔

تصدیق شدہ لُک اپ بھیجیں

اینڈ پوائنٹ: GET https://api.multitel.net/v3/cnam/NUMBER۔ ملک کے کوڈ سمیت بین الاقوامی فارمیٹ کے فون نمبر صرف ہندسوں میں لکھیں، بغیر علاماتِ اوقاف اور ابتدائی پلس کے۔ اسے اپنے ایپلیکیشن سرور سے منظور شدہ API اسناد کے ساتھ چلائیں۔

curl --fail-with-body \
  --user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
  --header "Accept: application/json" \
  "https://api.multitel.net/v3/cnam/12025550123"

دونوں انوائرنمنٹ ویری ایبلز سرور سائیڈ سیکرٹ کنفیگریشن کے ذریعے فراہم کریں۔ فراہم کردہ بیئرر اسناد صرف اسی صورت متبادل ہیں جب وہ رسائی فعال ہو اور اس کی سورس IP پابندیاں پوری ہوتی ہوں۔ API سیکرٹ کو کبھی عوامی براؤزر بنڈل میں نہ ڈالیں۔

API تصدیق اور پہلی درخواست کی گائیڈ

JSON رسپانس پڑھیں

یہ رسپانس مثال کے طور پر ہے۔ واپس آنے والا نام اور چارج لُک اپ اور منتخب کردہ سروس پر منحصر ہیں۔

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550123",
    "name": "EXAMPLE CALLER",
    "cost": "0.004",
    "balance": "24.9960"
  }
}

status.code: ایپلیکیشن کا نتیجہ کوڈ؛ 200 سے موازنہ کرنے سے پہلے اسٹرنگ/عددی قدروں کو یکساں شکل میں لائیں۔
status.msg: ساتھ آنے والا نتیجے یا مسترد ہونے کا پیغام۔
response.number: کوئری کیا گیا نمبر۔
response.name: دستیاب کالر کا نام۔
response.cost: اس کوئری کے لیے رپورٹ کیا گیا چارج؛ اسے اعشاریہ رقم کے طور پر لیں۔
response.balance: رپورٹ شدہ اکاؤنٹ بیلنس، جب موجود ہو۔

بغیر نام کے نتائج اور ایررز

کامیاب درخواست کا مطلب یہ نہیں کہ کالر کا کوئی مفید نام ضرور ملے گا۔ خالی نام، نام کی جگہ نمبر کی واپسی اور مسترد شدہ لُک اپ کو سنبھالیں۔ ایپلیکیشن کوڈ 403 ناکافی کریڈٹ، ممنوعہ خریداری یا ایسے نمبر کو ظاہر کر سکتا ہے جس کا کوئی نتیجہ نہ ہو؛ پیغام کا معائنہ کریں۔

response.name تک رسائی سے پہلے HTTP اسٹیٹس اور JSON status دونوں چیک کریں۔ ایرر کی صورت میں رسپانس آبجیکٹ موجود نہیں بھی ہو سکتا۔ نام کی غیر موجودگی عام کال کی روٹنگ میں رکاوٹ نہیں بننی چاہیے۔

بلنگ، دوبارہ کوششیں اور کالر ID اپ ڈیٹ کرنے سے فرق

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

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

اکاؤنٹ CNAM انضمام کی گائیڈ انضمام میں مدد حاصل کریں