استعلام مشخصات با کد ملی زمانی کاربرد دارد که کسب‌وکار برای تکمیل یا بررسی پرونده کاربر به مشخصات هویتی نیاز دارد. در شناسار، کد ملی به‌تنهایی ورودی کامل این درخواست نیست و تاریخ تولد هم لازم است. پیش از طراحی فرم یا انتخاب API، باید بدانید چه اطلاعاتی از کاربر دریافت می‌شود، نتیجه چه کاربردی دارد و کدام انتظارها خارج از وظیفه سرویس است.
برای استعلام مشخصات با کد ملی چه اطلاعاتی لازم است؟
ورودی وب‌سرویس استعلام هویتی شناسار، کد ملی و تاریخ تولد فرد است. کد ملی را به‌صورت رشته نگه دارید تا صفرهای ابتدای آن حذف نشود. تاریخ تولد باید مطابق قالب مستندات سرویس ارسال شود؛ نمایش تاریخ در فرم و قالب ارسال به API می‌توانند متفاوت باشند.
| اطلاعات | نکته دریافت در فرم |
|---|---|
| کد ملی | حفظ صفر ابتدایی، حذف فاصله ناخواسته و کنترل ساختار |
| تاریخ تولد | دریافت تاریخ کامل و تبدیل آن به قالب مستندات |
| کلید API | فقط در بخش امن سامانه؛ کاربر نهایی نباید آن را ببیند |
برای آشنایی با مسیر استفاده، صفحه وب‌سرویس استعلام اطلاعات هویتی را ببینید. دسترسی فنی سرویس از طریق حساب فعال و کلید وب‌سرویس انجام می‌شود، نه با ارسال اطلاعات هویتی در دیدگاه یا پیام عمومی.
آیا استعلام بدون تاریخ تولد ممکن است؟
در این سرویس شناسار، تاریخ تولد جزو ورودی‌های لازم است. سامانه‌ای که فقط کد ملی دریافت می‌کند هنوز اطلاعات کافی برای ارسال این درخواست ندارد. به‌جای امتحان‌کردن تاریخ‌های مختلف، تاریخ صحیح را از خود کاربر بگیرید و قالب آن را کنترل کنید.
اگر هدف شما صرفاً بررسی تعلق شماره موبایل به یک کد ملی است، سرویس شاهکار ورودی دیگری دارد و تاریخ تولد دریافت نمی‌کند. این تفاوت به معنای جایگزین‌بودن خروجی دو سرویس نیست؛ شاهکار مشخصات کامل فرد را برای تکمیل پرونده برنمی‌گرداند.
نتیجه استعلام چه اطلاعاتی دارد؟
نمونه پاسخ در مستندات رسمی، فیلدهایی مانند نام، نام خانوادگی، نام پدر، جنسیت، محل تولد و برخی اطلاعات شناسنامه‌ای را نشان می‌دهد. فیلدهای قابل استفاده باید مطابق پاسخ واقعی و مستندات جاری سرویس خوانده شوند؛ وجود همه فیلدها را در همه پاسخ‌ها فرض نکنید.
فرم تکمیل پرونده را برای اطلاعات خالی یا ارائه‌نشده نیز طراحی کنید. اگر داده‌ای ضروری نیست، نبود آن نباید باعث شود کل فرایند ثبت‌نام متوقف شود. اگر داده‌ای برای تصمیم کسب‌وکار لازم است، وضعیت نبود داده را از خطای فنی و عدم هماهنگی اطلاعات جدا نگه دارید.
استعلام هویتی، مسیر پیدا‌کردن شماره موبایل، شماره کارت یا همه حساب‌های یک فرد نیست. برای بررسی ارتباط اطلاعات بانکی با هویت، ورودی بانکی مشخص و سرویس تطبیق مناسب لازم است.
فرایند مناسب دریافت و بررسی اطلاعات
- هدف درخواست را به کاربر توضیح دهید و اطلاعات لازم همان مرحله را بگیرید.
- کد ملی و تاریخ تولد را پیش از ارسال، از نظر قالب بررسی کنید.
- درخواست را از بخش امن نرم‌افزار به سرویس بفرستید.
- ابتدا موفق‌بودن درخواست را کنترل کنید، سپس فیلدهای نتیجه را بخوانید.
- اگر اطلاعات فرم تغییر کرد، نتیجه قبلی را به داده‌های جدید نسبت ندهید.
برای مثال، یک پلتفرم می‌تواند هنگام تکمیل پروفایل، کد ملی و تاریخ تولد را دریافت کند و مشخصات پاسخ را برای بررسی پرونده نمایش دهد. همان پلتفرم هنگام ثبت مقصد تسویه، باید بررسی مستقل تطبیق کد ملی و شبا را انجام دهد.
اگر نتیجه دریافت نشد چه باید کرد؟
تاریخ تولد اشتباه، قالب نامعتبر، مشکل دسترسی و اختلال در پاسخ سرویس یک وضعیت واحد نیستند. پیام فرم باید راه اصلاح داده را نشان دهد؛ برای نمونه «تاریخ تولد را کامل وارد کنید» برای خطای ورودی مناسب‌تر از «هویت شما تأیید نشد» است.
اگر پاسخ قابل تفسیر دریافت نشده، وضعیت را «در انتظار بررسی» یا پیام متناسب با خطای واقعی نمایش دهید. خطای شبکه را نشانه نادرست‌بودن مشخصات فرد ندانید. در گزارش فنی، زمان درخواست و شناسه پیگیری موجود را نگه دارید و از ثبت بی‌دلیل همه اطلاعات حساس در گزارش‌ها پرهیز کنید.
سؤالات متداول
آیا کد ملی معتبر از نظر ساختار یعنی هویت فرد تأیید شده است؟
خیر. کنترل قالب و رقم کنترلی، بررسی اولیه ورودی است؛ جای استعلام از سرویس را نمی‌گیرد.
آیا نتیجه برای تمام فرایندها کافی است؟
خیر. دریافت مشخصات هویتی با تأیید دسترسی به موبایل یا بررسی تعلق حساب بانکی متفاوت است. هر کنترل باید متناسب با هدف خودش استفاده شود.
تعرفه را از کجا ببینیم؟
تعرفه جاری در پنل خدمات شناسار نمایش داده می‌شود.
(Share) کلیک کنید.
(Add to home screen) را انتخاب کنید.