API OCR کارت ملی
اطلاعات کارت ملی را از روی تصویر رو و پشت آن میخواند و به‌صورت فیلدهای جدا برمی‌گرداند.
این سرویس چه می‌کند
خواندن کارت ملی از تصویر، فیلدهای چاپ‌شده روی کارت را استخراج می‌کند: نام، نام خانوادگی، نام پدر، کد ملی، تاریخ تولد و تاریخ انقضا، و از پشت کارت، سریال آن. تصویر چهرهٔ روی کارت عمداً در پاسخ نمی‌آید: داده‌ای زیستسنجی است که برای پر کردن فرم لازم نیست.
برای کسب‌وکارها این همان گامی است که فرم ثبت‌نام را از هفت فیلد به یک آپلود تبدیل می‌کند. در موبایل، که تایپ کد ملی و تاریخ تولد بیشترین نرخ رهاکردن فرم را دارد، تفاوتش در نرخ تکمیل دیده میشود.
آنچه این استعلام نمیکند
احراز هویت نیست. اطلاعات روی کارت را میخواند و نمی‌گوید این کارت واقعی است، منقضی نشده یا در دست صاحبش است. برای آن، استعلام هویت و احراز زنده مسیرهای جداگانه‌اند.
کیفیت تصویر را هم جبران نمیکند. عکس تار، کج یا با بازتاب نور، فیلدهای ناقص میدهد؛ راهنمای گرفتن عکس در رابط کاربری، بیشتر از هر چیز دیگری کیفیت نتیجه را بالا می‌برد.
نکته پیاده‌سازی
فایل را با multipart/form-data بفرستید: روی کارت در بخش front و پشت کارت، اگر سریال را هم می‌خواهید، در بخش back. تصویر پس از پاسخ هیچ‌جا نگه داشته نمی‌شود. تصویری که خوانده نشود، کد unreadable می‌گیرد و چون پردازش انجام شده، هزینه دارد؛ پس پیش از ارسال، کادر و وضوح عکس را در رابط کاربری خودتان بسنجید.
هر فیلد را جداگانه اعتبارسنجی کنید و اجازه اصلاح بدهید. کد ملی را با الگوریتم کنترلی‌اش بسنجید و اگر رد شد، به‌جای رد کل فرایند، همان فیلد را برای اصلاح به کاربر نشان دهید.
کجا به کار می‌آید
- ثبت‌نام موبایلی بدون تایپکاربر دو عکس می‌گیرد و فرم پر میشود. نرخ رهاکردن فرم در موبایل به‌شدت وابسته به تعداد فیلد تایپی است.
- ورود اطلاعات در پذیرش حضوریدر شعبه یا نمایندگی، اپراتور به‌جای تایپ، اسکن می‌کند و خطای ورود داده کم میشود.
- پیش‌پر کردن قراردادمشخصات طرف قرارداد از روی کارت استخراج و در قالب قرارداد نشانده میشود.
ورودی و خروجی
ورودی
frontfileتصویر روی کارت ملیفایل JPEG، PNG یا WebP، حداکثر ۴۰۹۶ کیلوبایت.backfileتصویر پشت کارت ملی (اختیاری)فایل JPEG، PNG یا WebP، حداکثر ۴۰۹۶ کیلوبایت.نمونهٔ درخواست
بدنه multipart/form-data است و نه JSON؛ فایل همان‌جا فرستاده میشود و پس از پاسخ، هیچ‌جا نگه داشته نمی‌شود.
curl -X POST https://ehrazino.com/api/v1/national-card-ocr/ \ -H "Authorization: Bearer YOUR_API_KEY" \ -F "front=@image.jpg"
خروجی
frontobjectروی کارتقیمت و شرط پرداخت
هر فراخوان ۴٬۱۰۰ تومان
آخرین تغییر قیمت:
مبلغ پیش از تماس با سرویس مرجع از موجودی پنل قفل میشود و اگر پاسخی نیاید، آزاد میشود. ورودی نامعتبر، در دسترس نبودن سرویس مرجع و عبور از سقف نرخ هزینه‌ای ندارند. «رکوردی یافت نشد» یک پاسخ معتبر است و هزینه دارد.
کمترین مبلغ شارژ پنل: ۱٬۰۰۰٬۰۰۰ تومان
- ثبت‌نام در احرازینو و ساخت حساب کسب‌وکار رایگان است و همهٔ مبلغ شارژ صرف استعلام‌های خودتان میشود.
- استعلام زیادی دارید؟ برای تخفیف و تعرفهٔ اختصاصی با پشتیبانی در تماس باشید.
- می‌خواهید پیش از شارژ آزمایش کنید؟ درخواست شارژ آزمایشی ثبت کنید تا برایتان اضافه کنیم.
خطاهای این سرویس
unreadableتصویر پردازش شد ولی کارت یا کد ملی معتبری در آن خوانده نشد؛ پیام، علت را می‌گوید. هزینه دارد.invalid_inputفایل نیامده، قالبش مجاز نیست یا از سقف حجم بزرگ‌تر است؛ نام بخش در fields می‌آید. رایگان.multipart_requiredبدنه باید multipart/form-data باشد، نه JSON. رایگان.
⚠️ این‌ها خطاهای خودِ سرویس‌اند. کدهای عمومی، احراز، سقف نرخ و موجودی، در مستندات فهرست شده‌اند.
پرسش‌های متداول
جعلیبودن کارت را تشخیص میدهد؟
نه. این سرویس متن روی تصویر را میخواند و درباره اصالت کارت قضاوتی نمیکند.
تصویر چهره روی کارت هم برمیگردد؟
نه. داده زیستسنجی است و برای پر کردن فرم لازم نیست، پس پیش از پاسخ حذف میشود.
اگر عکس بیکیفیت باشد چه میشود؟
فیلدها ناقص برمیگردند. راهنمای گرفتن عکس در رابط کاربری، بیشترین اثر را روی کیفیت نتیجه دارد.