دسته «استعلام خودرو» فینوتک سیزده API دارد که به دو پرسش جدا پاسخ میدهند: این پلاک به چه کسی تعلق دارد و وضعیت و بدهی این خودرو چیست. گروه نخست درباره مالکیت و پیشینه پلاک است و گروه دوم درباره تخلف، بدهی، بیمه و صلاحیت راننده. هر سیزده سرویس با توکن Client Credential و بدون نیاز به رضایت پیامکی کاربر فراخوانی میشوند.
درباره دسته استعلام خودرو
پرسشهای مالکیتی سه سرویس دارند و تفاوتشان در جهت حرکت داده است. لیست پلاکهای فعال از شخص به پلاک میرسد و با کد ملی و شماره موبایل، پلاکهای فعال همان فرد را برمیگرداند. تطبیق مالکیت خودرو مسیر معکوس را میرود و فقط میگوید پلاک اعلامشده به آن کد ملی میخورد یا نه، و در کنار این پاسخ، نوع و تیپ و مدل خودرو را هم نشان میدهد. تاریخچه پلاک بعد زمانی را اضافه میکند و نشان میدهد آن پلاک روی چه خودروهایی نصب شده است؛ همین سرویس است که در معامله دستدوم، پیشینه پلاک را شفاف میکند.
گروه دوم به جای مالک، خود خودرو و راننده را میسنجد: خلافی خودرو و موتورسیکلت، تصویر ثبتشده تخلف، بدهی طرح ترافیک، عوارض آزادراهی، سوابق بیمهنامه شخص ثالث، مشخصات فنی و تخفیفات، وضعیت گواهینامه، نمره منفی و امتیاز ریسک راننده. مرز این دسته روشن است: کار آن استعلام است، نه تراکنش. پاسخ خلافی، طرح ترافیک و عوارض آزادراه، مبلغ را همراه شناسههای لازم برمیگرداند تا پرداخت را در مسیر خودتان انجام دهید، اما خود پرداخت، صدور بیمهنامه، ثبت اعتراض به تخلف و نقلوانتقال سند بخشی از این APIها نیست. طرح ترافیک بدهی محدوده شهری است و عوارض آزادراهی بدهی مسیرهای برونشهری؛ این دو سرویس را یکی نگیرید.
کاربردهای کسبوکاری استعلام خودرو
- بیمهگری و صدور شخص ثالث — پیش از صدور یا تمدید، سابقه پوشش خودرو با استعلام سوابق بیمهنامه شخص ثالث بررسی میشود.
- اجاره خودرو و ناوگان اشتراکی — اعتبار گواهینامه متقاضی با استعلام گواهینامه و وضعیت پیش از تحویل خودرو سنجیده میشود.
- پلتفرم خرید و فروش خودرو — پیشینه پلاک با تاریخچه پلاک برای خریدار شفاف میشود و آگهیدهنده باید همان مالک باشد.
- اپلیکیشن خدمات خودرویی — بدهی خودرو با استعلام خلافی خودرو، استعلام طرح ترافیک و استعلام عوارض آزادراهی در یک صفحه جمع میشود.
- تأمین مالی و لیزینگ خودرو — تعلق خودرو به متقاضی با تطبیق مالکیت خودرو تأیید و مشخصات آن در پرونده ثبت میشود.
- حملونقل و ناوگان سازمانی — پیش از سپردن خودرو به راننده، استعلام نمره منفی گواهینامه و استعلام ریسک رانندگان وضعیت او را روشن میکنند.
- پاسخ به اعتراض کاربر درباره جریمه — تصویر مربوط به یک تخلف مشخص با دریافت تصویر تخلفات رانندگی به کاربر نشان داده میشود.
انتخاب سرویس مناسب در استعلام خودرو
- «فقط کد ملی کاربر را دارم و میخواهم بدانم چه خودروهایی دارد» — از لیست پلاکهای فعال شروع کنید؛ خروجی آن ورودی بقیه استعلامهای این دسته میشود.
- «پلاکی که کاربر وارد کرده واقعاً مال خودش است؟» — تطبیق مالکیت خودرو پاسخ بله یا خیر میدهد و برای تأیید فرم ثبتنام کافی است.
- «این پلاک پیشتر روی چه خودرویی بوده؟» — تاریخچه پلاک نصبهای قبلی و وضعیت پلاک را برمیگرداند، نه فقط وضعیت امروز.
- «این وسیله چقدر بدهی دارد؟» — برای خودرو استعلام خلافی خودرو، برای موتورسیکلت استعلام خلافی موتور، برای بدهی محدوده شهری استعلام طرح ترافیک و برای بدهی آزادراه استعلام عوارض آزادراهی.
- «کاربر میپرسد این جریمه بابت چیست» — اگر شناسه تخلف را در اختیار دارید، دریافت تصویر تخلفات رانندگی تصویر خودرو و پلاک را برمیگرداند.
- «مشخصات فنی و سابقه بیمه خودرو را میخواهم» — استعلام اطلاعات خودرو و تخفیفات برای مشخصات و تخفیفها و استعلام سوابق بیمهنامه شخص ثالث برای بیمهنامه.
- «این فرد اجازه و صلاحیت رانندگی دارد؟» — استعلام گواهینامه و وضعیت برای خود گواهینامه، استعلام نمره منفی گواهینامه برای نمره منفی و استعلام ریسک رانندگان برای امتیاز ریسک بر پایه کد ملی و تاریخ تولد.
شروع کار با استعلام خودرو
برای فراخوانی هر سرویس این دسته ابتدا کلاینت بسازید، اسکوپ همان سرویس را روی کلاینت فعال کنید و سپس توکن بگیرید؛ مسیر کامل در راهنمای شروع آمده است. همه سرویسهای خودرویی از نوع Client Credential هستند، یعنی توکن با اطلاعات خود کلاینت صادر میشود و لازم نیست کاربر با پیامک به شما دسترسی بدهد.
ورودی سرویسها یکسان نیست: بعضی فقط پلاک میخواهند، بعضی کد ملی و شماره موبایل را هم لازم دارند، و قالب پلاک برای خودرو و موتورسیکلت فرق میکند. پیش از پیادهسازی، از صفحه کسبوکاری هر سرویس در فهرست پایین همین صفحه به مستندات فنی آن بروید؛ ورودیها، خروجی و نمونه پاسخ آنجا آمده است.
سوالات متداول استعلام خودرو
دسته استعلام خودرو چه کاری انجام میدهد؟
مجموعهای از APIهاست که مالکیت و پیشینه پلاک را روشن میکند و وضعیت خودرو و راننده را از نظر خلافی، طرح ترافیک، عوارض آزادراه، بیمه، گواهینامه و ریسک برمیگرداند.
آیا برای این سرویسها باید از کاربر رضایت پیامکی بگیرم؟
خیر. همه سرویسهای این دسته با رویکرد Client Credential فراخوانی میشوند و جریان تأیید پیامکی کاربر در آنها دخیل نیست.
میتوانم خلافی، طرح ترافیک یا عوارض آزادراه را از همین APIها پرداخت کنم؟
خیر. این دسته فقط استعلام میکند. شناسه قبض و شناسه پرداخت در خروجی میآید و پرداخت باید در سامانه پرداخت خودتان انجام شود.
طرح ترافیک و عوارض آزادراهی یک سرویساند؟
خیر. استعلام طرح ترافیک بدهی محدوده شهری است و استعلام عوارض آزادراهی بدهی مسیرهای برونشهری.
پلاک خودرو و موتورسیکلت یک قالب دارند؟
خیر. قالب پلاک خودرو نهرقمی و قالب پلاک موتورسیکلت هشترقمی است، بنابراین برای هرکدام سرویس و ورودی مخصوص خودش را انتخاب کنید. نحوه ساخت کد ۹ رقمی خودرو در جدول راهنمای شماره پلاک آمده است.
نتیجه استعلام را چطور نگه دارم؟
خلافی، طرح ترافیک، عوارض آزادراه و وضعیت گواهینامه با گذشت زمان تغییر میکنند؛ پاسخ را با زمان استعلام ذخیره کنید و پیش از هر تصمیم تازه، استعلام را دوباره بگیرید.
مستندات فنی هر سرویس کجاست؟
صفحه کسبوکاری هر سرویس در فهرست پایین همین صفحه به صفحه مشخصات فنی همان عملیات لینک دارد و پارامترها و نمونه پاسخ در آن صفحه است.
فهرست سرویسهای استعلام خودرو
- استعلام اطلاعات خودرو و تخفیفات — با وارد کردن شماره پلاک ۹ رقمی و کد ملی، اطلاعات و تخفیفات مربوط به خودرو دریافت میشود. (مستندات فنی)
- استعلام خلافی خودرو — سرویس استعلام خلافی خودرو با گرفتن شماره موبایل، کدملی و پلاک خودرو لیست خلافی های خودرو را همراه شماره قبض و شماره پرداخت برمیگرداند. (مستندات فنی)
- استعلام خلافی موتور — این سرویس با گرفتن شماره موبایل، کدملی و پلاک، لیست خلافی های موتور را همراه شماره قبض و شماره پرداخت برمیگرداند. (مستندات فنی)
- استعلام ریسک رانندگان — با وارد کردن کد ملی و تاریخ تولد راننده، میزان ریسک فرد در خروجی نمایش داده میشود. (مستندات فنی)
- استعلام سوابق بیمهنامه شخص ثالث — این سرویس با وارد کردن کد ملی و شماره پلاک، اطلاعات سوابق بیمهنامه شخص ثالث مربوط به خودرو را در خروجی نمایش میدهد. (مستندات فنی)
- استعلام طرح ترافیک — با وارد کردن شماره پلاک ۹ رقمی، کد ملی و موبایل، فهرست بدهی طرح ترافیک خودرو دریافت میشود. (مستندات فنی)
- استعلام عوارض آزادراهی — با وارد کردن شماره پلاک ۹ رقمی، فهرست قبضهای عوارض آزادراهی خودرو دریافت میشود. (مستندات فنی)
- استعلام گواهینامه و وضعیت — با وارد کردن شماره موبایل و کد ملی، اطلاعات گواهینامهها و وضعیت استعلام در خروجی نمایش داده میشود. (مستندات فنی)
- استعلام نمره منفی گواهینامه — سرویس استعلام نمره منفی گواهینامه با گرفتن شماره گواهینامه و استعلام آن از سازمان مربوطه، نمره منفی گواهینامه را در خروجی نمایش میدهد. (مستندات فنی)
- تاریخچه پلاک — با وارد کردن شماره پلاک و کد ملی، اطلاعات مربوط به نصب پلاک بر روی خودروها نمایش داده میشود. (مستندات فنی)
- تطبیق مالکیت خودرو — با وارد کردن شماره پلاک ۹ رقمی و کد ملی، تطبیق یا عدم تطبیق مالکیت خودرو در خروجی نمایش داده میشود. (مستندات فنی)
- دریافت تصویر تخلفات رانندگی — این سرویس با دریافت شناسه تخلف، تصویر ثبت شده ی خودرو و پلاک را برمیگرداند. (مستندات فنی)
- لیست پلاکهای فعال — با وارد کردن کد ملی و شماره موبایل، لیست پلاکهای فعال فرد در خروجی نمایش داده میشود. (مستندات فنی)