API استعلام اطلاعات هویتی
با کد ملی و تاریخ تولد، اطلاعات هویتی ثبت‌شده همان فرد را برمی‌گرداند، برای وقتی که باید نام واقعی کاربر را بدانید، نه فقط اینکه کد ملی معتبر است.
این سرویس چه میکند
این استعلام دو ورودی می‌گیرد، کد ملی و تاریخ تولد، و اطلاعات هویتی متناظر را برمی‌گرداند. تاریخ تولد اختیاری نیست و این عمدی است: بدون آن، هر کسی با داشتن یک کد ملی می‌توانست نام صاحبش را بیرون بکشد.
تفاوتش با تطبیق‌های ساده این است که خروجی یک «بله/خیر» نیست، بلکه داده است. یعنی می‌توانید نام واردشده توسط کاربر را با نام ثبت‌شده مقایسه کنید، یا فرم را از همان‌جا پر کنید و کاربر را از تایپ‌کردن نجات دهید.
آنچه باید پیش از استفاده بدانید
اگر تاریخ تولد با کد ملی نخواند، پاسخ «یافت نشد» است، نه فهرستی از حدس‌ها. پس این سرویس برای «پیدا کردن» کسی به درد نمی‌خورد؛ برای «تأیید کردن» کسی است که هر دو قلم اطلاعاتش را در اختیار دارید.
نکته حریم خصوصی
خروجی این استعلام داده شخصی است. ما ورودی و نتیجه فراخوان‌ها را نگه نمی‌داریم، از هر فراخوان فقط نام سرویس، وضعیت، مبلغ و زمان ثبت میشود، ولی سمت شما، این داده باید همان‌طور نگهداری شود که بقیه داده‌های هویتی کاربرانتان. لاگ‌کردن پاسخ خام در فایل متنی سرور، رایج‌ترین اشتباه این دسته سرویس‌هاست.
کجا به کار می‌آید
- پرکردن خودکار فرم ثبت‌نامکاربر کد ملی و تاریخ تولد می‌دهد و نام و نام خانوادگی خودش پر میشود. هم سریع‌تر است و هم غلط املایی در نام از بین می‌رود.
- تطبیق نام اظهارشده با نام ثبت‌شدهبرای قراردادها و فاکتورهایی که نام باید دقیق باشد، اظهار کاربر را با داده استعلام بسنجید.
- پیش‌نیاز صدور بیمه‌نامه یا قراردادجایی که سند حقوقی به نام فرد صادر میشود، اشتباه در یک حرف بعداً به ابطال و صدور دوباره می‌انجامد.
ورودی و خروجی
ورودی
nationalCodestringکد ملیbirthDatestringتاریخ تولدخروجی
alivebooleanfather_namestringنام پدرfirst_namestringنامis_deadbooleanlast_namestringنام خانوادگیmatchedbooleannational_codestring002xxxxxxxقیمت و شرط پرداخت
هر فراخوان ۶٬۹۰۰ تومان
مبلغ پیش از تماس با سرویس مرجع از موجودی پنل قفل میشود و اگر پاسخی نیاید، آزاد میشود. ورودی نامعتبر، در دسترس نبودن سرویس مرجع و عبور از سقف نرخ هزینه‌ای ندارند. «رکوردی یافت نشد» یک پاسخ معتبر است و هزینه دارد.
کمترین مبلغ شارژ پنل: ۱٬۰۰۰٬۰۰۰ تومان
پرسش‌های متداول
چرا تاریخ تولد اجباری است؟
بدون آن، داشتن یک کد ملی برای بیرونکشیدن نام صاحبش کافی بود. تاریخ تولد نقش کلید دوم را دارد و استعلام را از «جستوجو» به «تأیید» تبدیل میکند.
اگر تاریخ تولد اشتباه باشد چه پاسخی میگیرم؟
پاسخ «یافت نشد» برمیگردد، نه نزدیکترین تطابق. این یک نتیجه معتبر است و هزینه دارد.
نتیجه استعلام را نگه میدارید؟
نه. از هر فراخوان فقط نام سرویس، وضعیت، مبلغ و زمان ثبت میشود. ورودی و خروجی نگهداری نمیشوند.