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