مستندات فنی «انطباق ویدئو و عکس کارت ملی»

اندپوینت و دسترسی انطباق ویدئو و عکس کارت ملی

این صفحه مستندات فنی فراخوانی POST /kyc/v2/clients/{clientId}/compareVideoWithNationalCardImage است.

Scope: kyc:compare-video-with-national-card-image:post

Grant type: client_credentials

دسته‌بندی OpenAPI: احراز هویت و شناخت مشتری. شناسه عملیات: kycCompareVideoWithNationalCardImagePost.

معرفی انطباق ویدئو و عکس کارت ملی

سرویس «انطباق ویدئو و عکس کارت ملی» ویدیوی کاربر را با عکس کارت ملی هوشمند تطبیق می‌دهد. ورودی ویدیو، کد ملی، تاریخ تولد و سریال کارت است. بدون رضایت پیامکی کاربر و با رویکرد Client Credential قابل فراخوانی است. برای ساخت کلاینت و گرفتن توکن، راهنمای شروع را ببینید.

ورودی و خروجی انطباق ویدئو و عکس کارت ملی

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

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

جزئیات نوع داده، الزامی بودن و نمونه JSON در مشخصات Elements همین صفحه آمده است.

کاربرد فنی انطباق ویدئو و عکس کارت ملی

سرویس «انطباق ویدئو و عکس کارت ملی» ویدیوی کاربر را با عکس کارت ملی هوشمند تطبیق می‌دهد. ورودی ویدیو، کد ملی، تاریخ تولد و سریال کارت است. بدون رضایت پیامکی کاربر و با رویکرد Client Credential قابل فراخوانی است. برای ساخت کلاینت و گرفتن توکن، راهنمای شروع را ببینید.

پس از دریافت توکن مناسب (مطابق Grant type)، درخواست را به مسیر بالا بفرستید و پاسخ را بر اساس اسکیمای اعلام‌شده پردازش کنید. راهنمای گرفتن توکن در راهنمای شروع آمده است.

در صورت خطای احراز هویت یا Scope ناکافی، ابتدا اعتبار توکن و سطح دسترسی کلاینت را بررسی کنید؛ سپس پارامترهای الزامی مسیر و بدنه را با اسکیمای همین صفحه تطبیق دهید.

برای توضیح کسب‌وکاری، موارد استفاده و پیش‌نیازها به صفحه سرویس «انطباق ویدئو و عکس کارت ملی» مراجعه کنید.

عملیات مرتبط با انطباق ویدئو و عکس کارت ملی

• دریافت تصویر کارت ملی — GET /facility/v2/clients/{clientId}/nationalCardImage
• دریافت تصویر کارت ملی — GET /facility/v2/clients/{clientId}/nationalCardImage
• استعلام کد ملی (Client Credential) — GET /facility/v2/clients/{clientId}/users/{nid}/cc/nidInquiry
• استعلام کد ملی (Client Credential) — GET /facility/v2/clients/{clientId}/users/{nid}/cc/nidInquiry
• استعلام کد ملی (Authorization SMS) — GET /facility/v2/clients/{clientId}/users/{nid}/sms/nidInquiry