سرویس «لیست پلاکهای فعال» در دسته استعلام خودرو فینوتک با گرفتن کد ملی و شماره موبایل یک فرد، فهرست پلاکهای فعال ثبتشده برای او را برمیگرداند. با این فهرست میتوانید بدون آنکه کاربر پلاک را تایپ کند، خودروهای او را در فرم نمایش دهید و ادعای «خودرو دارم» را به داده قابل اتکا تبدیل کنید.
لیست پلاکهای فعال چه مشکلی را حل میکند؟
وقتی کسبوکار شما باید بداند یک نفر چه خودروهایی دارد، معمولاً تنها راه، پرسیدن از خود اوست: کاربر پلاک را از حافظه یا از روی کارت خودرو وارد میکند و شما برای اطمینان، تصویر مدرک هم میخواهید. این مسیر هم خطاپذیر است — اشتباه در ترتیب ارقام یا حرف وسط پلاک بسیار رایج است — و هم ناقص؛ اگر فرد چند خودرو داشته باشد یا یکی از آنها را عمداً اعلام نکند، تصویر شما از دارایی خودرویی او ناقص میماند و تصمیمهای اعتباری و ریسکی روی داده کمعمق گرفته میشود.
این سرویس مسیر را برعکس میکند: بهجای اینکه کاربر پلاک را به شما بگوید، شما با کد ملی و شماره موبایل او فهرست پلاکهای فعالش را دریافت میکنید. همین یک تغییر، تایپ پلاک را از فرم حذف میکند، انتخاب خودرو را به یک لیست قابل انتخاب تبدیل میکند و در پروندههای اعتباری و بیمهای، دامنه داراییهای خودرویی فرد را روشن میکند. فهرست خروجی میتواند ورودی استعلامهای بعدی مثل بررسی خلافی یا مشخصات هر خودرو باشد.
کاربردهای لیست پلاکهای فعال
- پرونده اعتباری و تسهیلات با وثیقه خودرو — پیش از انتخاب وثیقه، خودروهای فعال متقاضی دیده میشود و گفتوگو با مشتری از روی فهرست واقعی پیش میرود.
- انتخاب خودرو در فرم بیمه — کاربر بهجای تایپ پلاک، خودروی خود را از فهرست انتخاب میکند و خطای ورودی و رهاکردن فرم کاهش پیدا میکند.
- پذیرش راننده و خودرو در پلتفرمهای حملونقل — خودروهای ثبتشده برای راننده در مرحله ثبتنام نمایش داده میشود و انتخاب خودروی کاری ساده میشود.
- پرداخت یکپارچه خلافی و عوارض در سوپراپها — فهرست پلاکهای کاربر یک بار گرفته میشود و استعلامهای دورهای روی همان فهرست انجام میگیرد.
- مدیریت ناوگان و اجاره خودرو — هنگام افزودن خودروی شخصی راننده یا شریک تجاری به سامانه، فهرست پلاکهای او مبنای ثبت قرار میگیرد.
- ارزیابی ریسک و توان مالی در پروندههای بیمهای — تعداد خودروهای فعال فرد بهعنوان یکی از سیگنالهای پرونده در کنار سایر دادهها بررسی میشود.
مزایای لیست پلاکهای فعال
- حذف تایپ پلاک از فرم — انتخاب از فهرست جای ورود دستی را میگیرد و خطای رایج در ارقام و حرف پلاک از بین میرود.
- تصویر کاملتر از خودروهای فرد — بهجای تکیه بر اظهار کاربر، فهرست پلاکهای فعال او در اختیار شماست.
- نقطه شروع استعلامهای بعدی — پلاکهای خروجی میتوانند مستقیم به استعلامهای خلافی، بیمه یا مشخصات خودرو داده شوند.
- کاهش رفتوبرگشت مدارک — نیازی به درخواست تصویر کارت خودرو برای فهرست کردن داراییهای خودرویی نیست.
- فراخوانی ساده و بدون حضور کاربر — یک درخواست با توکن Client Credential کافی است.
چه چیزی از لیست پلاکهای فعال دریافت میکنید؟
جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.
جریان کار لیست پلاکهای فعال
- ۱. گرفتن توکن — با اسکوپ
vehicle:active-plate-numbers:getتوکن Client Credential بگیرید. - ۲. ارسال کد ملی و موبایل — کد ملی و شماره موبایل فرد را همراه یک
trackIdیکتا ارسال کنید. - ۳. خواندن فهرست پلاکها — فهرست پلاکهای فعال را از پاسخ بردارید و در رابط کاربری بهصورت قابل انتخاب نمایش دهید.
- ۴. ادامه جریان کسبوکاری — پلاک انتخابشده را به استعلامهای بعدی مانند مشخصات خودرو یا خلافی بدهید.
- ۵. ثبت نتیجه — فهرست دریافتی و
trackIdرا برای ممیزی و بازبینی پرونده ذخیره کنید و سیاست نگهداری آن را مشخص کنید.
نحوه شروع لیست پلاکهای فعال
این سرویس با رویکرد Client Credential (بدون رضایت پیامکی) فراخوانی میشود. اسکوپ مورد نیاز: vehicle:active-plate-numbers:get. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع. سپس از مستندات فنی برای پیادهسازی استفاده کنید.
محدودیتها و نکات لیست پلاکهای فعال
- هر دو ورودی کد ملی و شماره موبایل لازم است؛ ورودی کاربر را پیش از فراخوانی از نظر قالب بررسی و نرمالسازی کنید.
- خروجی فهرست پلاکهای فعال است؛ اگر فرد پلاکی نداشته باشد، فهرست خالی یک پاسخ معتبر است و باید در رابط کاربری برای آن حالت پیام مناسب طراحی شود.
- برای پاسخ به پرسش «آیا این پلاک مشخص متعلق به این فرد است؟» این سرویس ابزار درستی نیست؛ تطبیق مالکیت خودرو همان بررسی نقطهای را انجام میدهد.
- نتیجه، وضعیت همان لحظه است؛ پس از خرید یا فروش خودرو فهرست تغییر میکند و باید دوباره استعلام شود.
- برای هر فراخوانی
trackIdیکتا بفرستید تا استعلامها در گزارشها قابل ردیابی باشند. - فهرست دارایی خودرویی یک فرد داده حساس است؛ نمایش آن را به همان کاربر و همان جریان کاری محدود کنید و مدت نگهداری آن را تعیین کنید.
سوالات متداول لیست پلاکهای فعال
«لیست پلاکهای فعال» چیست؟
سرویسی است که با گرفتن کد ملی و شماره موبایل یک فرد، فهرست پلاکهای فعال ثبتشده برای او را بهصورت داده ساختیافته برمیگرداند.
تفاوت این سرویس با تطبیق مالکیت خودرو چیست؟
این سرویس از فرد شروع میکند و فهرست پلاکهای او را میدهد؛ تطبیق مالکیت خودرو از یک پلاک مشخص شروع میکند و میگوید آیا با کد ملی اعلامشده تطبیق دارد یا نه.
آیا مشخصات خودروها هم در همین پاسخ میآید؟
خروجی این سرویس فهرست پلاکهاست؛ برای مشخصات هر خودرو باید پلاک را به استعلام اطلاعات خودرو و تخفیفات بدهید.
چرا شماره موبایل هم لازم است؟
شماره موبایل در کنار کد ملی از ورودیهای الزامی این سرویس است و بدون آن فراخوانی انجام نمیشود؛ جزئیات پارامترها در مستندات فنی آمده است.
مستندات فنی این سرویس کجاست؟
صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.
چه نوع احراز هویتی لازم است؟
Grant type: client_credentials. جزئیات در راهنمای توکن.
آیا رضایت پیامکی کاربر لازم است؟
خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.
مستندات فنی لیست پلاکهای فعال
مشاهده مستندات فنی «لیست پلاکهای فعال» — endpoint، پارامترها، نمونه درخواست و پاسخ.