API شاهکار: تطبیق کد ملی و شماره موبایل
استعلام شاهکار با API بازارپی: بررسی تعلق شماره موبایل به کد ملی برای احراز هویت کاربران؛ ساختار استاندارد و پرداخت به ازای هر درخواست موفق.
سرویس تطبیق کد ملی و موبایل (شاهکار) بررسی میکند که آیا یک شماره موبایل به کد ملی مشخصی تعلق دارد یا نه. این یکی از رایج‌ترین گام‌های احراز هویت آنلاین است: کاربر کد ملی و شماره موبایل خود را وارد میکند و شما بدون مراجعه حضوری از تطابق آن‌ها مطمئن می‌شوید.
فراخوانی به مسیر /ide/v1/services/matching با پارامترهای nationalCode و mobileNumber انجام می‌شود (با GET یا POST) و پاسخ نتیجه تطبیق را برمی‌گرداند. ساختار درخواست و پاسخ مطابق API استاندارد رایج است.
برای استفاده، در بازارپی ثبت‌نام کنید، سرویس را درخواست دهید و پس از تأیید، کلید API بسازید. یک جفت کلید برای همه سرویس‌ها کار میکند، دسترسی هر کلید را می‌توانید به IP سرورهای خود محدود کنید و با «کلید تست» پاسخ نمونه بدون کسر هزینه بگیرید. هزینه به ریال و فقط برای درخواست‌های موفق از کیف پول (پیش‌پرداخت) یا سقف اعتبار (پس‌پرداخت) کسر می‌شود؛ خطاهای سمت ارائه‌دهنده (۵xx) هرگز محاسبه نمی‌شوند.
کاربردها
- احراز هویت کاربر هنگام ثبت‌نام در اپلیکیشن یا سایت
- اطمینان از تعلق شماره موبایل پیش از ارسال رمز یکبار مصرف
- بررسی اطلاعات مشتری پیش از ارائه خدمات مالی یا اعتباری
- کاهش ثبت‌نام با اطلاعات جعلی یا شماره دیگران
سرویس‌ها و قیمت
تطبیق کد ملی و موبایل (شاهکار)
GET | POST /ide/v1/services/matching (nationalCode, mobileNumber)جزئیات کامل درخواست و پاسخ در مرجع API و نحوه دریافت توکن در راهنمای فنی آمده است.
سؤالات متداول
شاهکار دقیقاً چه چیزی را بررسی میکند؟
تعلق شماره موبایل به کد ملی؛ پاسخ مشخص میکند این دو با هم تطابق دارند یا نه.
از چه مسیری فراخوانی می‌شود؟
از /ide/v1/services/matching با پارامترهای nationalCode و mobileNumber؛ همین مسیر با پارامترهای دیگر، تطبیق کارت، شبا یا حساب با کد ملی را انجام می‌دهد.
اگر قبلاً با API استاندارد این سرویس کار کردهام چه تغییری لازم است؟
مسیرها، بدنه درخواست و پاسخها مطابق ساختار استاندارد رایج است؛ کافی است آدرس پایه و کلید API را به بازارپی تغییر دهید.
هزینه این سرویس چطور محاسبه می‌شود؟
قیمت هر سرویس به ریال در همین صفحه و کاتالوگ آمده است. فقط درخواست‌های موفق (و طبق قوانین هر سرویس) محاسبه می‌شوند، خطاهای سمت ارائه‌دهنده و قطعی ارتباط هرگز هزینه ندارند و مالیات بر ارزش افزوده جداگانه در صورتحساب می‌آید.