مستندات API
لیست خودروها - API Carlist
از این متد برای دریافت لیست خودروها استفاده میکنیم.
دسترسی به این API پس از ثبت درخواست با وارد کردن توکن به جای key مقدور خواهد بود و جهت ارسال درخواست سایر API های قیمت گذاری، اطلاعات این API مورد نیاز است.
استفاده از این API رایگان می باشد.
ساختار 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 | قیمت خودرو |
| CompanyPrice | Long | قیمت کارخانه |
| PriceDate | DateTime | تاریخ قیمت |
| OldDayPrice | Long | قیمت روز قبل |
| BrandId | Long | شناسه یکتای برند |
| RootBrandName | String | نام برند اصلی |
| EndYear | Long | آخرین سال مدل |
| Percent | Float | درصد تغییرات نسبت به آخرین قیمت |
نمونه خروجی
{
"cars": [
{
"Id": 15,
"Name": "سمند سورن پلاس مالتی مدیا",
"SubName": "EF7 رینگ فولادی",
"Price": 750000000,
"CompanyPrice": 500000000,
"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": 1404,
"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 | key | توکن اختصاصی شما |
| 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 | آیا درب عقب راست تعویض شده است؟ |
| carUserReplaced MudguardFL | Boolean | آیا گلگیر جلو چپ تعویض شده است؟ |
| carUserReplaced MudguardFR | Boolean | آیا گلگیر جلو راست تعویض شده است؟ |
| carUserReplaced MudguardBL | Boolean | آیا گلگیر عقب چپ تعویض شده است؟ |
| carUserReplaced MudguardBR | Boolean | آیا گلگیر عقب راست تعویض شده است؟ |
| carUserColoredFull | Boolean | آیا خودرو به طور کامل رنگ شده است؟ |
| carUserColoredAround | Boolean | آیا خودرو دور تا دور رنگ شده است؟ |
| carUserColoredKapoot | Boolean | آیا کاپوت رنگ شده است؟ |
| carUserColoredSaghf | Boolean | آیا سقف رنگ شده است؟ |
| carUserColoredSandogh | Boolean | آیا صندوق عقب رنگ شده است؟ |
| carUserColoredDoorFL | Boolean | آیا درب جلو چپ رنگ شده است؟ |
| carUserColoredDoorFR | Boolean | آیا درب جلو راست رنگ شده است؟ |
| carUserColoredDoorBL | Boolean | آیا درب عقب چپ رنگ شده است؟ |
| carUserColoredDoorBR | Boolean | آیا درب عقب راست رنگ شده است؟ |
| carUserColored MudguardFL | Boolean | آیا گلگیر جلو چپ رنگ شده است؟ |
| carUserColored MudguardFR | Boolean | آیا گلگیر جلو راست رنگ شده است؟ |
| carUserColored MudguardBL | Boolean | آیا گلگیر عقب چپ رنگ شده است؟ |
| carUserColored MudguardBR | Boolean | آیا گلگیر عقب راست رنگ شده است؟ |
| carUserColoredRekabR | Boolean | آیا رکاب راست رنگ شده است؟ |
| carUserColoredRekabL | Boolean | آیا رکاب چپ رنگ شده است؟ |
| carUserColorLess RefinementKapoot | Boolean | آیا کاپوت صافکاری بدون رنگ شده است؟ |
| carUserColorLess RefinementSaghf | Boolean | آیا سقف صافکاری بدون رنگ شده است؟ |
| carUserColor LessRefinementSandogh | Boolean | آیا صندوق عقب صافکاری بدون رنگ شده است؟ |
| carUserColorLess RefinementBottomSandogh | Boolean | آیا درب صندوق عقب صافکاری بدون رنگ شده است؟ |
| carUserColorLess RefinementDoorFL | Boolean | آیا درب جلو چپ صافکاری بدون رنگ شده است؟ |
| carUserColorLess RefinementDoorFR | Boolean | آیا درب جلو راست صافکاری بدون رنگ شده است؟ |
| carUserColorLess RefinementDoorBL | Boolean | آیا درب عقب چپ صافکاری بدون رنگ شده است؟ |
| carUserColorLess RefinementDoorBR | Boolean | آیا درب عقب راست صافکاری بدون رنگ شده است؟ |
| carUserColorLess RefinementMudguardFL | Boolean | آیا گلگیر جلو چپ صافکاری بدون رنگ شده است؟ |
| carUserColorLess RefinementMudguardFR | Boolean | آیا گلگیر جلو راست صافکاری بدون رنگ شده است؟ |
| carUserColorLess RefinementMudguardBL | Boolean | آیا گلگیر عقب چپ صافکاری بدون رنگ شده است؟ |
| carUserColorLess RefinementMudguardBR | 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
}
پارامترهای خروجی
| پارامتر | نوع | توضیح |
|---|---|---|
| CarPrice | Long | قیمت خودرو |
| CarId | Long | کد خودرو |
| CarKm | Long | کارکرد خودرو |
| CarModel | Long | مدل خودرو |
| CarColorId | Long | کد رنگ خودرو |
افت قیمت خودرو - API Falling
از این متد برای محاسبه افت قیمت خودرو خودروها استفاده میکنیم.
ساختار URL:
https://api.baravard.com:451/api/car/falling
پارامترهای ورودی
دقیقا ورودی های سرویس قیمت گذاری تخصصی خودرو می باشد.
نمونه خروجی
{
"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
}
]
}
