API خلافی خودرو با جزئیات
فهرست تخلفات ثبت‌شده روی یک پلاک را برمی‌گرداند، هر قلم با نوع تخلف، زمان، نشانی و مبلغ خودش.
این سرویس چه میکند
راننده‌ای ساعت ۱۳:۰۶ یک روز مشخص از بزرگراهی عبور کرده و جریمه شده؛ شرکت می‌خواهد بداند آن ساعت خودرو دست چه کسی بوده. جواب این پرسش در جمع بدهی نیست، در ریز تخلف‌هاست، و این سرویس همان ریز را در آرایه‌ای به نام warnings برمی‌گرداند.
ورودی مثل سرویس جمع بدهی است: پلاک چهاربخشی، کد ملی مالک و موبایل مالک، هر سه الزامی. تفاوت در خروجی است که به‌جای یک مبلغ کل، یک فهرست میدهد.
هر قلم چه فیلدهایی دارد
هر عنصر warnings شناسه‌های خودش را دارد: warning_id، serial_no، paper_id و payment_id. نوع تخلف شیء است، نه رشته: violation_type.violation_type عنوان و violation_type.violation_type_id کد آن است. نحوهٔ ابلاغ هم شیء است (violation_delivery_type). مبلغ نهایی در final_price به‌شکل رشته میآید و دو نشانهٔ بولی هم هست: has_image برای ثبت‌شدن تصویر و investigation_ability برای امکان بررسی.
نکته‌هایی که پیش از ذخیره‌سازی باید یکدست شوند
کلید نشانی تخلف با املای violatoin_address برمیگردد، یعنی با «oi» جابهجا. دقیقاً همانطور بخوانیدش؛ اصلاحش در کد شما باعث میشود همیشه خالی بخواند. تاریخ و ساعت در violation_occure_date با هم و با خط تیره می‌آیند (مثل 1399/01/25 - 13:06) و ساعت جداگانه هم در violation_occure_time هست. متن‌های فارسی با یای عربی نوشته شدهاند، پس جستوجوی متنی با یای فارسی چیزی پیدا نمیکند مگر هر دو طرف را یکدست کنید.
هزینه و کش
قیمت بهازای هر فراخوان است، نه هر تخلف؛ فهرست ده‌قلمی و دوقلمی یک مبلغ دارند. پاسخ ممکن است برای مدتی کوتاه از کش بیاید و source.cached این را میگوید.
چه چیزی را نمیدهد
خود تصویر تخلف در پاسخ نیست و فقط نشانهٔ has_image هست. ثبت اعتراض هم از این مسیر ممکن نیست؛ investigation_ability فقط میگوید آن قلم قابلیت بررسی دارد. جمع کل و مهلت پرداخت هم در این پاسخ نیست و جمع کل را سرویس جمع بدهی میدهد.
کجا به کار میآید
- شرکت حمل‌ونقل بارزمان دقیق هر تخلف را با برنامهٔ شیفت رانندگان مقایسه می‌کنید تا جریمه به راننده‌ای برسد که پشت فرمان بوده.
- کارشناس اعتراض در شرکت اجارهاقلامی که `investigation_ability` دارند جدا می‌شوند و فقط همان‌ها به کارشناس می‌رسد، نه کل فهرست.
- بازرس نمایشگاه خودروی دست‌دومنوع تخلفها، مثل نداشتن برچسب معاینهٔ فنی، به بازرس نشان میدهد خودرو پیش‌تر در چه وضعیتی رانده شده است.
ورودی و خروجی
ورودی
plate.left2stringپلاک، دو رقم اولدو رقم.plate.letterstringپلاک، حرفیک حرف فارسی از فهرست.یکی از: الف، ب، پ، ت، ث، ج، د، ز، س، ش، ص، ط، ع، ف، ق، ک، گ، ل، م، ن، و، ه، ی، ژplate.right3stringپلاک، سه رقم میانیسه رقم.plate.iran2stringپلاک، کد استان (ایران)دو رقم، از 10 تا 99.nationalCodestringکد ملیده رقم، با رقم کنترل معتبر.mobilestringشمارهٔ موبایلیازده رقم که با 09 شروع میشود.نمونهٔ بدنهٔ درخواست
{
"plate": {
"left2": "12",
"letter": "ب",
"right3": "345",
"iran2": "67"
},
"nationalCode": "0013542419",
"mobile": "09120000000"
}خروجی
warningsarrayقیمت و شرط پرداخت
قیمت هر فراخوان API خلافی خودرو با جزئیات ۳۲٬۴۰۰ تومان است.
| تعداد استعلام در ماه | قیمت هر استعلام |
|---|---|
| همهٔ فراخوان‌ها | ۳۲٬۴۰۰ تومان |
آخرین تغییر قیمت:
مبلغ پیش از تماس با سرویس مرجع از موجودی پنل قفل میشود و اگر پاسخی نیاید، آزاد میشود. ورودی نامعتبر، در دسترس نبودن سرویس مرجع و عبور از سقف نرخ هزینه‌ای ندارند. «رکوردی یافت نشد» یک پاسخ معتبر است و هزینه دارد.
کمترین مبلغ شارژ پنل: ۵۰۰٬۰۰۰ تومان
پرسش‌های متداول
چرا ریز خلافی ماشین را نمیبینم و فقط یک عدد برمیگردد؟
عدد کل از سرویس جمع بدهی میآید. فهرست تخلفها در این سرویس است و با همان سه ورودی کار میکند: پلاک، کد ملی و موبایل مالک.
ریز خلافی خودرو شامل چه اطلاعاتی است؟
هر قلم نوع و کد تخلف، شیوهٔ ابلاغ، تاریخ و ساعت وقوع، نشانی، مبلغ نهایی، چند شناسه و دو نشانهٔ بولی برای تصویر و امکان بررسی دارد.
تصویر تخلف هم برمیگردد؟
نه. فقط has_image میگوید برای آن قلم تصویری ثبت شده یا نه. خود فایل تصویر در پاسخ نیست.
میشود از همین سرویس به جریمه اعتراض کرد؟
نه. این سرویس اعتراض ثبت نمیکند. investigation_ability فقط نشان میدهد قلم قابلیت بررسی دارد؛ ثبت اعتراض از مسیر دیگری انجام میشود.
چرا جستوجوی نوع تخلف در دادههایم چیزی پیدا نمیکند؟
چون متنها با یای و کاف عربی نوشته شدهاند. پیش از ذخیره یا مقایسه، آنها را به یای و کاف فارسی تبدیل کنید.
کلید نشانی تخلف چیست؟
violatoin_address، با املای جابهجا. همانطور که برمیگردد بخوانیدش؛ اگر آن را اصلاح کنید، مقدار خالی میماند.
برای خودرویی که تخلفی ندارد چه پاسخی میآید؟
نمونهٔ مستندات حالت بدون تخلف را نشان نمیدهد، پس شکل دقیقش مشخص نیست. کد شما باید هم غیبت warnings و هم آرایهٔ خالی را بپذیرد و خطا نشان ندهد.
هزینه بهازای هر تخلف است؟
نه. هزینه بهازای هر فراخوان موفق است و تعداد اقلام فهرست روی آن اثری ندارد. مبلغ هر فراخوان در billing.amountRial پاسخ آمده است.