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

مستندات API استعلام وضعیت گواهینامه | راهنمای کامل استفاده

در این صفحه می‌توانید راهنمای کامل استفاده از API استعلام وضعیت گواهینامه را مشاهده کنید. شامل پارامترهای ورودی، نمونه درخواست CURL، خروجی پاسخ، کدهای آماده و ویدئوی آموزشی برای درک بهتر عملکرد سرویس و استفاده آسان در پروژه‌های خود است. این مستندات به شما کمک می‌کند تا API را به‌صورت دقیق و سریع پیاده‌سازی کنید و از تمام قابلیت‌های سرویس بهره‌مند شوید.

📝 توضیحات سرویس

با استفاده از این وب سرویس می توانید با ارسال کد ملی و شماره موبایل لیستی از گواهینامه‌های فرد مورد نظر خود را در یافت نمایید. بر اساس قوانین جدید، اگر فرد دارای چند نوع گواهینامه باشد، تمامی گواهینامه‌های او در قالب یک گواهینامه و با یک شماره صادر می‌شود. با این حال، در این سرویس، هر گواهینامه به صورت جداگانه و در سطرهای مجزا نمایش داده می‌شود.

🏷️ CURL

📡 POST /api/v2/driving_license_status

curl --location 'https://shabanic.ir/api/v2/inquiry_returned_cheques' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {YOUR_SHABANIC_API_KEY}' \
--data '{
    "mobileNumber": "{YOUR_MOBILE_NUMBER}",
    "nationalCode": "{YOUR_NATIONAL_CODE}"
}'

📌 ورودی های سرویس

🗂️ JSON Inputs

    "mobileNumber": "{YOUR_MOBILE_NUMBER}",
    "nationalCode": "{YOUR_NATIONAL_CODE}"

📤 خروجی سرویس

🧾 JSON Response

        "success": true,
        "trackId": "shabanic-69ee6c54a9b9e9.87458154",
        "message": null,
        "result": {
            "drivingLicenceList": [
                {
                    "nationalNo": "0829940049",
                    "firstName": "يحيي",
                    "lastName": "جعفري",
                    "requestDate": "1395\/12\/02",
                    "title": "پايه سوم",
                    "printConfirmDate": "1395\/12\/17",
                    "rahvarStatus": "تحويل به پست",
                    "packetNo": "21692093817031945008",
                    "barcode": "21692093817031945008",
                    "printLicDate": "1395\/12\/20",
                    "printNum": "9509920489",
                    "printDate": "1395\/12\/17",
                    "validYears": "10"
                },
                {
                    "rahvarStatus": "تحويل به پست",
                    "statusId": "102",
                    "requestId": "52452055",
                    "errorCode": "0"
                }
            ]
        },
        "statusCode": 200

{
	"success": false,
	"error_code": "FN-BRFH-50000040816",
	"message": "پیغام مرتبط با خطا",
	"trackId": "shabanic-699dcc859daf40.50355751"
}
                            
برای پیگیری خطا کافیست مقدار trackId را به پشتیبانی شبانیک بدهید.

ℹ️ توضیحات سرویس استعلام وضعیت گواهینامه

این سرویس برای استعلام وضعیت گواهینامه استفاده می‌شود. در ادامه مشخصات کامل درخواست و پاسخ را مشاهده می‌کنید.

ورودی‌ها (Parameters)

  • nationalCode — کد ملی فرد مورد نظر
  • mobileNumber — شماره موبایل فرد مورد نظر

خروجی‌ها (Response)

  • nationalNo — شماره ملی
  • firstName — نام
  • lastName — نام خانوادگی
  • requestDate — تاریخ درخواست
  • title — نوع گواهینامه
  • printConfirmDate — تاریخ چاپ گواهینامه
  • rahvarStatus — وضعیت گواهینامه (توضیحات بیشتر در قالب سوالات متداول آخر همین صفحه)
  • packetNo — شماره سریال پاکت
  • barcode — بارکد
  • printLicDate — تاریخ چاپ گواهینامه
  • printNum — شماره گواهینامه
  • printDate — تاریخ صدور
  • validYears — تعداد سال‌های اعتبار
  • statusId — _
  • requestId — -
  • errorCode — -

کاربرد های این Api

نکات مهم

  • فعال‌سازی API شبانیک — برای شروع استفاده از APIهای شبانیک، ابتدا پروفایل خود را تکمیل کنید (مشاهده پروفایل) و سپس با پشتیبانی مستقیم شبانیک (09156012679) برای صدور مجوز و دریافت توکن اقدام نمایید.
  • توکن شبانیک — پس از دریافت مجوز، توکن خود را به‌عنوان Bearer در هدر درخواست‌ها قرار دهید.

🎬 ویدئوی آموزشی API استعلام وضعیت گواهینامه

در این ویدئو نحوه فراخوانی API استعلام وضعیت گواهینامه از سامانه شبانیک توضیح داده شده است.

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

در این بخش می‌توانید نمونه کدهای آماده برای فراخوانی API استعلام وضعیت گواهینامه شبانیک به زبان‌های PHP (Laravel)، JavaScript (Node.js)، Python، Java، Kotlin، C# (.NET) و cURL را دانلود کرده و مستقیماً در پروژه خود استفاده کنید.

نمونه کد PHP (Laravel) برای فراخوانی API استعلام وضعیت گواهینامه

دانلود فایل PHP

نمونه کد JavaScript (Node.js) برای استفاده از API استعلام وضعیت گواهینامه

دانلود فایل JavaScript

نمونه کد Python برای اتصال به API استعلام وضعیت گواهینامه شبانیک

دانلود فایل Python

نمونه کد Java (اندروید) برای فراخوانی API استعلام وضعیت گواهینامه

دانلود فایل Java

نمونه کد Kotlin برای استفاده از API استعلام وضعیت گواهینامه در اپلیکیشن موبایل

دانلود فایل Kotlin

نمونه کد C# (.NET) برای اتصال به API استعلام وضعیت گواهینامه

دانلود فایل C#

نمونه درخواست cURL برای تست API استعلام وضعیت گواهینامه

دانلود فایل cURL

❓ سوالات متداول (FAQ)

پاسخ به سوالات رایج در استفاده از سرویس استعلام وضعیت گواهینامه.

جدول کد وضعیت‌های گواهینامه: ردیف (Row) کد (Code) عنوان وضعیت (Status Title) 1 21 قبول آزمون تئوری 2 31 قبول آزمون عملی 3 41 تایید دفتر/آموزشگاه 4 61 قبول آزمون فنی 5 71 قبول آزمون تپه 6 101 رد شده کاردان فنی 7 111 منوط به نظر کاردان فنی 8 22 تایید شده راهور 9 32 رد شده راهور 10 62 چاپ شده 11 72 نقص چاپ - عکس 12 102 اسکن شده ناجی پاس 13 172 برگشتی از پست 14 182 پیدا شده 15 262 چاپ مجدد 16 272 چاپ مجدد راهور

آماده‌اید به ساده‌ترین شکل ممکن، API «استعلام وضعیت گواهینامه» را از شبانیک دریافت کنید؟

تنها در چند مرحله ساده، کلید اختصاصی API خود را دریافت کرده و سرویس استعلام وضعیت گواهینامه را در پروژه خود فعال کنید.