API استعلام نمره منفی گواهینامه

استعلام نمرهٔ منفی چهار مقدار برمی‌گرداند: شمارهٔ گواهینامه، نمرهٔ منفی، تعداد تخلف و حکمی که روی گواهینامه ثبت شده است. ورودی سه فیلد است، nationalCode، mobile و licenseNumber، و نبودِ هرکدام فراخوان را پیش از رسیدن به سامانهٔ مرجع رد می‌کند و مبلغی کسر نمی‌شود.

برای ناوگان‌ها و پلتفرم‌هایی که راننده به کار می‌گیرند، نمرهٔ منفی بی‌واسطه‌ترین نشانهٔ رفتار رانندگی است. با رسیدن نمرهٔ منفی به سقف تعیین‌شده در قانون، گواهینامه ممکن است ضبط شود؛ رانندهٔ نزدیک به آن سقف ریسکی است که بهتر است پیش از سپردن خودرو یا محموله دیده شود.

شرط مالکیت موبایل

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

آنچه این استعلام نمی‌کند

خلافی خودرو را نمی‌دهد. نمرهٔ منفی به راننده برمی‌گردد و جریمهٔ پرداخت‌نشده به پلاک؛ برای دومی استعلام خلافی خودرو جداست. ریز تخلف‌ها، تاریخ و محل هرکدام هم در پاسخ نیست، فقط شمار آن‌ها. آستانهٔ ضبط یا تعلیق را هم برنمی‌گرداند.

نکته پیاده‌سازی

اگر کاربر شمارهٔ گواهینامه را ندارد، اول «استعلام وضعیت گواهینامه» را با همان کد ملی و موبایل بزنید؛ license_number در ردیف‌های آن، ورودی همین استعلام است. دو فراخوان پشت سر هم، جای فرم سه‌فیلدی‌ای را می‌گیرد که کاربر وسطش رها می‌کند.

negative_score و offense_count عددند، ولی license_rule متن آزاد است. آن را برای نمایش نگه دارید و منطق تصمیم را روی متنش نسازید.