ملی ای‌پی‌آی

سامانه شاهکار چیست؟

شاهکار بررسی می‌کند یک شماره موبایل به نام یک کد ملی ثبت شده یا نه. پاسخش فقط بله یا خیر است.

شاهکار یک پرسش ساده را پاسخ می‌دهد: این شماره موبایل به نام این کد ملی است؟

ورودی و خروجی

ورودی: کد ملی و شماره موبایل.

خروجی: یک مقدار، می‌خواند یا نمی‌خواند.

همین. نه نام صاحب خط برمی‌گردد، نه اپراتور، نه تاریخ ثبت.

چرا فقط بله یا خیر

این محدودیت در واقع یک ویژگی حریم خصوصی است.

اگر نام صاحب خط برمی‌گشت، هر کسی می‌توانست با داشتن یک شماره موبایل بفهمد مال کیست. با پاسخ بله/خیر، فقط چیزی را که از قبل حدس زده‌اید می‌توانید تأیید کنید.

کجا به کارتان می‌آید

پیش از استعلام خلافی خودرو

استعلام خلافی، کد ملی و موبایل مالک را اجباری می‌خواهد و اگر این دو به هم نخورند نتیجه نمی‌دهد.

اگر مطمئن نیستید سیم‌کارت به نام چه کسی است، شاهکار ارزان‌تر است از اینکه هزینه استعلام خلافی را بپردازید و بی‌نتیجه بماند.

پیش از معامله

طرف مقابلی که شماره‌ای می‌دهد و کد ملی‌اش را هم اعلام می‌کند، شاهکار می‌گوید این دو یکی هستند یا نه.

در ثبت‌نام و تأیید حساب

کسب‌وکارهایی که می‌خواهند مطمئن شوند شماره‌ای که کاربر وارد کرده، واقعاً مال خودش است.

کد ملی پیش از ارسال بررسی می‌شود

کد ملی ایران رقم کنترلی دارد. API همان را بررسی می‌کند، پس اگر عدد ساختاراً غلط باشد همان‌جا گرفته می‌شود و هزینه‌ای کسر نمی‌شود.

شماره موبایل هم باید شکل درست داشته باشد: با 09 و یازده رقم. اگر به شکل دیگری بفرستید، API خودش تبدیلش می‌کند.

«نمی‌خواند» یعنی چه

یعنی این شماره به نام این کد ملی ثبت نشده.

می‌تواند چند علت داشته باشد: سیم‌کارت به نام شخص دیگری است، یا تازه منتقل شده و هنوز ثبت نشده. استعلام بین اینها تفکیک نمی‌کند.

این یک پاسخ معتبر است، نه خطا، رسیدش صادر می‌شود.

تفاوت با استعلام اطلاعات هویتی

شاهکار درباره موبایل است. اگر می‌خواهید بدانید یک کد ملی به نام چه کسی است، استعلام اطلاعات هویتی آن را می‌دهد و نام و نام خانوادگی برمی‌گرداند.

برای استفادهٔ برنامه‌نویسی از این موضوع، سراغ استعلام شاهکار بروید و برای ادامهٔ بحث، تفاوت رمز یک‌بارمصرف، شاهکار و تشخیص چهره را بخوانید.

آخرین بازبینی: تیم تحریریه ملی ای‌پی‌آی

وب‌سرویس مرتبط با این راهنما

API استعلام شاهکار

تطابق کد ملی با شماره موبایل.

مشاهده مشخصات فنی و تعرفه

راهنماهای مرتبط

پرسش و تجربه کاربران

اگر این راهنما جوابتان را نداد، همین‌جا بپرسید. پرسش‌ها را تیمملی ای‌پی‌آی پاسخ می‌دهد و هر نظر پیش از انتشار بررسی می‌شود.

هنوز پرسشی ثبت نشده، اولین نفر باشید.