API و وب سرویس تطابق درصدی اطلاعات هویتی

برای نام (و در صورت دادن، نام پدر) درصد شباهت با اطلاعات هویتی ثبت‌شدهٔ همان کد ملی برگردانده می‌شود.

این سرویس چه می‌کند

نام‌ها در فرم‌های فارسی کمتر از آن چیزی که فکر می‌کنیم یکدست‌اند: «محمدرضا» و «محمد رضا»، «فاطمه» و «فاطیما»، حرف اضافه و نیم‌فاصله. مقایسهٔ رشته‌ای در کد شما یا با تفاوت کم رد می‌کند یا بیش‌ازحد می‌پذیرد. این سرویس کد ملی، تاریخ تولد و نامی را که می‌خواهید بسنجید می‌گیرد و درصد شباهت را برمی‌گرداند، نه تأیید یا رد.

خروجی چهار عدد دارد: full_name_similarity، first_name_similarity، last_name_similarity و father_name_similarity. عدد چهارم فقط وقتی هست که نام پدر را فرستاده باشید.

آستانه را خودتان تعیین کنید

سرویس آستانه‌ای نمی‌گذارد. عدد ۱۰۰ نزدیک‌ترین حالت و عدد پایین یعنی نام با رکورد فاصله دارد، ولی «چقدر کافی است» تصمیم شماست. یک شروع معقول این است که برای پذیرش خودکار آستانه‌ای سخت‌گیرانه بگذارید و بازهٔ میانی را به بررسی انسانی بدهید. آستانه را روی نمونه‌ای از نام‌های واقعی مشتریان خودتان آزمایش کنید، نه روی حدس.

چه وقت عدد پایین بی‌گناه است

نام اختصاری، نام دوم که حذف شده، تایپ با املای محاوره‌ای یا معکوس نوشتن نام و نام خانوادگی عدد را پایین می‌آورند. عدد پایین نشانهٔ دروغ‌گویی نیست و ممکن است فقط تفاوت نگارش باشد.

آنچه این سرویس نمی‌کند

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

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

  • ثبت‌نام در پلتفرم جذب سرمایهپلتفرمی که سرمایه‌گذار جدید می‌پذیرد، نام واردشده را با رکورد هویتی می‌سنجد و عددهای پایین را به کارشناس انطباق می‌فرستد.
  • احراز مالک فروشگاه در درگاه پرداختارائه‌دهندهٔ خدمات پرداخت نام صاحب کسب‌وکار در فرم را با کد ملی تطبیق می‌دهد و فقط موارد مشکوک را بازبینی دستی می‌کند.
  • تأیید پروفایل مربی در باشگاهباشگاهی که مربی استخدام می‌کند، نام واردشدهٔ متقاضی را می‌سنجد تا نام‌های مستعار یا عنوان‌های جعلی پیش از قرارداد معلوم شود.

ورودی و خروجی

ورودی

nationalCodestringکد ملیده رقم، با رقم کنترل معتبر.
birthDatestringتاریخ تولدتاریخ شمسی (نه میلادی): سال چهاررقمی، ماه و روز دورقمی. 1370/01/05، 1370-01-05 و 13700105 هر سه پذیرفته می‌شوند.
namestringنامنام و نام خانوادگی به فارسی، دست‌کم سه حرف.
fatherNamestringنام پدراختیاری؛ نام پدر به فارسی.

قیمت و شرط پرداخت

قیمت هر فراخوان API تطابق درصدی اطلاعات هویتی ۷٬۰۰۰ تومان است.

قیمت هر استعلام API تطابق درصدی اطلاعات هویتی بر اساس تعداد استعلام در ماه
تعداد استعلام در ماهقیمت هر استعلام
همهٔ فراخوان‌ها۷٬۰۰۰ تومان

آخرین تغییر قیمت:

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

کمترین مبلغ شارژ پنل: ۵۰۰٬۰۰۰ تومان

پرسش‌های متداول

این استعلام می‌گوید نام درست است یا نه؟

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

چه عددهایی در پاسخ می‌آید؟

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

چه آستانه‌ای برای شباهت درست است؟

سرویس آستانه‌ای نمی‌دهد. با نمونه‌ای از نام‌های واقعی مشتریان خودتان آزمایش کنید و بازهٔ میانی را به بررسی انسانی بسپارید.

چرا عدد پایین است در حالی که نام درست است؟

معمولاً تفاوت نگارش است: نام کوتاه‌شده، نیم‌فاصله، املای محاوره‌ای یا جابه‌جایی نام و نام خانوادگی. ورودی را پیش از ارسال یکدست کنید.

فرق سنجش شباهت با گرفتن نام ثبت‌شده چیست؟

استعلام هویتی نام ثبت‌شده را به شما می‌دهد و مقایسه با شماست. اینجا نام را شما می‌فرستید و سرویس شباهتش را با رکورد می‌سنجد.

نام پدر را حتماً باید بفرستم؟

نه، اختیاری است. اگر خالی باشد، شباهت نام پدر محاسبه و برگردانده نمی‌شود. رشتهٔ خالی نفرستید.

آیا تاریخ تولد لازم است؟

بله. کد ملی و تاریخ تولد شمسی هر دو اجباری‌اند. تاریخ ناممکن یا ناقص با invalid_input رد می‌شود و هزینه ندارد.

پاسخ با شباهت پایین هم هزینه دارد؟

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