مستندات API

لیست خودروها - API Carlist

از این متد برای دریافت لیست خودروها استفاده می‌کنیم.

ساختار URL:

https://api.baravard.com:451/api/car/carlist?key=xxxxxxxxx

پارامترهای ورودی

پارامتر نوع توضیح
key String توکن اختصاصی شما

پارامترهای خروجی

پارامتر نوع توضیح
id Long شناسه یکتای خودرو
name String نام خودرو
bId Long شناسه یکتای برند خودرو
rbn Long نام برند اصلی
brands array لیست ابجکت‌های برند این خودرو
birthYear Long اولین سال ساخت این خودرو
endYear Long آخرین سال ساخت این خودرو

لیست رنگ‌های خودرو - API CarColorList

از این متد برای دریافت لیست رنگ خودروها استفاده می‌کنیم.

ساختار URL:

https://api.baravard.com:451/api/car/carcolorlist?key=xxxxxxxxx&carId=207

پارامترهای ورودی

پارامتر نوع توضیح
key String توکن اختصاصی شما
carId Long شناسه یکتای خودرو

پارامترهای خروجی

پارامتر نوع توضیح
id Long شناسه یکتای رنگ
name String نام رنگ
code String کد رنگ

لیست قیمت صفر - API Zero List

از این متد برای دریافت لیست قیمت خودروهای صفر استفاده می‌شود.

ساختار URL:

https://api.baravard.com:451/api/car/zerolist?key=xxxxxxxxxxxxxxx

پارامترهای ورودی

پارامتر نوع توضیح
key String توکن اختصاصی شما

پارامترهای خروجی

پارامتر نوع توضیح
Id Long شناسه یکتای خودرو
Name String نام خودرو
SubName String نام تکمیلی
Price Long قیمت خودرو
PriceDate DateTime تاریخ قیمت
OldDayPrice Long قیمت روز قبل
BrandId Long شناسه یکتای برند
RootBrandName String نام برند اصلی
EndYear Long آخرین سال مدل
Percent Float درصد تغییرات نسبت به آخرین قیمت

نمونه خروجی

  
{  
    "cars": [  
        {  
            "Id": 15,  
            "Name": "سمند سورن پلاس مالتی مدیا",  
            "SubName": "EF7 رینگ فولادی",  
            "Price": 750000000,  
            "PriceDate": "2025-02-02T15:45:01.1304854",  
            "OldDayPrice": 750000000,  
            "BrandId": 425,  
            "RootBrandName": "سمند",  
            "EndYear": 1402,  
            "Percent": 0.0  
        },  
        {  
            "Id": 28,  
            "Name": "دنا پلاس توربو اتوماتیک",  
            "SubName": "",  
            "Price": 1030000000,  
            "PriceDate": "2025-02-02T15:34:59.2586676",  
            "OldDayPrice": 1030000000,  
            "BrandId": 22,  
            "RootBrandName": "دنا",  
            "EndYear": 1403,  
            "Percent": 0.0  
        }  
    ]  
}  
            

قیمت‌گذاری - API Pricing

از این متد برای قیمت‌گذاری خودروها استفاده می‌کنیم.

ساختار URL:

https://api.baravard.com:451/api/car/pricing?key=xxxxxxxxx&carId=207&km=-1&model=-1&colorId=-1

پارامترهای ورودی

پارامتر نوع توضیح
key String توکن اختصاصی شما
carId Long کد خودرو
km Long کارکرد خودرو. در صورت ارسال عدد -1، برای هر مدل، قیمت با کارکرد متعارف آن مدل محاسبه می‌گردد.
model Long مدل خودرو. در صورت ارسال عدد -1، قیمت با آخرین مدل این خودرو محاسبه می‌گردد.
colorId Long کد رنگ خودرو. در صورت ارسال عدد -1، قیمت با رنگ متعارف خودرو محاسبه می‌گردد.

پارامترهای خروجی

پارامتر نوع توضیح
CarPrice Long قیمت خودرو
CarId Long کد خودرو
CarKm Long کارکرد خودرو
CarModel Long مدل خودرو
CarColorId Long کد رنگ خودرو

قیمت گذاری تخصصی خودرو - API Car Full Pricing

از این متد برای دریافت جزئیات قیمت خودرو استفاده می‌شود.

ساختار URL:

https://api.baravard.com:451/api/car/fullpricing

پارامترهای ورودی

پارامتر نوع توضیح
token *************************** توکن اختصاصی شما
carId Long شناسه خودرو شما
colorId Long شناسه رنگ خودرو. در صورت ارسال عدد -۱، قیمت با رنگ متعارف خودرو محاسبه می‌گردد.
carUserKm Long کارکرد خودرو. در صورت ارسال عدد -۱، برای هر مدل، قیمت با کارکرد متعارف آن مدل محاسبه می‌گردد.
carUserModel Long مدل خودرو. در صورت ارسال عدد -۱، قیمت با آخرین مدل این خودرو محاسبه می‌گردد.
coloredSpots Long تعداد لکه‌های رنگی روی بدنه از 1 تا 4
carUserScratch Long خط و خش. ۰ ندارد، ۱ کم، ۲ زیاد
carUserReplacedRoom Boolean آیا اتاق خودرو تعویض شده است؟
carUserReplacedKapoot Boolean آیا کاپوت تعویض شده است؟
carUserReplacedSaghf Boolean آیا سقف خودرو تعویض شده است؟
carUserReplacedSandogh Boolean آیا صندوق عقب تعویض شده است؟
carUserReplacedSotoon Boolean آیا ستون‌ها تعویض شده‌اند؟
carUserReplacedDoorFL Boolean آیا درب جلو چپ تعویض شده است؟
carUserReplacedDoorFR Boolean آیا درب جلو راست تعویض شده است؟
carUserReplacedDoorBL Boolean آیا درب عقب چپ تعویض شده است؟
carUserReplacedDoorBR Boolean آیا درب عقب راست تعویض شده است؟
carUserReplacedMudguardFL Boolean آیا گلگیر جلو چپ تعویض شده است؟
carUserReplacedMudguardFR Boolean آیا گلگیر جلو راست تعویض شده است؟
carUserReplacedMudguardBL Boolean آیا گلگیر عقب چپ تعویض شده است؟
carUserReplacedMudguardBR Boolean آیا گلگیر عقب راست تعویض شده است؟
carUserColoredFull Boolean آیا خودرو به طور کامل رنگ شده است؟
carUserColoredAround Boolean آیا خودرو دور تا دور رنگ شده است؟
carUserColoredKapoot Boolean آیا کاپوت رنگ شده است؟
carUserColoredSaghf Boolean آیا سقف رنگ شده است؟
carUserColoredSandogh Boolean آیا صندوق عقب رنگ شده است؟
carUserColoredDoorFL Boolean آیا درب جلو چپ رنگ شده است؟
carUserColoredDoorFR Boolean آیا درب جلو راست رنگ شده است؟
carUserColoredDoorBL Boolean آیا درب عقب چپ رنگ شده است؟
carUserColoredDoorBR Boolean آیا درب عقب راست رنگ شده است؟
carUserColoredMudguardFL Boolean آیا گلگیر جلو چپ رنگ شده است؟
carUserColoredMudguardFR Boolean آیا گلگیر جلو راست رنگ شده است؟
carUserColoredMudguardBL Boolean آیا گلگیر عقب چپ رنگ شده است؟
carUserColoredMudguardBR Boolean آیا گلگیر عقب راست رنگ شده است؟
carUserColoredRekabR Boolean آیا رکاب راست رنگ شده است؟
carUserColoredRekabL Boolean آیا رکاب چپ رنگ شده است؟
carUserColorLessRefinementKapoot Boolean آیا کاپوت صافکاری بدون رنگ شده است؟
carUserColorLessRefinementSaghf Boolean آیا سقف صافکاری بدون رنگ شده است؟
carUserColorLessRefinementSandogh Boolean آیا صندوق عقب صافکاری بدون رنگ شده است؟
carUserColorLessRefinementBottomSandogh Boolean آیا قسمت پایین صندوق عقب صافکاری بدون رنگ شده است؟
carUserColorLessRefinementDoorFL Boolean آیا درب جلو چپ صافکاری بدون رنگ شده است؟
carUserColorLessRefinementDoorFR Boolean آیا درب جلو راست صافکاری بدون رنگ شده است؟
carUserColorLessRefinementDoorBL Boolean آیا درب عقب چپ صافکاری بدون رنگ شده است؟
carUserColorLessRefinementDoorBR Boolean آیا درب عقب راست صافکاری بدون رنگ شده است؟
carUserColorLessRefinementMudguardFL Boolean آیا گلگیر جلو چپ صافکاری بدون رنگ شده است؟
carUserColorLessRefinementMudguardFR Boolean آیا گلگیر جلو راست صافکاری بدون رنگ شده است؟
carUserColorLessRefinementMudguardBL Boolean آیا گلگیر عقب چپ صافکاری بدون رنگ شده است؟
carUserColorLessRefinementMudguardBR Boolean آیا گلگیر عقب راست صافکاری بدون رنگ شده است؟
carUserHitChassisFL Boolean آیا شاسی جلو چپ ضربه دیده است؟
carUserHitChassisFR Boolean آیا شاسی جلو راست ضربه دیده است؟
carUserHitChassisBL Boolean آیا شاسی عقب چپ ضربه دیده است؟
carUserHitChassisBR Boolean آیا شاسی عقب راست ضربه دیده است؟
carUserHitSiniFL Boolean آیا سینی جلو چپ ضربه دیده است؟
carUserHitSiniFR Boolean آیا سینی جلو راست ضربه دیده است؟
carUserHitSiniBL Boolean آیا سینی عقب چپ ضربه دیده است؟
carUserHitSiniBR Boolean آیا سینی عقب راست ضربه دیده است؟
carUserHitSotoonFL Boolean آیا ستون جلو چپ ضربه دیده است؟
carUserHitSotoonFR Boolean آیا ستون جلو راست ضربه دیده است؟
carUserHitSotoonBL Boolean آیا ستون عقب چپ ضربه دیده است؟
carUserHitSotoonBR Boolean آیا ستون عقب راست ضربه دیده است؟
carUserHitSotoonML Boolean آیا ستون میانی چپ ضربه دیده است؟
carUserHitSotoonMR Boolean آیا ستون میانی راست ضربه دیده است؟
carUserHitKalafL Boolean آیا کلاف چپ ضربه دیده است؟
carUserHitKalafR Boolean آیا کلاف راست ضربه دیده است؟
carUserRotKapoot Boolean آیا کاپوت دچار پوسیدگی شده است؟
carUserRotChassis Boolean آیا شاسی دچار پوسیدگی شده است؟
carUserRotSandogh Boolean آیا صندوق عقب دچار پوسیدگی شده است؟
carUserRotFloor Boolean آیا زیر خودرو دچار پوسیدگی شده است؟
carUserRotRekab Boolean آیا رکاب دچار پوسیدگی شده است؟
carUserRotMudguard Boolean آیا گلگیر دچار پوسیدگی شده است؟
carUserSunburnKapoot Boolean آیا کاپوت دچار آفتاب سوختگی شده است؟
carUserSunburnSaghf Boolean آیا سقف دچار آفتاب سوختگی شده است؟
carUserSunburnSandogh Boolean آیا صندوق عقب دچار آفتاب سوختگی شده است؟
carUserSunburnMudguard Boolean آیا گلگیر دچار آفتاب سوختگی شده است؟

نمونه ورودی

  
{
  "token": "*****-*****-*****-*****-*****",
  "carId": 207,
  "colorId": -1,  
  "carUserKm": -1,
  "carUserModel": -1,

  "coloredSpots": 0,
  "carUserScratch": 0,

  "carUserReplacedRoom": false,
  "carUserReplacedKapoot": false,
  "carUserReplacedSaghf": false,
  "carUserReplacedSandogh": false,
  "carUserReplacedSotoon": false,
  "carUserReplacedDoorFL": false,
  "carUserReplacedDoorFR": false,
  "carUserReplacedDoorBL": false,
  "carUserReplacedDoorBR": false,
  "carUserReplacedMudguardFL": false,
  "carUserReplacedMudguardFR": false,
  "carUserReplacedMudguardBL": false,
  "carUserReplacedMudguardBR": false,

  "carUserColoredFull": false,
  "carUserColoredAround": false,
  "carUserColoredKapoot": true,
  "carUserColoredSaghf": false,
  "carUserColoredSandogh": false,
  "carUserColoredDoorFL": false,
  "carUserColoredDoorFR": false,
  "carUserColoredDoorBL": false,
  "carUserColoredDoorBR": false,
  "carUserColoredMudguardFL": false,
  "carUserColoredMudguardFR": false,
  "carUserColoredMudguardBL": false,
  "carUserColoredMudguardBR": false,
  "carUserColoredRekabR": false,
  "carUserColoredRekabL": false,

  "carUserColorLessRefinementKapoot": false,
  "carUserColorLessRefinementSaghf": false,
  "carUserColorLessRefinementSandogh": false,
  "carUserColorLessRefinementBottomSandogh": false,
  "carUserColorLessRefinementDoorFL": false,
  "carUserColorLessRefinementDoorFR": false,
  "carUserColorLessRefinementDoorBL": false,
  "carUserColorLessRefinementDoorBR": false,
  "carUserColorLessRefinementMudguardFL": false,
  "carUserColorLessRefinementMudguardFR": false,
  "carUserColorLessRefinementMudguardBL": false,
  "carUserColorLessRefinementMudguardBR": false,

  "carUserHitChassisFL": false,
  "carUserHitChassisFR": false,
  "carUserHitChassisBL": false,
  "carUserHitChassisBR": false,
  "carUserHitSiniFL": false,
  "carUserHitSiniFR": false,
  "carUserHitSiniBL": false,
  "carUserHitSiniBR": false,

  "carUserHitSotoonFL": false,
  "carUserHitSotoonFR": false,
  "carUserHitSotoonBL": false,
  "carUserHitSotoonBR": false,
  "carUserHitSotoonML": false,
  "carUserHitSotoonMR": false,
  "carUserHitKalafL": false,
  "carUserHitKalafR": false,

  "carUserRotKapoot": false,
  "carUserRotChassis": false,
  "carUserRotSandogh": false,
  "carUserRotFloor": false,
  "carUserRotRekab": false,
  "carUserRotMudguard": false,

  "carUserSunburnKapoot": false,
  "carUserSunburnSaghf": false,
  "carUserSunburnSandogh": false,
  "carUserSunburnMudguard": false
}
    

نمونه خروجی

  
{  
    "CarId": 207,  
    "CarModel": 1401,  
    "CarKm": 0.0,  
    "CarBrandName": "شاهین دنده ای G",  
    "PriceDate": "2025-02-02T15:45:39.4495186",  
    "IntDaysOldPriceDate": 3.0,  
    "CarPrice": 760000000,  
    "CarPriceBaseKarkard": 730000000,  
    "PriceOptions": 0,  
    "PriceRing": 0,  
    "PriceCostOptions": 0,  
    "PriceCostHealthCooler": 0,  
    "PriceCostHealthEngine": 0,  
    "PriceCostHealthJeloBandy": 0,  
    "PriceCostHealthHeaters": 0,  
    "PriceCostHealthGearBox": 0,  
    "PriceCostNeedSmoothBody": 0,  
    "PriceInsurance": 0,  
    "PriceReplaced": 0,  
    "PriceKarkard": 31000000,  
    "PriceColor": 0,  
    "PriceLining": 0,  
    "PriceFrontTires": 0,  
    "PriceBackTires": 0,  
    "PriceColoredParts": 0,  
    "PriceHitChassis": 0,  
    "PriceRot": 0,  
    "PriceSmoothBody": 0,  
    "PriceScratch": 0,  
    "PriceColored": 0,  
    "PriceReduction": 0,  
    "PriceSunburn": 0,  
    "PriceHitdSotoon": 0,  
    "PricingFactors": [  
        {  
            "Name": "آپشنهای اضافی",  
            "Price": 0  
        },  
        {  
            "Name": "رینگ",  
            "Price": 0  
        },  
        {  
            "Name": "آپشنها",  
            "Price": 0  
        },  
        {  
            "Name": "سیستم تهویه",  
            "Price": 0  
        },  
        {  
            "Name": "موتور",  
            "Price": 0  
        },  
        {  
            "Name": "جلوبندی",  
            "Price": 0  
        },  
        {  
            "Name": "گرمکن",  
            "Price": 0  
        },  
        {  
            "Name": "گیربکس",  
            "Price": 0  
        },  
        {  
            "Name": "صافکاری و رنگ",  
            "Price": 0  
        },  
        {  
            "Name": "اعتبار بیمه",  
            "Price": 0  
        },  
        {  
            "Name": "کم کار",  
            "Price": 31000000  
        },  
        {  
            "Name": "رنگ خودرو",  
            "Price": 0  
        },  
        {  
            "Name": "تودوزی",  
            "Price": 0  
        },  
        {  
            "Name": "لاستیک جلو",  
            "Price": 0  
        },  
        {  
            "Name": "لاستیک عقب",  
            "Price": 0  
        },  
        {  
            "Name": "رنگ شدگی",  
            "Price": 0  
        },  
        {  
            "Name": "ضربه خوردگی شاسی یا سینی",  
            "Price": 0  
        },  
        {  
            "Name": "پوسیدگی",  
            "Price": 0  
        },  
        {  
            "Name": "صافکاری بدون رنگ",  
            "Price": 0  
        },  
        {  
            "Name": "خط و خش",  
            "Price": 0  
        },  
        {  
            "Name": "لکه رنگی",  
            "Price": 0  
        },  
        {  
            "Name": "کاهش اضافی",  
            "Price": 0  
        },  
        {  
            "Name": "آفتاب سوختگی",  
            "Price": 0  
        },  
        {  
            "Name": "ضربه خوردگی ستون یا کلاف",  
            "Price": 0  
        },  
        {  
            "Name": "قطعات تعویضی بدنه",  
            "Price": 0  
        }  
    ]  
}
    

افت قیمت خودرو - API Falling

از این متد برای محاسبه افت قیمت خودرو خودروها استفاده می‌کنیم.

ساختار URL:

https://api.baravard.com:451/api/car/falling

پارامترهای ورودی

دقیقا ورودی های سرویس قیمت گذاری تخصصی خودرو می باشد.

پارامترهای خروجی

پارامتر نوع توضیح
CarPrice Long قیمت خودرو
CarId Long کد خودرو
CarKm Long کارکرد خودرو
CarModel Long مدل خودرو
CarColorId Long کد رنگ خودرو