API احراز هویت تصویری
یک عکس چهره را با تصویر ثبت احوال همان کد ملی و تاریخ تولد مقایسه می‌کند و هم‌زمان می‌سنجد که عکس از فردی زنده گرفته شده است.
این سرویس چه می‌کند
احراز هویت تصویری سبک‌ترین شکل تطبیق چهره است: یک عکس سلفی، کد ملی و تاریخ تولد. چهرهٔ عکس با تصویر ثبت احوال مقایسه میشود و جداگانه بررسی میشود که عکس از فردی زنده گرفته شده و عکسِ یک عکس یا صفحهٔ نمایش نیست.
پاسخ، نتیجهٔ تطبیق چهره و درصد شباهت، نتیجهٔ زندهبودن و امتیازش، و یک نتیجهٔ نهایی است که فقط وقتی مثبت است که هر دو بررسی مثبت باشند.
تفاوتش با احراز ویدئویی
برای کاربر ساده‌تر است: یک عکس به‌جای ضبط ویدیو و خواندن متن. در عوض بررسی گفتار ندارد، پس برای کارهای پرریسک، مثل افتتاح حساب مالی، احراز ویدئویی سد محکم‌تری است. برای ورود دوباره، تأیید تراکنش یا احراز سبک همکار، عکس کافی است.
نکته پیاده‌سازی
بدنه multipart/form-data است و عکس در بخش face می‌آید: JPEG، PNG یا WebP، حداکثر حدود سه مگابایت. عکس را در اپ خودتان با دوربین جلو و در همان لحظه بگیرید، نه از گالری. اگر تصویر مرجع این شخص در ثبت احوال نباشد، کد reference_photo_missing برمی‌گردد، بی هزینه.
کجا به کار می‌آید
- ورود دوباره بدون رمزکاربری که دستگاهش را عوض کرده، با یک سلفی ثابت می‌کند صاحب همان حساب است.
- تأیید تراکنش بزرگپیش از برداشت یا انتقال بالاتر از سقف، چهرهٔ صاحب حساب را در چند ثانیه بسنجید.
- احراز سبک همکاربرای پیک، نصاب یا فروشنده، یک سلفی هنگام ثبت‌نام جلوی ساخت حساب با کد ملی دیگران را می‌گیرد.
ورودی و خروجی
ورودی
nationalCodestringکد ملیده رقم، با رقم کنترل معتبر.birthDatestringتاریخ تولدتاریخ شمسی (نه میلادی): سال چهاررقمی، ماه و روز دورقمی. 1370/01/05، 1370-01-05 و 13700105 هر سه پذیرفته می‌شوند.facefileتصویر چهرهفایل JPEG، PNG یا WebP، حداکثر ۳۰۲۴ کیلوبایت.nationalCardSerialstringسریال کارت ملیده نویسهٔ پشت کارت ملی هوشمند، مثل 1A12345678. برای احراز تصویری و ویدئویی الزامی است؛ سامانهٔ مرجع بی آن تصویر ثبت احوال را نمی‌دهد.نمونهٔ درخواست
بدنه multipart/form-data است و نه JSON؛ فایل همان‌جا فرستاده میشود و پس از پاسخ، هیچجا نگه داشته نمیشود.
curl -X POST https://ehrazino.com/api/v1/face-verification/ \ -H "Authorization: Bearer YOUR_API_KEY" \ -F "nationalCode=0013542419" \ -F "birthDate=1370/01/05" \ -F "face=@image.jpg" \ -F "nationalCardSerial=1A12345678"
خروجی
verifiedbooleanهویت تأیید شدface_matchedbooleanتطبیق چهره با ثبت احوالface_similaritynumberدرصد شباهت چهرهis_livebooleanزندهبودنliveness_scorenumberامتیاز زندهبودنقیمت و شرط پرداخت
هر فراخوان ۳۰٬۳۰۰ تومان
آخرین تغییر قیمت:
مبلغ پیش از تماس با سرویس مرجع از موجودی پنل قفل میشود و اگر پاسخی نیاید، آزاد میشود. ورودی نامعتبر، در دسترس نبودن سرویس مرجع و عبور از سقف نرخ هزینه‌ای ندارند. «رکوردی یافت نشد» یک پاسخ معتبر است و هزینه دارد.
کمترین مبلغ شارژ پنل: ۱٬۰۰۰٬۰۰۰ تومان
- ثبت‌نام در احرازینو و ساخت حساب کسب‌وکار رایگان است و همهٔ مبلغ شارژ صرف استعلام‌های خودتان میشود.
- استعلام زیادی دارید؟ برای تخفیف و تعرفهٔ اختصاصی با پشتیبانی در تماس باشید.
- می‌خواهید پیش از شارژ آزمایش کنید؟ درخواست شارژ آزمایشی ثبت کنید تا برایتان اضافه کنیم.
خطاهای این سرویس
identity_not_foundهویتی با این کد ملی و تاریخ تولد در ثبت احوال پیدا نشد. رایگان.reference_photo_missingتصویر مرجع این شخص در ثبت احوال نیست و تطبیق چهره ممکن نیست. رایگان.invalid_inputفایل نیامده، قالبش مجاز نیست یا از سقف حجم بزرگ‌تر است؛ نام بخش در fields می‌آید. رایگان.multipart_requiredبدنه باید multipart/form-data باشد، نه JSON. رایگان.
⚠️ این‌ها خطاهای خودِ سرویس‌اند. کدهای عمومی، احراز، سقف نرخ و موجودی، در مستندات فهرست شده‌اند.
پرسش‌های متداول
عکس از گالری هم پذیرفته میشود؟
فنی بله، ولی بررسی زندهبودن برای عکسِ از پیش موجود ساخته نشده. عکس را در همان لحظه با دوربین بگیرید.
عدم تطبیق هزینه دارد؟
بله، بررسی انجام شده و «تطبیق ندارد» خودش پاسخ است. هویت پیداشده نشدن و نبودن تصویر مرجع بی‌هزینه‌اند.
عکس نگه داشته میشود؟
نه. عکس فقط برای همان درخواست در حافظه است و پس از پاسخ هیچجا ذخیره نمیشود.