البحث

ابحث عن سيارة حقيقية من خلال VIN (Beta)

GET/vin/{vin}

> Beta. هذا النهاية نشط ومستخدم، لكنه لا يزال يتطور: قد تتغير حقول الاستجابة، وتحسّن تغطية فك التشفير ومطابقة الكتالوج. مرحباً بالملاحظات. لا تبني أي شيء حاسم على شكل الاستجابة الدقيق بعد.

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

إضافة: يجب تمكينها لمفتاحك. تحقق من features.vin في /api/me؛ وإلا فإن نقطة النهاية تعود 403.

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

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

المطابقة تلقائية: يتم تعيين العلامة التجارية/النموذج/السنة/النوع من خلال فهرسنا، واختيار الجيل الذي يغطي سنة المركبة. اقرأ 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."
}