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

استعلام وضعیت گواهینامه یک شمارش و یک فهرست برمی‌گرداند. count تعداد گواهینامه‌هاست و هر ردیف driving_licenses این‌ها را دارد: نوع، وضعیت، شمارهٔ گواهینامه، نام و نام خانوادگی، تاریخ صدور، مدت اعتبار به سال، تاریخ درخواست، تاریخ تأیید، تاریخ چاپ و بارکد پستی. کسی که بیش از یک گواهینامه دارد، به همان تعداد ردیف می‌گیرد.

ورودی دو فیلد است، nationalCode و mobile. این استعلام برای خود دارنده ساخته شده: جایی به کار می‌آید که راننده با شمارهٔ خودش وارد محصول شما می‌شود و می‌خواهد بداند گواهینامه‌اش صادر، چاپ و ارسال شده یا نه.

شرط موبایل به‌نام دارنده

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

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

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

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

وقتی گواهینامه‌ای ثبت نیست، count صفر است و کلید driving_licenses اصلاً در پاسخ نمی‌آید. شرط را روی count بنویسید، نه روی وجود آرایه، تا پاسخ خالی با شکست فراخوان یکی نشود. این پاسخ خالی هم نتیجه است و هزینه دارد.

validity_years رشته است، نه عدد. اگر تاریخ انقضا را از روی تاریخ صدور حساب می‌کنید، اول مقدار را تبدیل و بررسی کنید و وقتی خالی بود، تاریخی حدس نزنید.