API استعلام خلافی خودرو
جمع بدهی خلافی یک پلاک را همراه با شناسه قبض و شناسه پرداخت در یک فراخوان برمیگرداند.
این سرویس چه می‌کند
یک پلاک، یک کد ملی و یک شماره موبایل به سرویس می‌رود و یک رقم کل بدهی با دو شناسه برای پرداخت برمی‌گردد. خروجی جدول تخلفها نیست؛ خلاصهٔ مالی خودرو است و بس.
نمایشگاه خودرویی که پیش از نوشتن قولنامه می‌خواهد بداند روی پلاک بدهی نشسته یا نه، یا شرکت اجارهٔ خودرو که هنگام تحویل می‌خواهد بدهی را با تحویل قبلی مقایسه کند، اول به همین یک عدد نیاز دارد. اگر عدد صفر نبود، آن‌وقت سراغ ریز تخلفها می‌روند.
ورودی سه‌تکه و خطای ناقص‌بودن
هر سه ورودی الزامی‌اند: پلاک، کد ملی مالک و موبایل مالک. پلاک یک شیء با چهار بخش است: left2 دو رقم اول، letter یک حرف از فهرست مجاز، right3 سه رقم میانی و iran2 کد استان بین ۱۰ تا ۹۹. موبایل یازده رقم است و با ۰۹ شروع میشود. اگر یکی از این‌ها جا بیفتد یا قالبش غلط باشد، پاسخ invalid_input با فهرست فیلدهای مشکل‌دار می‌آید و هزینه‌ای کسر نمی‌شود.
شکل پاسخ
پاسخ در data چند فیلد متنی دارد: plate پلاک به‌شکلی که سرویس مرجع نوشته، inquire_price و warning_price مبلغ‌ها، price_status، paper_id شناسه قبض، payment_id شناسه پرداخت، ejr_inquire_no شماره پیگیری استعلام و page_count. مبلغ‌ها رشته‌اند نه عدد، پس پیش از جمع‌زدن تبدیلشان کنید. رشتهٔ plate با حرف‌های عربی و رقم‌های فارسی می‌آید؛ برای تطبیق با پلاکی که خودتان فرستاده‌اید، هر دو را یکدست کنید.
هزینه کی کسر میشود
پاسخ موفق هزینه دارد و رکوردنیافتن هم، چون استعلام انجام شده است. ورودی نامعتبر، خطای گذرای سرویس مرجع، نبودن موجودی و عبور از سقف نرخ هزینه ندارند. مبلغ واقعی هر فراخوان را در billing.amountRial بخوانید، نه از حدس خودتان. پاسخ این سرویس برای مدتی کوتاه ممکن است از کش بیاید؛ source.cached و source.fetchedAt نشان می‌دهند.
چه چیزی را نمی‌دهد
فهرست تخلفها در این پاسخ نیست؛ نوع، زمان و نشانی هر جریمه را سرویس ریز خلافی میدهد. پرداخت هم انجام نمی‌شود: شناسه‌ها را می‌گیرید و پرداخت را با درگاه خودتان انجام میدهید. مهلت پرداخت و جریمهٔ دیرکرد هم در پاسخ نیست.
کجا به کار می‌آید
- نمایشگاه خودروی دست‌دومپیش از ثبت قولنامه، بدهی روی پلاک را در همان فرم ثبت خودرو میبینید و در توافق با فروشنده، تسویه را شرط می‌کنید.
- شرکت اجارهٔ روزانهٔ خودروهنگام بازگشت هر خودرو، جمع بدهی را با مقدار روز تحویل مقایسه می‌کنید و فقط خودروهایی که عدد‌شان تغییر کرده سراغ ریز تخلف می‌روند.
- لیزینگ خودروپیش از تمدید قرارداد یا انتقال سند به مشتری، بدهی ثبت‌شده روی پلاک بخشی از چک‌لیست تسویه میشود.
ورودی و خروجی
ورودی
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"
}خروجی
ejr_inquire_nostring9XXXXXXXX0inquire_pricestring10000000page_countnumberpaper_idstring1XXXXXXXXX196payment_idstring6XXXXXXX15platestring شخصي ايران۱۱ ــ ۱۱۱ب۱۱price_statusstring1warning_pricestring10000000قیمت و شرط پرداخت
قیمت هر فراخوان API استعلام خلافی خودرو ۳۲٬۴۰۰ تومان است.
| تعداد استعلام در ماه | قیمت هر استعلام |
|---|---|
| همهٔ فراخوان‌ها | ۳۲٬۴۰۰ تومان |
آخرین تغییر قیمت:
مبلغ پیش از تماس با سرویس مرجع از موجودی پنل قفل میشود و اگر پاسخی نیاید، آزاد میشود. ورودی نامعتبر، در دسترس نبودن سرویس مرجع و عبور از سقف نرخ هزینه‌ای ندارند. «رکوردی یافت نشد» یک پاسخ معتبر است و هزینه دارد.
کمترین مبلغ شارژ پنل: ۵۰۰٬۰۰۰ تومان
پرسش‌های متداول
چرا برای خلافی ماشین موبایل و کد ملی مالک را هم می‌خواهد؟
چون ورودی این سرویس سه بخش الزامی دارد: پلاک، کد ملی و موبایل مالک. با پلاک تنها فراخوان پذیرفته نمی‌شود و پاسخ invalid_input می‌گیرید که هزینه ندارد.
استعلام خلافی خودرو آنلاین رایگان است؟
نه. هر فراخوان موفق از موجودی حساب شما کسر میشود و مبلغ دقیق در فیلد billing.amountRial پاسخ آمده است. تعرفهٔ زنده را در پنل میبینید. ورودی ناقص و عبور از سقف نرخ هزینه ندارند.
فرق جمع بدهی خلافی با ریز خلافی چیست؟
جمع بدهی یک مبلغ کل با شناسه قبض و شناسه پرداخت است. ریز خلافی فهرست تخلفها با نوع، زمان و نشانی هر کدام است و سرویس جداگانه‌ای دارد.
قبل از خرید خودرو دستدوم چه استعلامهایی بگیریم؟
این سرویس فقط بخش بدهی خلافی را میدهد. سایر استعلامهای خرید، مثل وضعیت سند، در این پاسخ نیستند. اگر عدد صفر نبود، برای دیدن تکتک تخلفها سراغ سرویس ریز خلافی بروید.
میشود خلافی را از همین سرویس پرداخت کرد؟
نه. سرویس فقط شناسهٔ قبض و شناسهٔ پرداخت را برمیگرداند. پرداخت را با درگاه یا برنامهٔ خودتان انجام میدهید.
با شمارهٔ VIN یا شاسی هم میشود خلافی را گرفت؟
نه. ورودی فقط پلاک چهاربخشی، کد ملی و موبایل مالک است. فیلدی برای VIN وجود ندارد.
اگر پلاک را اشتباه بفرستیم هزینه کسر میشود؟
بستگی دارد. قالب غلط، مثل حرف خارج از فهرست یا کد استان زیر ۱۰، همان‌جا invalid_input میشود و هزینه ندارد. اگر قالب درست باشد ولی پلاک متعلق به کسی دیگر باشد، پاسخ مرجع همان است که برمی‌گردد.
سقف تعداد فراخوان در دقیقه چقدر است؟
پیشفرض ۶۰ فراخوان در دقیقه برای هر سرویس است. عبور از آن پاسخ ۴۲۹ با هدر Retry-After میگیرد و هزینه ندارد. برای حجم بیشتر باید با پشتیبانی هماهنگ کنید.