استعلام خلافی خودرو
خدمت‌دهنده
عصر داده
مقدمه
وب سرویس استعلام خلافی خودرو به کسب‌وکارها کمک می‌کند با دریافت کد ملی، شماره موبایل و تصویر پلاک خودروها اطلاعاتی نظیر مبلغ کل جریمه، شناسه قبض، شناسه پرداخت، مشخصات وسیله نقلیه، زمان و محل تخلف و توضیحات تخلف را به کاربر نشان دهند. همچنین با پرداخت هزینه اضافه کاربر می‌تواند به تصویر تخلف خود نیز دسترسی داشته باشد.
وب سرویس استعلام خلافی خودرو برای اپلیکیشن‌های پرداخت و یا سرویسهای لجستیک بزرگ مناسب است.
فعالسازی سرویس
ارسال درخواست در سایت پادیوم www.podium.ir:
ابتدا وارد سایت پادیوم شده، سپس در بازارچه‌ی API، سرویسهای مورد نظر خود را انتخاب و درخواست استفاده از آن مجموعه سرویس را ارسال کنید.
درخواست شما توسط کارشناسان پادیوم، بررسی شده و بعد از تایید آن می‌توانید از طربق پنل کسب و کار خود اقدام به دریافت کلید اتصال مربوط به آن سرویس نمایید.
منو: پنل کسب و کار – منوی میزکار سرویس گیرنده – درخواستهای ارسالی – در بخش مربوط به سرویس مورد نظر با کلیک بر روی "جزئیات درخواست"
درلیست باز شده با کلیک بر روی تصویر کلید سمت چپ هر سطر جدول می‌توانید ApiKey مربوط به آن سرویس را دریافت و ذخیره کنید.
لینک پنل کسب و کار https://panel.pod.ir/Businesses/Requestwebservices
نکته : این کلید در تمام درخواستهای ارسالی از آن سرویس ، ثابت است تا زمانی که کلید جدیدی برای آن سرویس دریافت نشود و به محض دریافت مقدار جدید برای سرویس مورد نظر, کلید قبلی منقضی خواهد شد.
-این کلید در فیلد scApiKey در بخش body درخواست HTTP ، استفاده می شود.
دریافت کلیدهای سرویس یک (دسته/مجموعه) سرویس در قالب یک فایل:
بعداز فشردن دکمه ی تایید سرویس در پنجره باز شده بالا ، برای تمامی سرویسهای موجود در پنل می‌توانید از گزینه "دریافت فایل خروجی"، لیست کاملی از سرویس‌ها و کلیدهای scApiKey متناظر با هر یک را دریافت کنید.
دریافت توکن:
پیش از فراخوانی سرویس‌ها می‌بایست توکن احراز هویت مربوط را از این سرویس دریافت کنید.
- شناسه سرویس
- محیط عملیاتی: 46742
- محیط تستی:
- پارامترهای ورودی: ندارد.
- خروجی: ساختار کلی پاسخ دریافتی در این لینک به تفصیل شرح داده شده است.
بدنۀ پاسخ دریافتی دارای ساختار زیر است:
| فیلد | نوع | توضیحات |
| token_type | string | نوع توکن |
| access_token | string | توکن دسترسی |
| expiration_time | number | مدت زمان اعتبار توکن (ثانیه) |
پس از دریافت توکن می‌بایست توکن را با فرمت زیر در فیلد Authorization در header درخواست ارسال کنید.
[token_type] [access_token]
به عنوان مثال:
Bearer ej745874
استعلام خلافی پیشرفته:
با استفاده از این سرویس می‌توان اطلاعات استعلام خلافی پیشرفته را به دست آورد.
- شناسه سرویس:
- محیط عملیاتی: 1537168
- محیط تستی:
- پارامترهای ورودی: Json Object با فیلدهای زیر:
| پارامتر | نوع | توضیحات |
| NationalId* | string | کد ملی شخص |
| Mobile* | string | شماره موبایل شخص |
| Parameter* | string | شماره پلاک با فرمت مشخص‌شده در پیوست 2 |
- خروجی: ساختار کلی پاسخ دریافتی در این لینک به تفصیل شرح داده شده است.
بدنۀ پاسخ دریافتی دارای ساختار زیر است:
پاسخ موفق:
| پارامتر | نوع | توضیحات |
| Status | int | کد وضعیت مطابق پیوست 1 |
| Message | string | توضیحات |
| Data | object | Json Object مطابق جدول |
جزئیات Data Json Object:
| پارامتر | نوع | توضیحات |
| SeparatedPlateNumber | object | شماره پلاک تفکیک‌شده مطابق جدول |
| PlateNumber | string | پلاک خودرو |
| TotalAmount | string | مبلغ کل جریمه |
| TotalBillId | string | شناسه قبض |
| TotalPayId | string | شناسه پرداخت |
| Bills | Object list | Json Object List از خلافی‌ها مطابق جدول |
جزئیات SeparatedPlateNumber Json Object:
| پارامتر | نوع | توضیحات |
| Type | string | نوع وسیله نقلیه |
| Part1 | string | بخش اول پلاک |
| Part2 | string | بخش دوم پلاک |
| Part3 | string | بخش سوم پلاک |
| Part4 | string | بخش چهارم پلاک |
| Part5 | string | بخش پنجم پلاک |
| Part6 | string | نوع وسیله نقلیه |
جزئیات هرکدام از Bills Json Objects:
| پارامتر | نوع | توضیحات |
| Amount | string | مبلغ |
| BillId | string | شناسه قبض |
| City | string | شهر |
| Date | string | تاریخ |
| DeliveryType | string | شرح تخلف |
| Location | string | محل تخلف |
| PayId | string | شناسه پرداخت |
| Type | string | نوع تخلف |
| TypeId | string | کد تخلف |
| ImageId | string | شناسه تصویر تخلف |
| SerialNumber | string | شماره سریال تخلف |
پاسخ ناموفق:
| پارامتر | نوع | توضیحات |
| Status | int | کد خطا مطابق پیوست 1 |
| Message | string | توضیحات |
دریافت تصویر تخلف رانندگی
با استفاده از این سرویس، اگر تخلف رانندگی دارای تصویر باشد، می‌توان تصویر تخلف رانندگی را دریافت کرد.
- شناسه سرویس:
- محیط عملیاتی: 1537751
- محیط تستی:
- پارامترهای ورودی: Json Object با فیلدهای زیر:
| پارامتر | نوع | توضیحات |
| ImageId* | string | شناسه تصویر |
- خروجی: ساختار کلی پاسخ دریافتی در این لینک به تفصیل شرح داده شده است.
بدنۀ پاسخ دریافتی دارای ساختار زیر است:
پاسخ موفق:
| پارامتر | نوع | توضیحات |
| Status | int | کد وضعیت مطابق پیوست 1 |
| Message | string | توضیحات |
| Data | object | Json Object مطابق جدول |
جزئیات Data Json Object:
| پارامتر | نوع | توضیحات |
| PlateImage | string | تصویر پلاک خودرو (Base64) |
| VehicleImage | string | تصویر کامل خودرو (Base64) |
پاسخ ناموفق:
| پارامتر | نوع | توضیحات |
| Status | int | کد خطا مطابق پیوست 1 |
| Message | string | توضیحات |
کدهای ارور (errorCode) معمول در پلتفرم
برای مشاهده‌ی کدهای ارور پلتفرم به این لینک مراجعه کنید.
پیوست 1: کدهای وضعیت
| شر ح | پیام پاسخ | کد پاسخ |
| موفق | Success | 0 |
| اجازه دسترسی ندارید | No Access | 101 |
| نوع قبض ارسال نشده است | Bill Type is Empty | 102 |
| پارامتر استعلام ارسال نشده است | Bill Parameter is Empty | 103 |
| مقدار ورودي نامعتبر است | Wrong Parameter | 104 |
| قبض پرداخت شده است | Bill Paid | 105 |
| قبضی یافت نشد | No Bill | 106 |
| نوع قبض اشتباه است | Bill Wrong Type | 107 |
| استعلام فعال نمی باشد | Service Totally Disabled | 108 |
| استعلام مورد نظر براي شما فعال نمی باشد | Service Disabled For User | 109 |
| سرویس با اختلال همراه است | Service Disabled | 110 |
| منطقه یافت نشد | Region Not Exists | 111 |
| منطقه پشتیبانی نمی شود | Region Not Supported | 112 |
| آرایه قبوض ارسال نشده است | Bills is Empty | 113 |
| مقدار آرایه قبوض نامعتبر است | Invalid Bills Data | 114 |
| خطا در درخواست فعالسازي تلف ن | Tel Activation Error | 131 |
| شماره تلفن ارسال نشده است | TelNumber is Empty | 132 |
| شماره تلفن نامعتبر است | TelNumber is Wrong | 133 |
| کد فعالسازي ارسال نشده است | ActivationCode is Empty | 134 |
| شماره تلفن نیاز به فعالسازي ندار د | This Tel Does Not Require Verification | 135 |
| شماره تلفن ابتدا نیاز به درخواست فعالسازي دارد | Tel Request ActivationCode Required | 136 |
| اشتراك یافت نشد | Package Not Exists | 137 |
| حجم استعلام براي اشتراك به اتمام رسیده است | Package Credit Used | 140 |
| شماره همراه ارسال نشده است | Mobile Is Empty | 141 |
| شماره همراه نامعتبر است | Mobile Is Invalid | 142 |
| کد ارسال نشده است | Code Is Empty | 143 |
| خطاي سرویس | Service Error | 144 |
| حداکثر تراکنش درثانیه انجام شده است (TPS) | Maximum Transaction Per Second Reached | 150 |
| شناسه درخواست پرداخت ارسال نشده است | Pay Request Id Is Empty | 151 |
| شناسه درخواست پرداخت صحیح نمی باشد | Pay Request Id Is Invalid | 152 |
| شناسه درخواست پرداخت نامعتبر است | Pay Request Id Not Exists | 153 |
| درخواست پرداخت قبلا بررسی شده است | Pay Request Id Processed | 154 |
| اعتبار کاربر جهت پرداخت کافی نمی باشد | User Credit Is Not Enough | 155 |
| درخواست پرداخت ناموفق شده است | Pay Request Failed | 156 |
| قبضی صادر نشده است. | No Bill Has Been Exported | 157 |
| شماره همراه ارسال نشده است | Mobile Is Empty | 201 |
| شماره همراه نادرست است | Mobile Is Invalid | 202 |
| شماره ملی وارد نشده است | NID Is Empty | 203 |
| شماره ملی نادرست است | NID Is Invalid | 204 |
| خطا | Error | 205 |
| کدیکبارمصرف ارسال نشده است | OTP Is Empty | 206 |
| کد پیگیري ارسال نشده است | TrackId Is Empty | 207 |
| کد پیگیري نادرست است | TrackId Is Invalid | 208 |
| کد پیگیري قبلا استفاده شده است | TrackId Used Before | 209 |
| خطا در تایید احراز هویت و کدیکبارمصرف | VerifySMS Error | 211 |
| خطا | GetAccessToken Error | 212 |
| نوع اعتبارسنجی نادرست است | Credit Type Is Invalid | 213 |
| کد اعتبارسنجی نادرست است | Code Is Invalid | 214 |
| درخواست نامعتبر است، احراز هویت مورد نیاز است | UnAuthorized Request. SMS Verification Required | 215 |
| نوع درخواست بانکی نامعتبر است | Service Type Is Invalid | 216 |
| کد اعتبارسنجی نادرست است | Code is Invalid | 217 |
| کد اعتبارسنجی ارسال نشده است | Code is Empty | 218 |
| در24ساعت گذشته اعتبارسنجی شده است | Credited In Last 24 Hours | 221 |
| احراز هویت مورد نیاز است | SMS Verification Required | 222 |
| خطا | Service Error | 225 |
| شماره چک ارسال نشده است | Cheque Number Is Empty | 231 |
| شماره چک نادرست است | Cheque Number is Invalid | 232 |
| اطلاعات یافت نشد | Information Not Found | 233 |
| شماره گواهینامه ارسال نشده است | License Number Is Empty | 301 |
| شماره گواهینامه نادرست است | License Number Is Invalid | 302 |
| اطلاعات یافت نشد | Information Not Found | 303 |
| شماره پلاك ارسال نشده است | Plate Number Is Empty | 304 |
| شماره پلاك نادرست است | Plate Number Is Invalid | 305 |
| کد ملی ارسال نشده است | National Id Is Empty | 306 |
| کد ملی نادرست است | National Id Is Invalid | 307 |
| شماره VIN ارسال نشده است | VIN Is Empty | 308 |
| شماره VIN نامعتبر است | VIN Is Invalid | 309 |
| اطلاعات یافت نشد | Information Not Found | 310 |
| اطلاعات یافت نشد | Information Not Found | 311 |
| اطلاعات یافت نشد | Information Not Found | 312 |
| اطلاعات یافت نشد | Information Not Found | 313 |
| اطلاعات یافت نشد | Information Not Found | 314 |
| تاریخ تولد ارسال نشده است | BirthDate Is Empty | 315 |
| تاریخ تولد نامعتبر است (xxxx/xx/xx ) | BirthDate Is Invalid | 316 |
| شماره همراه ارسال نشده است | Mobile Is Empty | 317 |
| شماره همراه نامعتبر است | Mobile Is Invalid | 318 |
| پیام خطا سامانه سخا (قبلا ثبت نام شده است) | Already Registered | 319 |
| کد ارسال نشده است | Code Is Empty | 320 |
| کد نامعتبر است | Code Is Invalid | 321 |
| رمزعبور ارسال نشده است | Password Is Empty | 322 |
| رمزعبور نامعتبر است | Password Is Invalid | 323 |
| ثبت نام یافت نشد یا کد نامعتبر است | Registration Not Found OR Code Is Invalid | 324 |
| خطاي فراموشی رمز عبور | Forget Password Error | 325 |
| کدملی ارسال نشده است | NationalId Is Empty | 328 |
| کدملی نامعتبر است | NationalId Is Invalid | 329 |
| بارکد ارسال نشده است | Barcode Is Empty | 331 |
| بارکد نامعتبر است | Barcode Is Invalid | 332 |
| کدملی ارسال نشده است | NationalId Is Empty | 333 |
| کدملی نامعتبر است | NationalId Is Invalid | 334 |
| خطاي سروی س استعلام | Service Error | 335 |
| موبایل ارسال نشده است | Mobile Is Empty | 340 |
| موبایل نامعتبر است | Mobile Is Invalid | 341 |
| کد ارسال نشده است | Code Is Empty | 342 |
| کد نامعتبر است | Code Is Invalid | 343 |
| نوع درخواست ارسال نشده است | Inquiry Type Is Empty | 344 |
| نوع درخواست نامعتبر است | Inquiry Type Is Invalid | 345 |
| پارامتر استعلام خلافی ارسال نشده است | DrivingOffense Parameter Is Empty | 346 |
| پارامتر استعلام خلافی نامعتبر است | DrivingOffense Parameter Is Invalid | 347 |
| شناسه تصویر تخلف ارسال نشده است | DrivingOffense ImageId Is Empty | 348 |
| شناسه تصویر تخلف نامعتبر است | DrivingOffense ImageId Is Invalid | 349 |
| تخلف یافت نش د | DrivingOffense Not Found | 351 |
| خطاي سرویس | Service Error | 352 |
| کدملی و موبایل مطابقت ندارند | NationalId And Mobile Not Match | 353 |
| کد اشتباه است | Code Is Wrong | 354 |
| اطلاعات ورودي مطابقت ندارند | Input Information Not Match | 355 |
| احراز هویت مورد نیاز نیست | Authentication Not Required | 356 |
| احراز هویت مورد نیاز است | Authentication Required | 357 |
| شناسه تصویر تخلف اشتباه است | DrivingOffense ImageId Is Wrong | 358 |
| استعلام خلافی پایه براي موتورسیکلت امکانپذیر نمی باشد | MotorCycle DrivingOffense Not Available | 359 |
| شماره مرسوله ارسال نشده است | Tracking Code Is Empty | 401 |
| شماره مرسوله نادرست است | Tracking Code Is Invalid | 402 |
| اطلاعات یافت نشد | Information Not Found | 403 |
| کدپستی ارسال نشده است | Post Code Is Empty | 404 |
| کدپستی نادرست است | Post Code Is Invalid | 405 |
| اطلاعات یافت نشد | Information Not Found | 406 |
| توکن نامعتبر است | No HTTP resource was found (401 Unauthorized) | 16 |
پیوست 2: بدست آوردن کد شماره پلاک
حروف پلاک
| کد حرف | حرف پلاك |
| 02 | ب |
| 03 | ت |
| 04 | ج |
| 05 | د |
| 06 | س |
| 07 | ص |
| 08 | ط |
| 09 | ع |
| 10 | ق |
| 11 | ل |
| 12 | م |
| 13 | ن |
| 14 | و |
| 15 | ه |
| 16 | ي |
| 19 | ژ |
نمونه:
پلاك خودرو:
