استعلام کارت و سند خودرو

آدرس سرویس: PUT https:/carbon/v4.0/vehicle_service/inquiry/card_document_car

---

شرح

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

---

Headers

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

  Authorization : Bearer {Token}
  clientAddress : client IP
  bundle-id : 
  USER_KEY :

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

توضیحات

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

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

• bundle-id: شناسه پکیج خریداری شده .

• USER_KEY: مقدار ثابت امنیت که به ازای هر کاربر جدا دریافت می شود .

Parameters

• request_number(نوع داده عددی):(اجباری) این شناسه جهت پیگیری های بعدی مورد استفاده قرار می گیرد و پیشنهاد میگردد یه شناسه یکتا به ازای هر درخواست توسط سامانه مشتری تولید و به این سرویس ارسال گردد. سامانه ابری کربن هیچ کنترلی بر روی عدم تکراری بودن این مقدار انجام نمی دهد.

• nationalCode (نوع داده عددی):(اجباری) کد ملی

• plateNumber (نوع داده عددی):(اجباری) پلاک خودرو به این صورت که به صورت تمام عددی و از سمت چپ عدد اخر پلاک که که تعیین کننده شهر است ، سپس حرف پلاک به صورت عددی طبق الگو داده شده توسط شرکت ارائه دهنده و در اخر پنج عدد پلاک به صورت پشت سر هم نوشته می شود .

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

curl --location --request PUT 'https:/carbon/v4.0/vehicle_service/inquiry/card_document_car' \
--header 'Authorization: ....' \
--header 'Content-Type: application/json' \
-header 'USER_KEY: .... \ 
--header 'bundle-id: ....' 
--data-raw '{
    "request_number":"202512342026",
    "nationalCode":"....",
    "plateNumber":"...."
}'

جواب موفق:

{
    "status": "0",
    "message": "تراکنش با موفقیت انجام شد",
    "timestamp": "2026-01-12 15:30:04.322",
    "tracking_number": "875153584",
    "request_number": "202512342026",
    "result": {
        "card_id": "4.0",
        "card_status": "تحويل شده به پست",
        "card_type": "عادي",
        "document_type": "عادي"
    },
    "transaction_details": {
        "available_wallet_balance": "100394000",
        "provider_name": "Pertikan",
        "service_price": "....",
        "curency": "IRR",
        "remaining_number_of_calls": "997",
        "remaining_number_of_calls_day": "997"
    },
    "errors": {}
}

جواب ناموفق:

{
    "status": "1",
    "message": "تراکنش ناموفق",
    "timestamp": "2026-01-12 15:58:42.364",
    "tracking_number": "875153587",
    "request_number": "202512342026",
    "result": {},
    "transaction_details": {},
    "errors": {
        "error_code": "5002",
        "error_description": "Transaction failed : Provider  Error",
        "reference_name": "47_",
        "original_value": ""
    }
}

• status: عدد 0 به معنی موفق و عدد 1 به معنی ناموفق می باشد
• message: پاسخ از طرف سرویس سامانه ابری کربن
• timestamp : زمان و تاریخ درخواست
• request_number: شماره پیگیری ارسال شده در زمان فراخوانی
• tracking_number: شماره پیگیری ایجاد شده توسط سامانه ابری کربن جهت بررسی های بعدی
• result: آبجکتی از پاسخ سرویس شامل:
• card_id : آیدی کارت
• card_status : وضعیت کارت
• card_type: مدل کارت
• document_type: مدل مدرک
• service_price: قیمت سرویس

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

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

---