ClearVin API - واجهة برمجة تطبيقات وحدة فك ترميز VIN للمركبات الأمريكية والكندية
توفر واجهة برمجة تطبيقات فك تشفير رقم VIN الخاصة بنا تكاملاً سلسًا وفعّالاً من حيث التكلفة لقاعدة بيانات فك تشفير رقم VIN الخاصة بنا في منتجاتك أو خدماتك أو حلولك. نقوم بتقسيم رقم VIN لتزويدك بنقاط بيانات شاملة تتعلق بتفاصيل تصنيع السيارة. يتضمن ذلك معلومات أساسية مثل سنة تصنيع السيارة والطراز والطراز ومستوى القطع والمواصفات الفنية لرقم VIN والميزات القياسية التي تضم ما يصل إلى 150 معلمة. تغطي قاعدة بيانات المركبات الخاصة بنا أكواد VIN في أمريكا الشمالية (الولايات المتحدة وكندا) للسيارات وسيارات الدفع الرباعي والشاحنات الصغيرة والشاحنات الثقيلة والمتوسطة والدراجات النارية، والتي تمتد من عام 1981 إلى عام 2026، مع تحديثات يومية لضمان الدقة والملاءمة.
التخويل
ستحتاج إلى استخدام البريد الإلكتروني وكلمة المرور للحصول على رمز الوصول باستخدام عنوان URL هذا:POST https://www.clearvin.com/rest/vendor/login
يجب أن يكون الطلب من عنوان IP مسجل.يجب أن تكون الحمولة:
{
"email" : “[email protected]”,
"password": "11111111"
}استجابه
| عنصر | وصف | تنسيق |
|---|---|---|
| status | تحديد ما إذا كان الطلب قد تمت معالجته بنجاح، أو أنهى بخطأ | سلسلة error أو ok |
| message | يحتوي على تفاصيل حول النتيجة إذا كانت الحالة error | سلسله |
| token | JSON رمز الويب. تنتهي صلاحية الرمز المميز في غضون 120 دقائق | سلسله |
إذا كان البريد الإلكتروني وكلمة المرور صحيحة سيتم إرجاع الرمز المميز استجابة مع الرمز المميز كما يلي:
{
"status": "ok",
"token": " I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0"
}تقرير
بعد تلقي هذا الرمز المميز يمكنك استخدامه للوصول إلى التقارير باستخدام عنوان URL هذا:GET https://www.clearvin.com/rest/vendor/report?vin=5UXFA13544LU21050
لاستخدام نقطة النهاية هذه، تحتاج إلى توفير رأس HTTP مع الرمز المميز الذي تم توفيره كما يلي:Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0
استجابه
| عنصر | وصف | اكتب |
|---|---|---|
| status | تحديد ما إذا كان الطلب قد تمت معالجته بنجاح، أو أنهى بخطأ | سلسلة error أو ok |
| message | يحتوي على تفاصيل حول النتيجة إذا كانت الحالة error | سلسله |
| Report id | يحتوي على معرف التقرير الحالي | سلسله |
| Report vin | طلب فين | سلسله |
| Report report | يحتوي على معلومات كاملة عن السيارة | كائن JSON |
يمكنك أيضاً تلقي التقارير في طريقة عرض HTML باستخدام عنوان URL مثل هذا:
GET https://www.clearvin.com/rest/vendor/report?vin=5UXFA13544LU21050&format=html
وتوفير رؤوس HTTP التالية:
Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0
Content-Type: text/html
نجاح الويث
طلب
curl -X POST \
https://www.clearvin.com/rest/vendor/login \
-H 'Content-Type: application/json' \
-d '{
"email": "[email protected]",
"password": "yourpassword"
}نجاح الاستجابة
{
"status": "ok",
"token": "I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0"
}خطأ في الاستجابة
{
"status": "error",
"message": "Wrong username or password"
}تقرير
طلب
curl - X GET\ 'https://www.clearvin.com/rest/vendor/report?vin=WBAFR7C57CC811956'\ -
H 'Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0'\ -
H 'Content-Type: application/json'نجاح الاستجابة
{
"status": "ok",
"result": {
"id": "3646F9E2",
"vin": "5FNYF4H52BB038147",
"report": {
"decoder": {
"vin": "5FNYF4H52BB038147",
"make": "Honda",
"msrp": "$35,595 USD",
"trim": "EX-L 4WD 5-Spd AT",
"year": "2011",
"depth": "",
"model": "Pilot",
"style": "SPORT UTILITY 4-DR",
"tires": "245/65R17",
"width": "78.50 in.",
"4WdAwd": "Std.",
"engine": "3.5L V6 SOHC 24V",
"height": "72.70 in.",
"length": "190.90 in.",
"madeIn": "UNITED STATES",
"invoice": "",
"cargoNet": "N/A",
"cdPlayer": "Std.",
"extended": true,
"fuelTank": "21.00 gallon",
"absBrakes": "Std.",
"amFmRadio": "Std.",
"cdChanger": "Std.",
"driveline": "4WD",
"dvdPlayer": "N/A",
"fogLights": "Std.",
"rearWiper": "Std.",
"skidPlate": "N/A",
"subwoofer": "Std.",
"trackRear": "67.50 in.",
"wheelbase": "109.20 in.",
"tachometer": "Std.",
"trackFront": "67.70 in.",
"alloyWheels": "Std.",
"cargoLength": "",
"cargoVolume": "18.00 cu.ft.",
"cityMileage": "16 miles/gallon",
"firstAidKit": "N/A",
"frontAirDam": "Std.",
"leatherSeat": "Std.",
"maximumGvwr": "6096 lbs",
"rearHipRoom": "56.90 in.",
"rearLegroom": "38.50 in.",
"rearSpoiler": "N/A",
"steelWheels": "N/A",
"widthAtWall": "",
"chromeWheels": "N/A",
"driverAirbag": "Std.",
"frontHipRoom": "58.60 in.",
"frontLegroom": "41.40 in.",
"interiorTrim": "Beige Leather Interior | Black Leather Interior | Gray Leather Interior",
"keylessEntry": "Std.",
"powerSunroof": "Std.",
"powerWindows": "Std.",
"rearHeadroom": "39.80 in.",
"removableTop": "N/A",
"runFlatTires": "N/A",
"rustDistance": "Unlimited mile",
"rustDuration": "60 month",
"splashGuards": "Std.",
"standardGvwr": "6096 lbs",
"steeringType": "R&P",
"tiltSteering": "Std.",
"tripComputer": "Std.",
"basicDistance": "36,000 mile",
"basicDuration": "36 month",
"cruiseControl": "Std.",
"exteriorColor": "Alabaster Silver Metallic | Bali Blue Pearl | Crystal Black Pearl | Dark Cherry Pearl | Mocha Metallic | Polished Metal Metallic | Taffeta White",
"frontHeadroom": "39.30 in.",
"manualSunroof": "Std.",
"maximumTowing": "4500 lbs",
"navigationAid": "N/A",
"powerTrunkLid": "N/A",
"rearBrakeType": "Disc",
"runningBoards": "Opt.",
"cargoAreaCover": "Opt.",
"cassettePlayer": "N/A",
"frontBrakeType": "Disc",
"highwayMileage": "22 miles/gallon",
"intervalWipers": "Std.",
"maximumPayload": "1552 lbs",
"powerDoorLocks": "Std.",
"rearSpringType": "Coil",
"rearSuspension": "Ind",
"remoteIgnition": "N/A",
"standardTowing": "4500 lbs",
"airConditioning": "Std.",
"antiBrakeSystem": "4-Wheel ABS",
"deepTintedGlass": "Std.",
"frontCooledSeat": "N/A",
"frontHeatedSeat": "Std.",
"frontSideAirbag": "Std.",
"frontSpringType": "Coil",
"frontSuspension": "Ind",
"genuineWoodTrim": "N/A",
"groundClearance": "8.00 in.",
"optionalSeating": "",
"passengerAirbag": "Std.",
"passengerVolume": "152.70 cu.ft.",
"standardPayload": "1552 lbs",
"standardSeating": "8",
"tractionControl": "Std.",
"turningDiameter": "38.60 in.",
"curbWeightManual": "",
"rearShoulderRoom": "62.20 in.",
"telematicsSystem": "N/A",
"towHitchReceiver": "Std.",
"transmissionLong": "5-Speed Automatic",
"vehicleAntiTheft": "Std.",
"widthAtWheelwell": "",
"cargoAreaTiedowns": "Std.",
"destinationCharge": "$780 USD",
"frontShoulderRoom": "61.50 in.",
"fullSizeSpareTire": "N/A",
"rainSensingWipers": "N/A",
"transmissionShort": "5A",
"viNqueryVehicleId": "40831",
"powertrainDistance": "60,000 mile",
"powertrainDuration": "60 month",
"rearWindowDefogger": "Std.",
"tiltSteeringColumn": "Std.",
"automaticHeadlights": "Std.",
"curbWeightAutomatic": "4544 lbs",
"frontSplitBenchSeat": "N/A",
"heatedSteeringWheel": "N/A",
"lockingDifferential": "N/A",
"pickupTruckBedLiner": "N/A",
"productionSeqNumber": "038147",
"secondRowHeatedSeat": "N/A",
"secondRowSideAirbag": "N/A",
"tirePressureMonitor": "Std.",
"trunkAntiTrapDevice": "N/A",
"adjustableFootPedals": "N/A",
"childSafetyDoorLocks": "Std.",
"daytimeRunningLights": "Std.",
"electronicParkingAid": "Std.",
"frontPowerMemorySeat": "N/A",
"heatedExteriorMirror": "Std.",
"leatherSteeringWheel": "Std.",
"secondRowFoldingSeat": "Std.",
"automaticLoadLeveling": "N/A",
"sideHeadCurtainAirbag": "Std.",
"thirdRowRemovableSeat": "Std.",
"secondRowRemovableSeat": "Std.",
"secondRowSoundControls": "N/A",
"frontPowerLumbarSupport": "Std.",
"limitedSlipDifferential": "N/A",
"loadBearingExteriorRack": "Opt.",
"powerSlidingSideVanDoor": "N/A",
"voiceActivatedTelephone": "N/A",
"pickupTruckCargoBoxLight": "N/A",
"telescopicSteeringColumn": "Std.",
"towingPreparationPackage": "N/A",
"electronicBrakeAssistance": "Std.",
"lockingPickupTruckTailgate": "N/A",
"glassRearWindowOnConvertible": "N/A",
"slidingRearPickupTruckWindow": "N/A",
"steeringWheelMountedControls": "Std.",
"windDeflectorForConvertibles": "N/A",
"powerAdjustableExteriorMirror": "Std.",
"vehicleStabilityControlSystem": "Std.",
"driverMultiAdjustablePowerSeat": "Std.",
"highIntensityDischargeHeadlights": "N/A",
"frontSideAirbagWithHeadProtection": "N/A",
"passengerMultiAdjustablePowerSeat": "Std.",
"secondRowMultiAdjustablePowerSeat": "N/A",
"electrochromicExteriorRearviewMirror": "N/A",
"electrochromicInteriorRearviewMirror": "Std.",
"secondRowSideAirbagWithHeadProtection": "N/A",
"separateDriverFrontPassengerClimateControls": "Std."
}
}
}
}