سرویس «استعلام گواهینامه و وضعیت» در دسته استعلام خودرو فینوتک با گرفتن کد ملی و شماره موبایل، اطلاعات گواهینامههای فرد و وضعیت استعلام را برمیگرداند. با این خروجی میتوانید پیش از سپردن خودرو، پذیرش راننده یا صدور بیمهنامه، صلاحیت رانندگی متقاضی را بهجای بررسی چشمی تصویر گواهینامه، از داده استعلامی بخوانید.
استعلام گواهینامه و وضعیت چه مشکلی را حل میکند؟
کنترل گواهینامه امروز در بیشتر کسبوکارها یک مرحله دستی است: متقاضی تصویر گواهینامه را آپلود میکند، اپراتور به تاریخ و پایه آن نگاه میکند و اطلاعات را دستی در سامانه تایپ میکند. این روش سه ضعف دارد؛ تصویر میتواند قدیمی یا دستکاریشده باشد، بررسی انسانی در حجم بالا گلوگاه میشود و در خدمات غیرحضوری، منتظر ماندن برای تایید اپراتور بخشی از متقاضیان را در همان مرحله از دست میدهد.
این سرویس همان بررسی را به یک فراخوانی درون فرم ثبتنام تبدیل میکند. شما کد ملی و شماره موبایل متقاضی را میفرستید و اطلاعات گواهینامهها و وضعیت استعلام را بهصورت داده ساختیافته میگیرید. نتیجه میتواند مستقیم به قاعده پذیرش وصل شود: ادامه جریان کار برای متقاضی دارای گواهینامه، ارجاع به بررسی دستی برای موارد مبهم و توقف پرونده در مواردی که شرط صلاحیت رانندگی برآورده نمیشود.
کاربردهای استعلام گواهینامه و وضعیت
- پذیرش راننده در پلتفرمهای حملونقل و سفارش آنلاین — صلاحیت رانندگی متقاضی پیش از فعال شدن حساب و دریافت اولین سفارش بررسی میشود.
- اجاره خودرو — پیش از تحویل خودرو، وضعیت گواهینامه مستاجر کنترل میشود تا خودرو به فرد فاقد گواهینامه سپرده نشود.
- بیمهگری خودرو — وضعیت گواهینامه راننده بهعنوان یکی از ورودیهای ارزیابی ریسک و پرونده صدور بررسی میشود.
- مدیریت ناوگان و منابع انسانی شرکتهای حملونقل — وضعیت گواهینامه رانندگان سازمانی بهصورت دورهای بازبینی میشود.
- لیزینگ و خدمات خودرویی مدتدار — در پروندههایی که استفاده از خودرو بخشی از قرارداد است، صلاحیت رانندگی متقاضی ثبت و مستند میشود.
- کاهش مدارک درخواستی در فرم ثبتنام — بهجای آپلود تصویر گواهینامه، استعلام با کد ملی و موبایل انجام میشود.
مزایای استعلام گواهینامه و وضعیت
- حذف بررسی چشمی تصویر گواهینامه — تصمیم روی داده ساختیافته گرفته میشود و به قضاوت اپراتور از روی عکس وابسته نیست.
- کوتاه شدن زمان پذیرش راننده — مرحلهای که ساعتها یا روزها در صف بررسی میماند، درون همان نشست تمام میشود.
- قابلیت خودکارسازی در حجم بالا — پاسخ ساختیافته است و میتواند بدون دخالت انسان به قاعده پذیرش وصل شود.
- ردیابیپذیری کامل هر بررسی — ارسال شناسه پیگیری در این سرویس الزامی است، بنابراین هر استعلام از ابتدا قابل رهگیری است.
- بدون نیاز به حضور یا تایید پیامکی — فراخوانی با توکن Client Credential انجام میشود.
چه چیزی از استعلام گواهینامه و وضعیت دریافت میکنید؟
جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.
جریان کار استعلام گواهینامه و وضعیت
- ۱. گرفتن توکن — با اسکوپ
kyc:cc-license-check-inquiry:postتوکن Client Credential بگیرید. - ۲. ساخت شناسه پیگیری — یک
trackIdیکتا بسازید؛ در این سرویس ارسال آن الزامی است و استفاده از UUID توصیه میشود. - ۳. ارسال درخواست — کد ملی و شماره موبایل متقاضی را در بدنه درخواست بفرستید.
- ۴. خواندن نتیجه — اطلاعات گواهینامهها و وضعیت استعلام را از پاسخ بردارید و در پرونده راننده نمایش دهید.
- ۵. اعمال قاعده و ثبت شواهد — بر اساس نتیجه، پذیرش را تایید یا به بررسی دستی ارجاع دهید و پاسخ را همراه
trackIdبایگانی کنید.
نحوه شروع استعلام گواهینامه و وضعیت
این سرویس با رویکرد Client Credential (بدون رضایت پیامکی) فراخوانی میشود. اسکوپ مورد نیاز: kyc:cc-license-check-inquiry:post. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع. سپس از مستندات فنی برای پیادهسازی استفاده کنید.
محدودیتها و نکات استعلام گواهینامه و وضعیت
- ارسال
trackIdدر این سرویس اختیاری نیست؛ باید حداکثر ۴۰ کاراکتر حرف و عدد باشد و UUID گزینه پیشنهادی است. - کد ملی و شماره موبایل در بدنه درخواست ارسال میشوند و فراخوانی از نوع POST است؛ ساختار دقیق درخواست در مستندات فنی آمده است.
- خروجی میتواند بیش از یک گواهینامه داشته باشد؛ منطق سمت خود را برای فهرستی از گواهینامهها بنویسید، نه یک رکورد ثابت.
- وضعیت استعلام را جدا از محتوای گواهینامه بخوانید؛ نبود نتیجه با نامعتبر بودن گواهینامه یکی نیست و باید در رابط کاربری متفاوت نمایش داده شود.
- نتیجه مربوط به لحظه استعلام است؛ برای رانندگان فعال، بازبینی دورهای را در جریان کار خود پیشبینی کنید.
- داده گواهینامه، داده هویتی فرد است؛ فقط همان اقلامی را که تصمیم شما به آن نیاز دارد نگه دارید و دسترسی را محدود کنید.
سوالات متداول استعلام گواهینامه و وضعیت
«استعلام گواهینامه و وضعیت» چیست؟
سرویسی است که با گرفتن کد ملی و شماره موبایل، اطلاعات گواهینامههای فرد و وضعیت استعلام را بهصورت داده ساختیافته برمیگرداند تا در پذیرش راننده و پروندههای خودرویی استفاده شود.
تفاوت این سرویس با استعلام نمره منفی گواهینامه چیست؟
اینجا موضوع، خودِ گواهینامههای فرد و وضعیت استعلام است؛ استعلام نمره منفی گواهینامه با شماره گواهینامه کار میکند و به نمره منفی و تعداد خلافی میپردازد.
آیا این سرویس صلاحیت راننده را از نظر ریسک هم ارزیابی میکند؟
خیر. برای امتیاز ریسک راننده سرویس جداگانهای وجود دارد: استعلام ریسک رانندگان.
چرا ارسال شناسه پیگیری اجباری است؟
چون هر فراخوانی این سرویس با همان شناسه در گزارشها و پیگیریهای بعدی ردیابی میشود؛ محدودیت قالب آن در مستندات فنی توضیح داده شده است.
مستندات فنی این سرویس کجاست؟
صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.
چه نوع احراز هویتی لازم است؟
Grant type: client_credentials. جزئیات در راهنمای توکن.
آیا رضایت پیامکی کاربر لازم است؟
خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.
مستندات فنی استعلام گواهینامه و وضعیت
مشاهده مستندات فنی «استعلام گواهینامه و وضعیت» — endpoint، پارامترها، نمونه درخواست و پاسخ.