البحث

ابحث عن مركبة حقيقية حسب رقم VIN

GET/vin/{vin}

فك تشفير VIN مكون من 17 حرفًا إلى بيانات المركبة و الحصول على صور استوديو للمركبة المقابلة في مكالمة واحدة

Add-on — يجب تمكينه لمفتاحك. تحقق من features.vin في /api/me؛ بدونها يعيد نقطة النهاية 403.

ما تحصل عليه في المقابل.

المركبة المشفرة — العلامة التجارية، النموذج، السنة، الطراز، الجسم، المحرك، نظام النقل، نظام الدفع.
كتلة vehicle مع أقرب سيارة من كتالوجنا وURL صورة واحدة معلمة لكل رؤية تسمح بها خطتك.

المطابقة تلقائية: يتم Mapping البيانات المشفرة make/model/year/body على الكتالوج الخاص بنا، واختيار الجيل الذي يغطي سنة السيارة. اقرأ vehicle.confidence لمعرفة مدى قرب المطابقة، و vehicle.matched: false عندما لا يوجد شيء مناسب — في هذه الحالة، يتم إرجاع البيانات المشفرة.

يتم رفض الأرقام VIN غير الصحيحة مع 400 قبل فرض أي رسوم. رقم VIN لا يمكن فك تشفيره يعيد 404.

معاملات المسار

اسم	النوع	الوصف
`vin` مطلوب	string	رقم تعريف المركبة المكون من 17 حرفًا (لا يتم استخدام الحروف I و O و Q أبدًا).

طلب

curl "https://api.vehicleimagery.com/vin/vin" \
  -H "x-api-key: YOUR_API_KEY"

200 · المركبة المشفرة بالإضافة إلى سيارة الكتالوج المقابلة لها وصورها.

{
  "vin": "WBA8E9G50GNT47251",
  "make": "BMW",
  "model": "3 Series",
  "year": 2016,
  "trim": "328i",
  "body": "Sedan",
  "engine": {
    "name": "328i",
    "cylinders": 4,
    "displacement_ccm": 1997,
    "horsepower": 240,
    "fuel": "premium unleaded",
    "configuration": "inline"
  },
  "transmission": "AUTOMATIC",
  "drivetrain": "rear wheel drive",
  "doors": "4",
  "vehicle": {
    "matched": true,
    "confidence": "high",
    "id": 993477403,
    "brand": "BMW",
    "model": "3",
    "year": 2012,
    "variant": "Basis",
    "trim": "base",
    "color": "default",
    "images": {
      "front": "https://cdn.vehicleimagery.com/…",
      "front_left": "https://cdn.vehicleimagery.com/…"
    }
  }
}

400 · الرقم التسلسلي غير رقم تسلسلي صحيح مكون من 17 حرفًا. لا يتم خصم أي مبلغ.

{
  "error": "Invalid VIN — expected 17 characters (letters I, O, Q are not used)."
}

403 · ميزة الرقم التسلسلي الإضافية غير مفعلة لمفتاحك.

{
  "error": "The vin add-on is not enabled for your API key."
}

404 · لا توجد بيانات لهذا الرقم التسلسلي.

{
  "error": "No data found for this VIN.",
  "vin": "WBA8E9G50GNT47251"
}

502 · البحث مؤقتًا غير متاح، حاول مرة أخرى بعد قليل. لا يتم خصم أي مبلغ.

{
  "error": "VIN lookup temporarily unavailable."
}