استعلام خلافی خودرو

آدرس سرویس: POST https:/carbon/v4.0/vehicle_service/inquiry/driving_violations

شرح

این سرویس جهت استعلام خلافی های خودرو مورد استفاده قرار می گیرد.

Headers

مقادیر زیر باید در هدر قرار بگیرد

  Authorization : Bearer {Token}
  clientAddress : client IP

توجه : برای دریافت توکن مربوطه به بخش سرویس توکن مراجعه فرمایید

توضیحات

Authorization: در این قسمت توکن دریافت شده از سرویس توکن را وارد نمایید

clientAddress: آی پی مشتری نهایی که سرویس را دریافت کرده است .

Parameters

request_number(نوع داده عددی):(اجباری) این شناسه جهت پیگیری های بعدی مورد استفاده قرار می گیرد و پیشنهاد میگردد یه شناسه یکتا به ازای هر درخواست توسط سامانه مشتری تولید و به این سرویس ارسال گردد. سامانه ابری کربن هیچ کنترلی بر روی عدم تکراری بودن این مقدار انجام نمی دهد.
mobile (نوع داده عددی):(اجباری) شماره موبایل
national_id (نوع داده عددی):(اجباری) کد ملی
plate_number (نوع داده عددی):(اجباری) شماره پلاک خودرو به این صورت ک دو عدد اول ، سپس برای حرف داخل پلاک ، عدد متناظر با اون حرف در الفبا قرار داده شود مثلا حرف س عدد مرتبط با آن 15 است و در اخر بقیه اعداد به ترتیب پست سر هم وارد شوند .

نمونه : 15ب765 ایران 55 جهت قرار دادن در سرویس برابر 150276555 است .(کد مربوط به حروف الفبا در جدول ذیل توضیح داده شده است)

نمونه درخواست:

curl --location 'https:/carbon/v4.0/vehicle_service/inquiry/driving_violations' \
--header 'Content-Type: application/json' \
--header 'accept: application/json' \
--header 'clientAddress: xxx' \
--header 'Authorization: ••••••' \
--data '{
    "request_number": "202511122024",
    "mobile": "....",
    "national_id":"....",
    "plate_number":"...."
}'

کد مربوط به حروف الفبا :

جواب موفق:

{
    "status": "0",
    "message": "تراکنش با موفقیت انجام شد",
    "timestamp": "2025-12-10 14:59:21.96",
    "tracking_number": "859684788",
    "request_number": "202511122024",
    "result": {
        "total_amount": "....",
        "bill_id": "....",
        "payment_id": "....",
        "plate_number": "....",
        "details": [
            {
                "amount": ....,
                "bill_id": "....",
                "payment_id": "....",
                "city": null,
                "delivery": "....",
                "has_image": true,
                "location": "",
                "serial_number": "",
                "type": "",
                "type_code": "",
                "rrn": "",
                "officer_code": "-",
                "date": "09/01/2025 06:19:00",
                "count": 1
            },
            {
              "amount": ....,
                "bill_id": "....",
                "payment_id": "....",
                "city": null,
                "delivery": "....",
                "has_image": true,
                "location": "",
                "serial_number": "",
                "type": "",
                "type_code": "",
                "rrn": "",
                "officer_code": "-",
                "date": "09/01/2025 06:19:00",
                "count": 1
            },
            {
              "amount": ....,
                "bill_id": "....",
                "payment_id": "....",
                "city": null,
                "delivery": "....",
                "has_image": true,
                "location": "",
                "serial_number": "",
                "type": "",
                "type_code": "",
                "rrn": "",
                "officer_code": "-",
                "date": "09/01/2025 06:19:00",
                "count": 1
            },
            {
              "amount": ....,
                "bill_id": "....",
                "payment_id": "....",
                "city": null,
                "delivery": "....",
                "has_image": true,
                "location": "",
                "serial_number": "",
                "type": "",
                "type_code": "",
                "rrn": "",
                "officer_code": "-",
                "date": "09/01/2025 06:19:00",
                "count": 1
            }
        ]
    },
    "transaction_details": {
        "available_wallet_balance": "101752000",
        "provider_name": "Pertikan",
        "service_price": "....",
        "curency": "IRR",
        "remaining_number_of_calls": "1000",
        "remaining_number_of_calls_day": "1000"
    },
    "errors": {}
}

جواب ناموفق:

{
    "status": "1",
    "message": "تراکنش ناموفق",
    "timestamp": "2025-12-10 15:22:29.617",
    "tracking_number": "20251210152229612",
    "req_id": "202511122024",
    "result": {},
    "transaction_detials": {},
    "errors": {
        "error_code": "6001",
        "error_description": "invalid input parameter: plate_number is not found ",
        "reference_name": "plate_number",
        "original_value": ""
    }
}

status: عدد 0 به معنی موفق و عدد 1 به معنی ناموفق می باشد
message: پاسخ از طرف سرویس سامانه ابری کربن
timestamp: زمان و تاریخ درخواست
request_number: شماره پیگیری ارسال شده در زمان فراخوانی
tracking_number: شماره پیگیری ایجاد شده توسط سامانه ابری کربن جهت بررسی های بعدی
result: آبجکتی از پاسخ سرویس شامل:
total_amount: مبلغ نهایی
bill_id: شناسه قبض
payment_id: شناسه پرداخت
plate_number: شماره پلاک
details: جزئیات جریمه ها
amount: مبلغ
bill_id: شناسه قبض
payment_id: شناسه پرداخت
city: شهر
delivery: گزارش دهنده
has_image: وضعیت عکس
location: مکان جریمه
serial_number: شماره سریال
type: مدل جریمه
type_code: کد مدل جریمه
rrn: مشخصه
officer_code: کد افسر
date: تاریخ
count: شمارنده

در صورت بروز خطا در درخواست :

errors: جزییات خطا
error_code: کد مربوط به خطایی که پیش آمده است
error_description: متن خطا
reference_name: اطلاعات تکمیلی خطا
original_value: اطلاعات تکمیلی خطا

Active	کد مروبطه	حروف الفبا	کد مربوطه	حروف الفبا
true	16	ش	01	الف
true	17	ص	02	ب
true	18	ض	03	پ
true	19	ط	04	ت
true	20	ظ	05	ث
true	21	ع	06	ج
true	22	غ	07	چ
true	23	ف	08	ح
true	24	ق	09	خ
true	25	ک	10	د
true	26	گ	11	ذ
true	27	ل	12	ر
true	28	م	13	ز
true	29	ن	14	ژ
true	30	و	15	س
true	32	ی	31	ه
true	34	تشریفات